---

Rainfall

A lightweight Roblox framework. Manages modular gameplay code using Rojo and Git for version control.

Setup

1. Clone the repository
2. Install Rojo and add to PATH
3. Open a local test place (.rbxl) in Roblox Studio
4. Run rojo serve to sync modules into Roblox Studio

Workflow

Editing & Testing

• Make changes in src/
• Test changes in test place
• Commit and push changes with:

  git add .
  git commit -m "Describe change"
  git push

Committing & Pushing

Stage specific modules (recommended for clean commits):

git add src/ServerScriptService/PlayerController.server.luau
git commit -m "Update PlayerController module"
git push

Or stage all changes:

git add .
git commit -m "Describe all changes"
git push

Note: Only code files are tracked. .rbxl files are not in Git.

Finalizing & Publishing

• After testing, copy changes from test .rbxl into production .rbxl
• Open production .rbxl in Studio
• Publish to Roblox cloud (Alt + P and then Update existing game... to select live experience)