DiplomatHearth/roblox-ai-place-diff

Baseplate is an AI-assisted build tool for Roblox Studio, run from the terminal. It reads the place, proposes a turn, and shows every instance and Luau change before anything reaches Studio, so an agent's "done" is not taken on faith. It is aimed at Roblox developers who want the approval and rollback habits of a code editor's AI assistant but applied to live place structure and playtests.

How a turn works

Baseplate reads the instance tree, your current selection, your scripts and an optional BASEPLATE.md rules file. It presents the whole turn as a diff: + new, ~ changed, − removed, down to Luau lines. Nothing lands until you approve. Session modes change the pause: --mode plan never changes anything, while --mode auto or "don't ask again this session" skips repeated confirmation README.

Each approved turn is wrapped in a single ChangeHistoryService recording, so one Ctrl+Z undoes the entire turn in Studio. In a Rojo project, the same turn also becomes one git commit, and /rewind lists turns and returns to any of them in Studio and on disk.

After building, Baseplate runs the game in a separate playtest and reads Output. It fixes what broke and plays again until clean, then reports before/after errors, what it checked, and a screenshot saved under .baseplate/turns/. The stated behavior is that it reports a failure rather than claiming a successful turn README.

Why the playtest copy matters

Playtests open a local copy of the place in a second Studio window. The README states this copy cannot reach live DataStores, so a test run cannot hand out real currency or overwrite a real save. That is a documented isolation boundary, not a guarantee about every script in every project.

Requirements and boundaries

• Windows 10/11 portable release; the Studio plugin ships as Baseplate.rbxm and is installed via baseplate plugin install releases.
• The model defaults to a free local model through Ollama; a Claude, GPT or Gemini key is optional Ollama.
• The plugin is not on the Creator Store because its playtest checks use loadstring, which the store disallows.
• Building from source needs Rust 1.85+ and Rojo 7.7 for the plugin build instructions.
• The README acknowledges that it can make a bad change like any developer; the intended safeguards are the diff, single-step undo and isolated playtests. Publishing is never automatic: /publish asks, and BASEPLATE.md can disable it.
• No telemetry, account or hardware ID are documented; the plugin communicates with the terminal over localhost only.

The project is MIT licensed license. It is independent of Roblox and uses Studio's public MCP server and plugin APIs; the terminal needs a Windows machine, while the optional MCP/plugin path is what connects it to Studio.