🧱 rbx-studio-plus

The Roblox Studio MCP server that coding agents actually enjoy using.

Edit your Roblox scripts as local files, run Luau with real output, playtest in one call. Works with Claude Code, Codex, Cursor, opencode, or any MCP client.

Why

Roblox Studio ships a built-in MCP server. It is powerful, but it was not designed with coding agents in mind:

• every call needs a studio_id and a datamodel_type;

• print() output is lost;

• results over 100 KB are silently truncated;

• syntax errors only say "Failed to parse command code";

• scripts can only be edited through tool calls, never as files.

rbx-studio-plus sits between your agent and Studio and fixes all of that. It also adds the workflow agents are good at: edit files → push → playtest → read errors → fix.

flowchart LR
    A["🤖 Agent<br/>Claude Code · Codex · Cursor"] -- MCP stdio --> P["🧱 rbx-studio-plus"]
    P -- MCP stdio --> S["🎮 Roblox Studio<br/>built-in MCP"]
    P <-- "two-way sync" --> F["📁 roblox-src/<br/>*.server.luau · *.client.luau · *.luau"]
    A -- "Read / Edit / grep / git" --> F

Related MCP server: Roblox Studio MCP

✨ Highlights

Every other Studio tool (generate_mesh, insert_asset, screen_capture, input simulation, subagent…) is still available under the same name, without studio_id.

🚀 Quick start

1. Enable Studio's MCP server. In Roblox Studio, go to Assistant → … → Manage MCP Servers and turn on Enable Studio as MCP server.

2. Install.

git clone https://github.com/noan-hbt/rbx-studio-plus.git
cd rbx-studio-plus
npm install && npm run build
node dist/src/index.js install      # registers "roblox-plus" in Claude Code + Codex

3. Restart your agent, then ask it something like "pull the scripts and playtest the game".

{
  "mcpServers": {
    "roblox-plus": {
      "command": "node",
      "args": ["/absolute/path/to/rbx-studio-plus/dist/src/index.js"]
    }
  }
}

Use install --claude or install --codex to register in only one of them.

🧰 Tools

Paths accept Workspace.Model.Part, game.Workspace… or Workspace/Model/Part. Duplicate sibling names are addressed as Name~2.

📁 Script sync

roblox-src/
├── ServerScriptService/
│   └── Main/
│       ├── init.server.luau      ← Script "Main" (it has children)
│       └── Helper.luau           ← ModuleScript
├── StarterPlayer/StarterPlayerScripts/
│   └── Client.client.luau        ← LocalScript
└── .rbxsync.json                 ← sync state (do not edit)

• sync_pull exports every script, by default to ./roblox-src (or RBX_SYNC_DIR). Re-running it only rewrites what changed.

• Edit the files with any tool, then sync_push. New files become new scripts: the class comes from the suffix and missing Folders are created. Deleted files are removed in Studio only with delete_missing: true.

• No silent overwrites. If a script changed both locally and in Studio, the push is refused. A pull writes <file>.studio next to your file: merge it, delete it, then push with force: true.

• sync_watch on=true turns on live sync: saved files are pushed instantly and Studio edits are pulled every 3 s.

• Each folder is bound to one place. Pulling a different place into it requires force.

💡 Example

> luau_run  code: "for _, p in workspace.Map:GetChildren() do print(p.Name) end return #workspace:GetDescendants()"

✔ ok · 3 ms · Edit
--- output ---
Spawn
Bunker
Trees
--- result ---
4182

> playtest  duration_s: 6

✘ FAIL · ran 8s · 1 error(s), 0 warning(s)
--- console ---
[GameManager] Started
[E] OnClientEvent is not a valid member of RemoteEvent "ReplicatedStorage.Remotes.RoundUpdate"

⌨️ CLI

The same engine also works without an agent:

rbx-studio-plus status
rbx-studio-plus sync pull|push|status|watch [--dir D] [--studio S] [--force] [--dry-run] [--delete-missing]
rbx-studio-plus run script.luau [--context server]

🔧 How it works

• Studio connection. rbx-studio-plus is an MCP client of Studio's bridge (%LOCALAPPDATA%\Roblox\mcp.bat, or StudioMCP on macOS). It reconnects automatically and applies timeouts.

• Luau execution. Your code is wrapped in a one-line prelude, so line numbers stay correct. The prelude shadows print/warn, catches errors with a traceback, and serializes results safely.

• Large results. Results bigger than the bridge's limit are paged through _G. Large inputs are uploaded in chunks.

• Change detection. Uses the same FNV-1a hash in Luau and in Node, so changes are detected without transferring source.

• Undo. Every edit runs inside Studio's change history. Deletions use Parent = nil so they can be undone.

🧪 Development

npm test                                      # unit tests
node scripts/live-e2e.mjs <tmp-dir> --playtest # end-to-end against an open Studio

The end-to-end test writes only under ServerStorage.__rbxplus_test and deletes it at the end.

📄 License

MIT. Not affiliated with Roblox Corporation.