Plugin

sbox-claude

Name: sbox-claude
Author: lousputthole

Develop s&box games by conversing with Claude, leveraging a native MCP bridge that provides scene editing, prefab management, screenshot-driven iteration, and playtesting capabilities.

game-dev

What's Inside

Agents1

sbox-game-dev

/sbox-game-dev

Specialist for building features inside an s&box game project via the Claude Bridge. Use when handing off a self-contained game-dev task — a new gameplay system, animation, UI panel, ability, world-gen pass — that benefits from focused execution with the screenshot-driven workflow. Pair with the sbox-claude:sbox-build-feature skill, which this agent invokes for every visual change.

Skills5

sbox-setup

/sbox-setup

First-run onboarding for the s&box Claude Bridge. Run when a user first connects the bridge or asks how to get started — it verifies the connection, detects their installed libraries, recommends what to build with, and points them to help + feedback. Keep it warm and brief.

sbox-api

/sbox-api

Use when writing or modifying code for s&box, sbox, the Facepunch sandbox engine, or any Source 2 game project in C#. Triggers on mentions of s&box, sbox, sandbox game, Facepunch engine, Source 2 game, `.sbproj`, `.razor` with `PanelComponent`, `@inherits PanelComponent`, `Sandbox.Component`, `GameObject` + `Components.Get<T>`, `Scene.Trace`, `CharacterController` + `.Move()`, `SkinnedModelRenderer`, `NavMeshAgent`, `[Sync]`, `[Rpc.Broadcast]`, `[Property]`, `INetworkListener`, `ISceneEvent`, `PlayerController` in C#. Also triggers on any file with `using Sandbox;` or `using Sandbox.UI;` that isn't Unity/Godot/Unreal. Writes idiomatic s&box C# components, Razor UI, and networking code; prevents Unity-pattern leakage.

sbox-build-feature

/sbox-build-feature

Use when building, modifying, or polishing any feature in an s&box game project through the Claude Bridge — gameplay systems, UI panels, character abilities, animation, world generation, anything that produces a visible or runtime change. Codifies the screenshot-driven iteration workflow that prevents the "guess-and-check" loop the bridge is most susceptible to.

sbox-cookbook

/sbox-cookbook

Use when building a whole s&box game or a specific game SYSTEM and you want a proven, code-grounded recipe instead of guessing. Genre playbooks (tycoon/idle, shopkeeper/management, deathmatch/arena, platformer/obstacle course, survival/horror, card-battler, gacha/dungeon-crawler, social-hub, document/inspection sim, puzzle, sandbox/voxel, vehicles, roleplay) and per-system how-tos (inventory, economy/currency, shop/vendor/trading, save/persistence, progression/upgrades/prestige, gacha/loot tables, leaderboards/services, idle/offline earnings, building/placement, crafting, dialogue, round/match flow, spawning/waves, anti-cheat) plus engine references (networking & authority, architecture, player controller, Razor UI, weapons/combat, input, physics/traces, component lifecycle, worldgen/rendering, performance/threading, data assets). Triggers on "how do I build a <genre> game", "inventory system", "save system", "economy / currency", "shop", "upgrade / prestige tree", "leaderboard", "round system", "spawn waves", "gacha / loot box", "building placement", "host-authoritative", and similar. This is a ROUTER — find the system/genre, open the reference; do not answer from SKILL.md alone.

sbox-scaffold-game

/sbox-scaffold-game

Use when the user asks for a whole playable game in one go through the s&box Claude Bridge — "make me a first-person game", "scaffold a game", "give me something I can press Play on". Orchestrates the existing bridge tools plus gameplay scaffolds into a first-person starter you can enter, move through, and win or lose. Handles generate/edit/hotload/place sequencing and visual plus automated runtime verification.

MCP Servers2

sbox

sbox-lifeline

Stats

Version2.2.0

ReleasedJul 2, 2026

LanguageC#

Stars16

Forks6

MaintenanceExcellent

LicenseLicenseRef-Sbox-Bridge-Source-Available-1.0

Last CommitJul 24, 2026

AddedMay 16, 2026

Actions

View on GitHub View README Plugin Marketplace JSON Homepage

Available In

sbox-claude16

Safety Signals

Caution

Uses power tools

Uses Bash, Write, or Edit tools

🚀 New in v2.0.0 — the "Native" relaunch

The bridge now runs on s&box's own editor MCP server. Start here: docs/RELAUNCH.md (what changed and why) · docs/AGENT-GUIDE.md (how an agent works the platform) · docs/ECOSYSTEM.md (plain-English tour of all 28 toolsets) · docs/FAQ.md (do my old workflows still work, can an agent modify my project, what's next).

What's new in v2.2.0

Rotation and vector arguments just work now. The native MCP gate stringifies structured arguments; every rotation/vector parse path now unwraps stringified JSON and accepts comma strings ("12,45,7"), arrays, and objects. No more workarounds through set_game_object.

The multiplayer test harness is live. start_multiplayer_test boots real sbox.exe -joinlocal clients into a private hidden lobby; multiplayer_test_status tracks connections and client processes truthfully (dead clients report dead); stop_multiplayer_test cleans up. Capacity checks, overlapping-run prevention, false-positive join guards, failed-start rollback.

First-party Codex distribution. The s&box Codex Bridge ships from this repo: same 286 tools, native editor MCP, lifeline diagnostics, API brain, cookbook, and workflow skills — packaged for OpenAI Codex and generated from the Claude plugin by scripts/gen-codex-plugin.mjs to enforce parity.

Prefab [Property] values are documented as authoritative over code defaults — tuning flows through prefab edits (see the sbox-build-feature gotchas reference).

What's new in v2.0.0

v2 moves the bridge off the file-IPC transport and onto s&box's built-in editor MCP server (shipped in the editor since July 2026, on by default). The headline wins:

Inline PNG screenshots — take_screenshot, capture_view, screenshot_from, and screenshot_orbit return the image inside the tool result. Claude sees it directly; there is no file path to read back.

Permission-free reads — read-only tools carry the [McpTool.ReadOnly] hint, so clients can run them without permission prompts.

Live tool discovery — agents find tools with search_tools and browse the 28 described toolsets with list_toolsets / describe_toolset, instead of scrolling a 200-tool flat list.

Real error semantics — failures are actual tool errors (thrown, readable), not { error } payloads buried inside successful responses.

New wave-1 tools — find_broken_references (scene health scan), batch_set_property with dryRun: true validation (bulk edits across many objects), and describe_project (one-call project orientation).

No Node.js on the main path — the editor hosts the server; Node is only needed for the optional lifeline.

Upgrading from v1.x? docs/V2-MIGRATION.md is the migration guide — tool names are unchanged, and the six removals are 1:1 built-in replacements.

How it works

s&box Claude Bridge

Build s&box games by talking to Claude Code. Describe what you want — Claude writes the C#, builds the scenes, wires up components, and iterates until it works.

📖 Full docs: sboxskins.gg/claudebridge — setup · changelog · troubleshooting · FAQ

You:    "Make a horror game where I explore an abandoned hospital with a flashlight."
Claude: *creates scripts, builds the scene, sets the lighting and fog, adds a player
         controller, takes a screenshot — sees the PNG right in the tool result —
         fixes the angle, and shows you.*

🚀 New in v2.0.0 — the "Native" relaunch

The bridge now runs on s&box's own editor MCP server. Start here: docs/RELAUNCH.md (what changed and why) · docs/AGENT-GUIDE.md (how an agent works the platform) · docs/ECOSYSTEM.md (plain-English tour of all 28 toolsets) · docs/FAQ.md (do my old workflows still work, can an agent modify my project, what's next).

What's new in v2.2.0

Rotation and vector arguments just work now. The native MCP gate stringifies structured arguments; every rotation/vector parse path now unwraps stringified JSON and accepts comma strings ("12,45,7"), arrays, and objects. No more workarounds through set_game_object.
The multiplayer test harness is live. start_multiplayer_test boots real sbox.exe -joinlocal clients into a private hidden lobby; multiplayer_test_status tracks connections and client processes truthfully (dead clients report dead); stop_multiplayer_test cleans up. Capacity checks, overlapping-run prevention, false-positive join guards, failed-start rollback.
First-party Codex distribution. The s&box Codex Bridge ships from this repo: same 286 tools, native editor MCP, lifeline diagnostics, API brain, cookbook, and workflow skills — packaged for OpenAI Codex and generated from the Claude plugin by scripts/gen-codex-plugin.mjs to enforce parity.
Prefab [Property] values are documented as authoritative over code defaults — tuning flows through prefab edits (see the sbox-build-feature gotchas reference).

What's new in v2.0.0

v2 moves the bridge off the file-IPC transport and onto s&box's built-in editor MCP server (shipped in the editor since July 2026, on by default). The headline wins:

Inline PNG screenshots — take_screenshot, capture_view, screenshot_from, and screenshot_orbit return the image inside the tool result. Claude sees it directly; there is no file path to read back.
Permission-free reads — read-only tools carry the [McpTool.ReadOnly] hint, so clients can run them without permission prompts.
Live tool discovery — agents find tools with search_tools and browse the 28 described toolsets with list_toolsets / describe_toolset, instead of scrolling a 200-tool flat list.
Real error semantics — failures are actual tool errors (thrown, readable), not { error } payloads buried inside successful responses.
New wave-1 tools — find_broken_references (scene health scan), batch_set_property with dryRun: true validation (bulk edits across many objects), and describe_project (one-call project orientation).
No Node.js on the main path — the editor hosts the server; Node is only needed for the optional lifeline.

Upgrading from v1.x? docs/V2-MIGRATION.md is the migration guide — tool names are unchanged, and the six removals are 1:1 built-in replacements.

sbox-claude

What's Inside

sbox-claude

Popularity

What's Inside

Confidence

README