sbox-mcp-server 1.20.0 → 2.0.0

package/dist/tools/workflow.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+/**
+ * Workflow tools (Batch 53): scene checkpoints (the agent-side undo safety net),
+ * describe_scene orientation, and the team-assigner / idle-income scaffolds.
+ */
+export function registerWorkflowTools(server, bridge) {
+    // ── checkpoint_scene ─────────────────────────────────────────────
+    server.tool("checkpoint_scene", "Snapshot the ENTIRE open scene (every root GameObject, full serialization) to temp storage OUTSIDE the project. The agent-side undo: checkpoint before risky batch edits or experimental changes, roll back with restore_checkpoint if they go wrong. Returns { checkpointed, id, label, scene, rootObjects, sizeBytes } — keep the id. Refused during play mode (runtime state would poison the snapshot). Snapshots survive editor restarts (temp dir, subject to OS cleanup); browse them with list_checkpoints", {
+        label: z
+            .string()
+            .optional()
+            .describe("Short label baked into the checkpoint id (e.g. 'before-batch-tint'). Defaults to 'checkpoint'"),
+    }, async (params) => {
+        const res = await bridge.send("checkpoint_scene", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── restore_checkpoint ───────────────────────────────────────────
+    server.tool("restore_checkpoint", "REPLACE the open scene's entire contents with a checkpoint_scene snapshot: destroys every current root object, then rebuilds the snapshot's tree (guids preserved, so internal references stay wired). DESTRUCTIVE — requires an explicit id (from checkpoint_scene or list_checkpoints), never guesses. Returns { restored, id, destroyedRoots, restoredRoots }. The scene FILE on disk is untouched until save_scene. Scene-mutating: refused during play mode", {
+        id: z
+            .string()
+            .describe("Checkpoint id to restore (e.g. 'cp_20260709_153000_before-batch-tint')"),
+    }, async (params) => {
+        const res = await bridge.send("restore_checkpoint", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── list_checkpoints ─────────────────────────────────────────────
+    server.tool("list_checkpoints", "List this project's scene checkpoints (newest first). Returns { total, checkpoints } — each { id, createdUtc, sizeBytes }. Pass an id to restore_checkpoint to roll the scene back, or create one first with checkpoint_scene. Read-only; no limit (checkpoints are few)", {}, async (params) => {
+        const res = await bridge.send("list_checkpoints", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── describe_scene ───────────────────────────────────────────────
+    server.tool("describe_scene", "One-call orientation for the OPEN scene (works in edit and play mode): total/root object counts, component histogram (top 20 types), every camera with position, light count, tag histogram (top 12), and the aggregate world bounds of renderable content. Returns a structured summary — orient here, then find_objects by component/tag, get_scene_hierarchy for structure, find_broken_references for health, screenshot_orbit to look at something. Complements describe_project (project-level). Read-only", {}, async (params) => {
+        const res = await bridge.send("describe_scene", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_team_assigner ─────────────────────────────────────────
+    server.tool("create_team_assigner", "Generate a host-authoritative balanced team assigner component (smallest-bucket draft): AssignSmallest(steamId) drops a joining player into the emptiest team, announces via [Rpc.Broadcast] so every client's roster agrees, and fires static OnTeamAssigned(steamId, index, name); plus Rebalance(), GetTeam, GetMembers. Writes a .cs file and returns { created, path, className, teams, nextSteps } — follow with trigger_hotload + compile_status, attach to your game manager, call AssignSmallest from your join hook (e.g. INetworkListener.OnActive)", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'TeamAssigner' -> Code/TeamAssigner.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+        teams: z
+            .array(z.string())
+            .optional()
+            .describe('Team names in index order. Default ["Red", "Blue"]'),
+    }, async (params) => {
+        const res = await bridge.send("create_team_assigner", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_idle_income ───────────────────────────────────────────
+    server.tool("create_idle_income", "Generate a host-authoritative passive income component: every tickSeconds the host grants incomePerTick × Multiplier, auto-wiring the first sibling component with an AddMoney(int) method (a create_economy_wallet scaffold plugs in with zero code) or an overridable Grant() seam; TotalEarned is [Sync(FromHost)] and static OnIncomeTick fires per grant. The idle-game kit: wallet (create_economy_wallet) + this + create_offline_progress. Writes a .cs file and returns { created, path, className, nextSteps } — follow with trigger_hotload + compile_status", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'IdleIncome' -> Code/IdleIncome.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+        incomePerTick: z
+            .number()
+            .optional()
+            .describe("Amount granted per tick. Default 1"),
+        tickSeconds: z
+            .number()
+            .optional()
+            .describe("Seconds between grants. Default 1"),
+    }, async (params) => {
+        const res = await bridge.send("create_idle_income", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/tools/world.js

@@ -64,13 +64,13 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── add_terrain_hill ─────────────────────────────────────────────
-    server.tool("add_terrain_hill", "Add a hill (cosine-falloff bump) to MapBuilder. Negative height creates a depression.", {
+    server.tool("add_terrain_hill", "Add a hill (cosine-falloff bump) to MapBuilder's Hills list. Negative height creates a depression. Returns `added`, `total` (hills now in the list), and `rebuilt`; verify the surface with raycast_terrain at the hill center.", {
         x: z.number().describe("World X of hill center"),
         y: z.number().describe("World Y of hill center"),
         radius: z.number().default(500).describe("Hill radius in world units"),
         height: z.number().default(100).describe("Peak height (negative for depression)"),
         rebuild: z.boolean().default(true).describe("Rebuild terrain after adding (set false to batch)"),
-        id: z.string().optional(),
+        id: z.string().optional().describe("GUID of the GameObject holding the MapBuilder; omit to auto-find the first MapBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -82,12 +82,12 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── add_terrain_clearing ─────────────────────────────────────────
-    server.tool("add_terrain_clearing", "Add a flat clearing zone to MapBuilder (lerps height toward base inside radius).", {
-        x: z.number(),
-        y: z.number(),
-        radius: z.number().default(300),
-        rebuild: z.boolean().default(true),
-        id: z.string().optional(),
+    server.tool("add_terrain_clearing", "Add a flat clearing zone to MapBuilder's Clearings list (lerps height toward base inside radius). Returns `added`, `total` (clearing count), and `rebuilt`. Rebuilds terrain immediately by default; set rebuild=false to batch edits, then rebuild once (rebuild=true on the last call, or invoke_button 'Build Terrain').", {
+        x: z.number().describe("World X of clearing center"),
+        y: z.number().describe("World Y of clearing center"),
+        radius: z.number().default(300).describe("Clearing radius in world units. Default 300."),
+        rebuild: z.boolean().default(true).describe("Rebuild terrain after adding (default true; set false to batch)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the MapBuilder; omit to auto-find the first MapBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -99,11 +99,11 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── add_terrain_trail ────────────────────────────────────────────
-    server.tool("add_terrain_trail", "Carve a trail depression between two points on MapBuilder.", {
-        from: z.object({ x: z.number(), y: z.number() }),
-        to: z.object({ x: z.number(), y: z.number() }),
-        rebuild: z.boolean().default(true),
-        id: z.string().optional(),
+    server.tool("add_terrain_trail", "Carve a trail depression between two points on MapBuilder (appends to its Trails list). Returns `added`, `total` (trail count), and `rebuilt`. Rebuilds terrain immediately by default; set rebuild=false to batch, then invoke_button 'Build Terrain' once.", {
+        from: z.object({ x: z.number(), y: z.number() }).describe("Trail start point (world x/y)"),
+        to: z.object({ x: z.number(), y: z.number() }).describe("Trail end point (world x/y)"),
+        rebuild: z.boolean().default(true).describe("Rebuild terrain after adding (default true; set false to batch)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the MapBuilder; omit to auto-find the first MapBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -115,12 +115,13 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── clear_terrain_features ───────────────────────────────────────
-    server.tool("clear_terrain_features", "Wipe Hills, Clearings, Trails, or all features from MapBuilder. 'what' is one of: Hills, Clearings, Trails, CavePath, all (default).", {
+    server.tool("clear_terrain_features", "Wipe MapBuilder feature lists — Hills, Clearings, Trails, CavePath, or all of them (default). Destructive: the feature definitions are removed. Returns `cleared` (map of list name → entries removed) and `rebuilt`; re-add features with add_terrain_hill / add_terrain_clearing / add_terrain_trail.", {
         what: z
             .enum(["Hills", "Clearings", "Trails", "CavePath", "all"])
-            .default("all"),
-        rebuild: z.boolean().default(true),
-        id: z.string().optional(),
+            .default("all")
+            .describe("Which feature list to clear. Default 'all' (clears all four)."),
+        rebuild: z.boolean().default(true).describe("Rebuild terrain after clearing (default true)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the MapBuilder; omit to auto-find the first MapBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -132,17 +133,17 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── add_cave_waypoint ────────────────────────────────────────────
-    server.tool("add_cave_waypoint", "Append (or insert) a waypoint to CaveBuilder.Path. Z is depth (negative = underground).", {
-        x: z.number(),
-        y: z.number(),
+    server.tool("add_cave_waypoint", "Append (or insert at `index`) a waypoint to CaveBuilder.Path. Z is depth (negative = underground). Returns `added`, `total` (waypoint count), and `rebuilt` — rebuilds the cave ('Build Cave') immediately unless rebuild=false.", {
+        x: z.number().describe("World X of the waypoint"),
+        y: z.number().describe("World Y of the waypoint"),
         z: z.number().default(0).describe("Z depth — negative = underground"),
         index: z
             .number()
             .int()
             .optional()
             .describe("Optional insert position (default: append to end)"),
-        rebuild: z.boolean().default(true),
-        id: z.string().optional(),
+        rebuild: z.boolean().default(true).describe("Rebuild the cave after adding (default true; set false to batch)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the CaveBuilder; omit to auto-find the first CaveBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -154,8 +155,8 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── clear_cave_path ──────────────────────────────────────────────
-    server.tool("clear_cave_path", "Clear all waypoints in CaveBuilder and remove the cave from the scene.", {
-        id: z.string().optional(),
+    server.tool("clear_cave_path", "Clear all waypoints in CaveBuilder.Path and remove the built cave from the scene (invokes 'Clear Cave'). Destructive. Returns `cleared` — the number of waypoints removed; start a new path with add_cave_waypoint.", {
+        id: z.string().optional().describe("GUID of the GameObject holding the CaveBuilder; omit to auto-find the first CaveBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -167,11 +168,11 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── add_forest_poi ───────────────────────────────────────────────
-    server.tool("add_forest_poi", "Add a point of interest (clearing) to ForestGenerator.POIs. Returns the index of the new POI for use with add_forest_trail.", {
-        name: z.string().default("POI"),
-        x: z.number(),
-        y: z.number(),
-        radius: z.number().default(300),
+    server.tool("add_forest_poi", "Add a point of interest (clearing) to ForestGenerator.POIs. Returns `added`, `index` (the new POI's index — pass it to add_forest_trail as from_index/to_index), `total`, and `rebuilt`. Forest gen is slow (~1s), so rebuild defaults to false — batch your POIs/trails, then regenerate once (rebuild=true on the last call, or invoke_button 'Generate Forest').", {
+        name: z.string().default("POI").describe("Display name for the POI. Default 'POI'."),
+        x: z.number().describe("World X of POI center"),
+        y: z.number().describe("World Y of POI center"),
+        radius: z.number().default(300).describe("POI radius in world units. Default 300."),
         density_multiplier: z
             .number()
             .default(1)
@@ -180,7 +181,7 @@ export function registerWorldTools(server, bridge) {
             .boolean()
             .default(false)
             .describe("Forest gen is slow (~1s); default false to batch"),
-        id: z.string().optional(),
+        id: z.string().optional().describe("GUID of the GameObject holding the ForestGenerator; omit to auto-find the first ForestGenerator in the scene"),
         component: z
             .string()
             .optional()
@@ -192,11 +193,11 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── add_forest_trail ─────────────────────────────────────────────
-    server.tool("add_forest_trail", "Add a trail gap between two POIs (by index) to ForestGenerator.Trails.", {
-        from_index: z.number().int(),
-        to_index: z.number().int(),
-        rebuild: z.boolean().default(false),
-        id: z.string().optional(),
+    server.tool("add_forest_trail", "Add a trail gap between two POIs to ForestGenerator.Trails. Returns `added`, `total` (trail count), and `rebuilt`. rebuild defaults to false — nothing changes visually until you regenerate (rebuild=true, or invoke_button 'Generate Forest').", {
+        from_index: z.number().int().describe("Index of the start POI (the `index` returned by add_forest_poi)"),
+        to_index: z.number().int().describe("Index of the end POI (the `index` returned by add_forest_poi)"),
+        rebuild: z.boolean().default(false).describe("Regenerate the forest after adding (default false — batch, then rebuild once)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the ForestGenerator; omit to auto-find the first ForestGenerator in the scene"),
         component: z
             .string()
             .optional()
@@ -208,10 +209,10 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── set_forest_seed ──────────────────────────────────────────────
-    server.tool("set_forest_seed", "Set ForestGenerator.Seed and regenerate. Useful for re-rolling layouts.", {
-        seed: z.number().int().default(77),
-        rebuild: z.boolean().default(true),
-        id: z.string().optional(),
+    server.tool("set_forest_seed", "Set ForestGenerator.Seed and (by default) regenerate — re-rolls the forest layout while keeping POIs, trails, and density regions. Returns `set`, `seed`, and `rebuilt`; take a screenshot afterwards (screenshot_from) to judge the new layout.", {
+        seed: z.number().int().default(77).describe("New random seed (integer). Default 77."),
+        rebuild: z.boolean().default(true).describe("Regenerate the forest after setting (default true)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the ForestGenerator; omit to auto-find the first ForestGenerator in the scene"),
         component: z
             .string()
             .optional()
@@ -223,8 +224,8 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── clear_forest_pois ────────────────────────────────────────────
-    server.tool("clear_forest_pois", "Wipe all POIs and trails in ForestGenerator and clear placed forest objects from the scene.", {
-        id: z.string().optional(),
+    server.tool("clear_forest_pois", "Wipe all POIs and trails in ForestGenerator and clear placed forest objects from the scene (invokes 'Clear Forest'). Destructive. Returns `cleared` — the number of POIs removed; rebuild a layout with add_forest_poi + add_forest_trail, then invoke_button 'Generate Forest'.", {
+        id: z.string().optional().describe("GUID of the GameObject holding the ForestGenerator; omit to auto-find the first ForestGenerator in the scene"),
         component: z
             .string()
             .optional()
@@ -236,13 +237,13 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── sculpt_terrain ───────────────────────────────────────────────
-    server.tool("sculpt_terrain", "Apply a heightmap brush at (x, y) to MapBuilder. Modes: raise, lower, flatten, smooth. Modifies the current heightmap directly and rebuilds the mesh; survives between calls until you press Build Terrain again.", {
+    server.tool("sculpt_terrain", "Apply a heightmap brush at (x, y) to MapBuilder. Modes: raise, lower, flatten, smooth. Modifies the current heightmap directly and rebuilds the mesh; edits survive between calls but are lost when 'Build Terrain' regenerates from the feature lists. Returns `sculpted`, `mode`, and `affected_vertices`; verify with raycast_terrain at the brush center.", {
         x: z.number().describe("World X of brush center"),
         y: z.number().describe("World Y of brush center"),
         radius: z.number().default(400).describe("Brush radius in world units"),
         strength: z.number().default(50).describe("Height delta (units) for raise/lower; ignored for flatten/smooth"),
-        mode: z.enum(["raise", "lower", "flatten", "smooth"]).default("raise"),
-        id: z.string().optional(),
+        mode: z.enum(["raise", "lower", "flatten", "smooth"]).default("raise").describe("Brush mode. Default 'raise'. `strength` applies to raise/lower only."),
+        id: z.string().optional().describe("GUID of the GameObject holding the MapBuilder; omit to auto-find the first MapBuilder in the scene"),
         component: z
             .string()
             .optional()
@@ -254,13 +255,13 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── paint_forest_density ─────────────────────────────────────────
-    server.tool("paint_forest_density", "Add a circular biome region with overridden forest density. Multiple regions stack via cosine falloff. density: 0=no trees, 1=normal, 2=double.", {
-        x: z.number(),
-        y: z.number(),
-        radius: z.number().default(800),
+    server.tool("paint_forest_density", "Add a circular biome region with overridden forest density to ForestGenerator.DensityRegions. Multiple regions stack via cosine falloff. density: 0=no trees, 1=normal, 2=double. Returns `painted`, `total` (region count), and `rebuilt` — rebuild defaults to false, so regenerate (rebuild=true, or invoke_button 'Generate Forest') to see the change.", {
+        x: z.number().describe("World X of region center"),
+        y: z.number().describe("World Y of region center"),
+        radius: z.number().default(800).describe("Region radius in world units. Default 800."),
         density: z.number().default(1).describe("Density multiplier (0=clear, 1=normal, 2=dense)"),
-        rebuild: z.boolean().default(false),
-        id: z.string().optional(),
+        rebuild: z.boolean().default(false).describe("Regenerate the forest after adding (default false; batch, then rebuild once)"),
+        id: z.string().optional().describe("GUID of the GameObject holding the ForestGenerator; omit to auto-find the first ForestGenerator in the scene"),
         component: z
             .string()
             .optional()
@@ -272,7 +273,7 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── place_along_path ─────────────────────────────────────────────
-    server.tool("place_along_path", "Drop instances of a model along a path (list of points). Useful for fences, lampposts, road markers, lined-up rocks.", {
+    server.tool("place_along_path", "Drop instances of a model along a path (list of points). Useful for fences, lampposts, road markers, lined-up rocks. Returns `placed` (instance count) and `folder` — the GUID of the new parent GameObject grouping the instances; pass `folder` to delete_gameobject to remove the whole run, or to set_parent/set_transform to move it.", {
         model: z.string().describe("Model path (e.g. 'models/dev/box.vmdl' or installed-asset path)"),
         points: z
             .array(z.object({ x: z.number(), y: z.number(), z: z.number().default(0) }))
@@ -280,9 +281,9 @@ export function registerWorldTools(server, bridge) {
             .describe("Path waypoints (at least 2)"),
         spacing: z.number().default(200).describe("Distance between placements (world units)"),
         jitter: z.number().default(0).describe("Max random offset perpendicular to path"),
-        min_scale: z.number().default(1),
-        max_scale: z.number().default(1),
-        seed: z.number().int().default(42),
+        min_scale: z.number().default(1).describe("Minimum uniform scale per instance (random between min and max). Default 1."),
+        max_scale: z.number().default(1).describe("Maximum uniform scale per instance. Default 1."),
+        seed: z.number().int().default(42).describe("Random seed for jitter and scale — same seed reproduces the same placement. Default 42."),
         name: z.string().default("PathItem").describe("Base name for placed objects"),
     }, async (params) => {
         const res = await bridge.send("place_along_path", params);
@@ -291,10 +292,10 @@ export function registerWorldTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── build_terrain_mesh ───────────────────────────────────────────
-    server.tool("build_terrain_mesh", "Build a standalone heightmap terrain mesh from a hills/clearings JSON spec — independent of MapBuilder. Use when you don't have a MapBuilder component in the scene and want one-shot terrain.", {
+    server.tool("build_terrain_mesh", "Build a standalone heightmap terrain mesh (a MeshComponent) from a hills/clearings JSON spec — independent of MapBuilder. Use when you don't have a MapBuilder component in the scene and want one-shot terrain. Returns `built`, `id` (the new GameObject's GUID), `name`, `vertices`, and `faces`; pass `id` to assign_material, set_transform, or delete_gameobject. Note: raycast_terrain cannot sample this mesh (it requires MapBuilder).", {
         size: z.number().default(9600).describe("Total terrain size (world units, square)"),
         resolution: z.number().int().default(64).describe("Grid resolution per side"),
-        name: z.string().default("Generated Terrain"),
+        name: z.string().default("Generated Terrain").describe("Name for the created terrain GameObject. Default 'Generated Terrain'."),
         hills: z
             .array(z.object({
             x: z.number(),
@@ -302,10 +303,12 @@ export function registerWorldTools(server, bridge) {
             radius: z.number().default(500),
             height: z.number().default(100),
         }))
-            .default([]),
+            .default([])
+            .describe("Hill bumps: array of {x, y, radius (default 500), height (default 100; negative = depression)}. Default: none."),
         clearings: z
             .array(z.object({ x: z.number(), y: z.number(), radius: z.number().default(300) }))
-            .default([]),
+            .default([])
+            .describe("Zones flattened back toward height 0: array of {x, y, radius (default 300)}. Default: none."),
     }, async (params) => {
         const res = await bridge.send("build_terrain_mesh", params);
         if (!res.success)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbox-mcp-server",
-  "version": "1.20.0",
+  "version": "2.0.0",
   "description": "MCP Server for s&box game engine — enables Claude to build games through conversation",
   "type": "module",
   "main": "dist/index.js",