Robloxstudio

Connect AI assistants like Claude, Codex, Gemini, or any MCP-compatible AI to Roblox Studio

NPM Version

What is This?

An MCP server that lets AI explore your game structure, read/edit scripts, mutate terrain/lighting/animation/sound/particles, profile performance, and route requests across multiple Studio tabs — all locally and safely.

Extended fork with 130+ tools, multi-Studio routing, Blender-parity hang controls, and a Roblox official StudioMCP.exe hook.

Live-game tooling

A playtest forks the DataModel, and the plugin runs in each fork — so a running place is several peers at once: edit, server, and client-1..N. Tools that need the running game name which peer they mean.

• eval_server_runtime / eval_client_runtime — Luau in the live VM, sharing its require cache. execute_luau runs in the plugin VM against a fresh ModuleScript, so require(SomeModule) hands back a new copy and every table the game has mutated is invisible. These see the real thing.
• get_runtime_logs — output per peer, with a since cursor. A value that differs between server and client is the shape of every replication bug, and a merged log cannot show which side printed it.
• capture_script_profiler / capture_micro_profiler — Luau CPU hotspots and engine frame time on a live peer. profile_snapshot says a frame is slow; these say which function.
• get_memory_breakdown / get_scene_analysis — memory by tag and scene cost, compared across peers. Scene modes include unparented_instances (a leak detector) and triangle_composition.
• breakpoints — breakpoints and logpoints, with conditions.
• set_device_simulator / capture_device_matrix — emulate a device, or screenshot up to six of them in one call.
• set_network_profile — simulated latency, jitter and packet loss via NetworkSettings.
• solo_playtest / multiplayer_playtest — run and inspect a test, up to 8 clients.
• import_rbxm / export_rbxm — real .rbxm via SerializationService. Lossless, unlike export_build's compact JSON.
• manage_instance — launch, close, and inspect Studio processes; list a place's published revisions.
• get_roblox_docs / get_roblox_skills — the official engine reference and the installed Studio Assistant skills. Both answer with no Studio open.

Ported from Chrrxs/robloxstudio-mcp (MIT).

Setup

1. Install the Studio plugin into your Plugins folder
2. Enable Allow HTTP Requests in Experience Settings > Security
3. Connect your AI:

Claude Code:

claude mcp add robloxstudio -- npx -y @6xvl/robloxstudio-mcp@latest

Codex CLI:

codex mcp add robloxstudio -- npx -y @6xvl/robloxstudio-mcp@latest

Gemini CLI:

gemini mcp add robloxstudio npx --trust -- -y @6xvl/robloxstudio-mcp@latest

Plugin shows "Connected" when ready.

Seeing failed to connect to roblox studio: -32000 (or [roblox-hook] ... Connection closed)? This is harmless and does not mean the server failed. It's the optional Roblox official StudioMCP.exe hook, which auto-enables when %LOCALAPPDATA%\Roblox\mcp.bat exists and errors out if Roblox Studio isn't running with its built-in MCP enabled. The line is logged (non-fatal) and the server keeps running normally. To silence it, disable the hook:

claude mcp add robloxstudio -e ROBLOX_MCP_HOOK=0 -- npx -y @6xvl/robloxstudio-mcp@latest

Or open Roblox Studio first and the hook connects instead of erroring.

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "@6xvl/robloxstudio-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@6xvl/robloxstudio-mcp@latest"]
    }
  }
}

What Can You Do?

Ask things like:

• "Show me the full game structure"
• "Generate a forest at terrain region (0,0,0) → (200,50,200) with mixed grass and leafy"
• "Set lighting to horror preset and add fog"
• "Play animation 9876543210 on workspace.NPC1"
• "Profile the game for 10 seconds and tell me what's slow"

claude mcp add robloxstudio-inspector -- npx -y @6xvl/robloxstudio-mcp-inspector@latest

codex mcp add robloxstudio-inspector -- npx -y @6xvl/robloxstudio-mcp-inspector@latest

gemini mcp add robloxstudio-inspector npx --trust -- -y @6xvl/robloxstudio-mcp-inspector@latest

{
  "mcpServers": {
    "robloxstudio-mcp-inspector": {
      "command": "npx",
      "args": ["-y", "@6xvl/robloxstudio-mcp-inspector@latest"]
    }
  }
}

Troubleshooting

claude mcp add robloxstudio -e ROBLOX_MCP_HOOK=0 -- npx -y @6xvl/robloxstudio-mcp@latest

claude mcp add robloxstudio -- npx -y @6xvl/robloxstudio-mcp@latest --port 58741

node scripts/check-proxy-mode.mjs

claude mcp add robloxstudio  -- npx -y @6xvl/robloxstudio-mcp@latest --port 58741
claude mcp add robloxstudio2 -- npx -y @6xvl/robloxstudio-mcp@latest --port 58742

Report Issues | MIT Licensed