Roblox game synced with azul — agents commit .luau under sync/, Studio syncs via the azul companion plugin
| .gitignore | ||
| README.md | ||
roblox-game
Roblox game developed via a git → azul → Roblox Studio sync bridge (azul). Studio is the source of truth; the sync/ folder mirrors Studio's DataModel 1:1.
The flow
- Agents work all day: edit/commit
.luaufiles undersync/in this repo (every change = a commit, that's the audit trail). - You (at home, on the mesh):
git pull. - Sync into Studio:
- run
azulin this folder (daemon serves WebSocket on port 8080), - open the place in Roblox Studio, click Connect in the Azul Companion Plugin — everything committed under
sync/syncs into Studio.
- run
Handy commands
azul build— force-push local files into Studio (recover from Studio drift).azul push <path>— selectively push files into Studio.azul pack— snapshot Studio-only state (models, maps, properties) back tosync/so nothing is lost. Commit what it produces.
One-time setup (your PC)
- Install Node.js ≥ 20.19 from nodejs.org.
npm install azul-sync -g- Install the Azul Companion Plugin into Roblox Studio.
- Optional but recommended: VS Code + Luau-LSP — azul auto-generates
sourcemap.json(git-ignored) so IntelliSense works out of the box.
Layout
sync/— DataModel mirror: agents commit.luauhere; Studio syncs from it.
sourcemap.json and azul local state (.azul/) are git-ignored.