@el4cteo/rbx-studio-mcp 0.4.5 → 0.4.6

package/README.md

@@ -1,6 +1,6 @@
 # Roblox Studio MCP
 
-Let an AI agent drive Roblox Studio: read your place, edit scripts, run playtests, take screenshots. 30 tools. MIT.
+Let an AI agent drive Roblox Studio: read your place, edit scripts, build and generate geometry, run playtests, take screenshots. 30 tools. MIT.
 
 ![The Studio MCP panel: a live activity band, a call log with latencies, and the theme drawer open](docs/rbx-studio.png)
 
@@ -133,6 +133,12 @@ codex mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp
 
 Port defaults to **44755** — change with `--port` or `ROBLOX_STUDIO_MCP_PORT`, and match it in the plugin widget. Loopback only.
 
+If anything looks wrong, run the health check. It reports Node, the plugin install, the bridge, and every connected Studio, and ends each line with the fix:
+
+```bash
+npx -y @el4cteo/rbx-studio-mcp doctor
+```
+
 ## Multiple agents
 
 Register the server in as many clients as you like. No extra configuration.
@@ -151,11 +157,15 @@ Each agent keeps its own target, so two agents can work on two open places. Suba
 | **Run & debug** | `playtest` `execute_luau` `character` `input` `console` `debug` `performance` |
 | **Look** | `screenshot` `viewport` `device` |
 
-Gotchas: during a playtest two sessions connect — pass `studioId` explicitly and use the edit session for anything that must persist. `device` emulation persists until `device op="stop"`.
+`geometry` holds every mesh operation: `union`, `subtract`, `intersect`, `fragment`, `segment` (cut a mesh into parts you name) and `sweep` (the volume a part moves through, and what it would hit).
+
+`generate` builds 3D models from a prompt using Roblox's Cube model — `Body1` for props, `Car5` for a body and four named wheels a script can drive, or your own part names.
+
+Gotchas: during a playtest two sessions connect — pass `studioId` explicitly and use the edit session for anything that must persist. `device` emulation persists until `device op="stop"`. Generated meshes are edit-mode only; their content reads as empty inside a playtest.
 
 ## The console panel
 
-Every call is logged with its latency, above a trace of the last forty.
+Every call is logged with its latency, above a trace of the last forty. The badge names which agents are connected, with process id and uptime.
 
 Hover the tab on the right edge for eight themes — Lattice, Observatory, Orbit, Void, Nebula, Aurora, Phosphor, Blueprint. Each redraws the activity band, not just its colours. Your pick is remembered.
 
@@ -182,11 +192,12 @@ Each batch is one **Ctrl+Z**, and all-or-nothing: a failed match leaves the plac
 
 - **Push, not poll.** 50 sequential round trips average 13.6 ms, against 25.8 ms polling — reproduce with `node scripts/latency.mjs --count 50 --compare`.
 - **Safe script edits.** Writes go through `ScriptEditorService:UpdateSourceAsync`, so your unsaved editor buffer survives.
+- **Edits can refuse to be stale.** `script_read` prints a `rev`; pass it back and the write is rejected if anyone changed the script meanwhile, instead of landing on lines that moved.
 - **One Ctrl+Z per call.** Every batch is a single undo recording.
 - **Property names are checked** against the running engine's API dump, so a typo comes back as `Anchorred` → `Anchored` instead of a runtime error.
 - **~16k tokens of schema**, cursor-paged and capped, with `detail: concise | standard | full`.
 
-Not built here: terrain, AI mesh and material generation.
+Not built here: terrain, material generation.
 
 ## Security
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@el4cteo/rbx-studio-mcp",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "MCP server for Roblox Studio. 29 tools, push-based SSE bridge, editor-safe script edits, one-step undo.",
   "type": "module",
   "license": "MIT",

package/plugin/src/Config.luau

@@ -9,7 +9,7 @@
 
 local Config = {}
 
-Config.PLUGIN_VERSION = "0.4.5"
+Config.PLUGIN_VERSION = "0.4.6"
 
 -- Fingerprint of plugin/src, stamped in by scripts/build-plugin.mjs. The server
 -- computes the same hash from its own copy of the sources and compares, so a