Claude bridge
Released
Build s&box games by talking to Claude
Feedback & Bugs: [email protected] or Github
NEW CUSTOM PLUGIN FOR CLAUDE
1. /plugin marketplace add LouSputthole/Sbox-Claude — registers repo as a plugin source.
2. /plugin install sbox-claude — installs the plugin from that source.
3. Restart Claude Code (or /reload-plugins).
____
I’ve seen the thumbs-down reviews on the Claude Bridge release, and I wanted to address them directly.
I’m not sure yet whether the negative reviews are coming from people who simply do not want AI-assisted tools in s&box, or whether the bridge was broken, confusing, or unreliable for some users. Either way, I want the feedback.
I built this tool for people who have game ideas but do not necessarily know how to code. The goal is not to replace creativity. The goal is to give more people a way to build their dream game by letting Claude act like a coding assistant inside the editor. You describe what you want, and Claude helps write scripts, create objects, wire components, and build systems that would otherwise be out of reach for non-programmers.
That said, if the tool did not work for you, that matters. A bad install, broken tool call, timeout, confusing setup step, or missing documentation is on me to improve.
The newest release should fix many of the issues people were running into, especially around install paths, tool stability, play mode safety, and timeout confusion. A lot of those fixes came directly from user feedback, so thank you to everyone who took the time to report problems instead of just silently launching the tomato cannon.
If you had a bad experience, please reach out: [email protected]
Tell me what happened, what broke, what confused you, or what you think the bridge should do better. I’ll move quickly on real issues and keep improving the tool.
Thanks to everyone giving it a shot, testing it, breaking it, reporting bugs, and helping make it better.
____
____
How it works?
This MCP bridge connects Claude Code to the s&box editor and gives Claude 100 tools for working inside your project, including creating GameObjects, writing scripts, wiring components, configuring physics, networking, UI, audio, prefabs, and more.
You describe what you want. Claude does the work.
Example: You: “Make a player controller with WASD, mouse look, double-jump, and a flashlight.”
Claude writes the script, adds the component, wires the input, and sets up the spotlight.
What it’s great at: Coding game systems through conversation.
Player controllers, NPC behavior, networking and multiplayer, UI panels, sound events, prefab wiring, runtime game logic, custom components, and more. Claude produces clean, working s&box C# and can iterate from your feedback.
What it’s serviceable at : Map building.
Terrain sculpting, forest generation, cave layout, and trail placement work, but Claude cannot directly see the result. It can read coordinates and create a strong rough pass, but final visual polish still needs your eyes.
What’s new in v1.2.0
Major stability release driven by community reports:
- Installs reliably the first time — the installer now targets the correct folder:
<Project>/Libraries/claudebridge/ - No more
tool.frameconsole spam — frame handler wrapped and errors deduplicated - Save corruption prevented — bridge refuses scene edits while in play mode
- Fault-tolerant — one broken tool no longer takes the rest offline
- New
TROUBLESHOOTING.mdcovering the 10 most common failure modes
100 Tools Included
Scene Building | Create, duplicate, transform, parent GameObjects. Full hierarchy access and editor selection.
Scripts & Templates | Generate player controllers, NPC AI, game managers, trigger zones, networked players, lobby managers.
Components | Add any of s&box's 130+ components, read/write properties, assign models, materials, and prefab references.
Physics | Rigidbodies, colliders (box, sphere, capsule, hull), joints (fixed, spring, hinge, slider), raycasts.
UI | Razor UI components, screen panels, world panels.
Audio | Sound events, assign sounds to objects, preview audio in editor.
Networking | Network spawn, sync properties, RPC methods, network helpers, lobby configuration.
Assets | Search the asset library, install packages, browse and manage prefabs.
Editor | Undo/redo, take screenshots, play/stop mode, save scenes, hotload C# scripts.
Publishing | Validate projects, configure settings, set thumbnails, fetch package details.
Scripts & Templates | Generate player controllers, NPC AI, game managers, trigger zones, networked players, lobby managers.
Components | Add any of s&box's 130+ components, read/write properties, assign models, materials, and prefab references.
Physics | Rigidbodies, colliders (box, sphere, capsule, hull), joints (fixed, spring, hinge, slider), raycasts.
UI | Razor UI components, screen panels, world panels.
Audio | Sound events, assign sounds to objects, preview audio in editor.
Networking | Network spawn, sync properties, RPC methods, network helpers, lobby configuration.
Assets | Search the asset library, install packages, browse and manage prefabs.
Editor | Undo/redo, take screenshots, play/stop mode, save scenes, hotload C# scripts.
Publishing | Validate projects, configure settings, set thumbnails, fetch package details.
Install
The bridge has two pieces:
- The addon, which runs in s&box
- The MCP server, a Node.js process that connects Claude Code to the addon over file IPC
1. Install the addon
Click Install on the Asset Library page. s&box will place the addon into your project’s
Libraries/claudebridge/ folder automatically.2. Install Node.js
The MCP server requires Node.js 18 or newer:
3. Install Claude Code
If you do not already have Claude Code installed:
4. Connect Claude Code to the bridge
Open a terminal and run:
claude mcp add sbox -- npx sbox-mcp-server
This pulls the MCP server from npm and registers it with Claude Code. Future Claude sessions will auto-start it.
5. Open the bridge dock
In s&box, open: View → Claude Bridge
The dock must stay visible while you are working. The bridge’s frame handler only processes requests while the dock is on-screen. If you close it, Claude tool calls will time out after 30 seconds. You can dock it somewhere out of the way.
6. Verify the connection
Open Claude Code in any working directory and ask:
Check the bridge status.
You should get back:
connected: true, handlerCount: 100
Then try:
What scene is loaded in s&box?Create a cube at 0,0,100 and give it a box model.Write a player controller with WASD and mouse look.
Troubleshooting
If anything misbehaves, see
TROUBLESHOOTING.md in the repo:https://github.com/LouSputthole/Sbox-Claude/blob/main/TROUBLESHOOTING.md
The most common issue is the dock being closed. If every tool call times out at 30 seconds, open View → Claude Bridge and try again.
Updating
Addon: Reinstall from the Asset Library when a new version drops.
MCP server:
npx sbox-mcp-server@latest will pull the newest version on the next Claude session.Compatibility
- s&box current SDK
- Node.js 18+
- Claude Code with MCP support
- Windows, Linux, and Mac
Tips
- Save your project before letting Claude run a batch of changes. Hit Ctrl+S, then turn Claude loose.
- Do not try to mutate the scene during play mode. The bridge will refuse with a clear error message.
- Use Git for your project. Keeping
.scenefiles under version control is the right move for any non-trivial s&box game.
License GPL-3.0.
Free to use in your games, free or commercial. Free to modify. If you redistribute a modified copy of the bridge itself, keep it open source and credit sboxskins.gg.
Links
- GitHub: https://github.com/LouSputthole/Sbox-Claude
- Issues / bug reports: https://github.com/LouSputthole/Sbox-Claude/issues
- npm package: https://www.npmjs.com/package/sbox-mcp-server
-----------------------------
New in v1.1.0
- World Editing — Drive any component with a
[Button]. Add hills, clearings, and trails to terrain. Edit cave tunnel paths. Add forest POIs and trail gaps. Re-roll procedural seeds. Works on any project that follows theList<Feature>+[Button]pattern. - Terrain Sculpting — Direct heightmap brush with raise / lower / flatten / smooth modes. Modify the terrain mesh in place, no rebuild needed.
- Forest Painting — Paint biome regions with density multipliers (clearings, dense thickets, gradients). Drop assets along curved paths with spacing, jitter, and scale variation.
- Code Discovery — Claude can now look up real s&box APIs instead of guessing. Inspect any type's properties / methods / events / attributes via
Game.TypeLibraryreflection. Search types by name. Get formal method signatures with all overloads. Grep your project for usage examples. - Standalone Terrain Builder — Build a heightmap mesh from a JSON spec without needing a
MapBuildercomponent in the scene.
How It Works
The bridge uses file-based IPC — no network connection needed. The MCP server writes request files to a temp directory, the bridge addon polls for them inside the s&box editor, processes commands on the main editor thread, and writes response files back. All communication stays on your local machine.
For the world-editing tools: the bridge finds your component via
Game.TypeLibrary reflection, mutates its [Property] List<> fields directly, then re-presses the [Button] to rebuild. No per-project bridge changes required — define your components with editable feature lists and a rebuild button, and Claude can drive them.Requirements
- s&box (Steam)
- Node.js 18+
- Claude Code CLI (from Anthropic)
Links
- GitHub: https://github.com/LouSputthole/Sbox-Claude
- Website: https://sboxskins.gg
- Feedback & Bugs: [email protected]
Built by sboxskins.gg