sbox-mcp-server 1.20.0 → 2.1.0

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/dist/tools/worldrender.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+export declare function registerWorldRenderTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=worldrender.d.ts.map

package/dist/tools/worldrender.js

@@ -0,0 +1,183 @@
+import { z } from "zod";
+/**
+ * World & Render family — three tools:
+ *
+ *   - add_water_body            WaterVolume physics volume + trigger BoxCollider
+ *                               footprint + optional tinted visual surface
+ *   - add_render_target_camera  secondary camera → render-target texture →
+ *                               display surface (CCTV / mirror / portal)
+ *   - add_daynight_sun          codegen sun/sky driver bound to the component
+ *                               generated by create_day_night_clock
+ *
+ * add_water_body is scene-direct; the other two generate a sealed game-code
+ * component (hotload to compile). All three are scene/file-mutating and are
+ * refused during play mode by the bridge dispatch.
+ */
+// Colour / vector accepted as EITHER an object OR a comma string, passed
+// through unchanged. The C# handler parses both forms (source of truth). See
+// the cross-language vector/color contract.
+const ColorObject = z.object({
+    r: z.number().min(0).describe("Red, 0-1"),
+    g: z.number().min(0).describe("Green, 0-1"),
+    b: z.number().min(0).describe("Blue, 0-1"),
+    a: z.number().min(0).max(1).optional().describe("Alpha, 0-1 (default 1)"),
+});
+const ColorSchema = z
+    .union([
+    ColorObject,
+    z.string().describe('Comma string "r,g,b,a", e.g. "1,0,0,1"'),
+])
+    .describe('RGBA colour — object {r,g,b,a} (0-1) OR comma string "r,g,b,a"');
+const Vector3Object = z.object({ x: z.number(), y: z.number(), z: z.number() });
+const Vector3Schema = z
+    .union([
+    Vector3Object,
+    z.string().describe('Comma string "x,y,z", e.g. "0,0,200"'),
+])
+    .describe('World position — object {x,y,z} OR comma string "x,y,z"');
+const RotationSchema = z
+    .object({ pitch: z.number(), yaw: z.number(), roll: z.number() })
+    .describe("Rotation {pitch,yaw,roll} in degrees");
+export function registerWorldRenderTools(server, bridge) {
+    // ── add_water_body ───────────────────────────────────────────────
+    server.tool("add_water_body", "Create a swimmable/buoyant water region: a GameObject with a WaterVolume (s&box's buoyancy + drag physics volume, region defined by a trigger BoxCollider sized to `size`) plus, by default, a simple flat translucent-blue surface box at the water line so it's visible. HONEST LIMIT: the visual is a tinted dev-box stand-in, NOT a Gerstner/water shader — the dev material may render the tint opaque; swap in a real water material later. Only the WaterVolume properties you pass are set (engine defaults otherwise). Returns {created, gameObject{id,...}, size, appliedProperties[], surface{id,...}|null, note, nextSteps[]}. Next: start_play and drop a physics prop in to verify buoyancy; tune FluidDensity/LinearDrag/WaveAmplitude etc. with set_property on the WaterVolume. Scene-mutating — refused during play mode.", {
+        name: z
+            .string()
+            .optional()
+            .describe("GameObject name. Defaults to 'Water'"),
+        position: Vector3Schema.optional().describe("World position of the volume's CENTRE (the surface sits at z + size.z/2 + surfaceOffset)"),
+        size: z
+            .string()
+            .optional()
+            .describe("Full extents of the volume as 'x,y,z' world units. Defaults to '512,512,128'"),
+        density: z
+            .number()
+            .optional()
+            .describe("WaterVolume.FluidDensity — higher = more buoyant. Engine default when omitted"),
+        linearDrag: z
+            .number()
+            .optional()
+            .describe("WaterVolume.LinearDrag on submerged bodies. Engine default when omitted"),
+        angularDrag: z
+            .number()
+            .optional()
+            .describe("WaterVolume.AngularDrag on submerged bodies. Engine default when omitted"),
+        waveAmplitude: z
+            .number()
+            .optional()
+            .describe("WaterVolume.WaveAmplitude — physics wave height (does NOT animate the visual surface)"),
+        waveFrequency: z
+            .number()
+            .optional()
+            .describe("WaterVolume.WaveFrequency — physics wave frequency"),
+        fluidVelocity: Vector3Schema.optional().describe("WaterVolume.FluidVelocity — current/flow direction and speed, world units/s"),
+        surfaceOffset: z
+            .number()
+            .optional()
+            .describe("WaterVolume.SurfaceOffset — shifts the water line relative to the top of the box"),
+        visualSurface: z
+            .boolean()
+            .optional()
+            .describe("Create the tinted surface box child. Defaults to true"),
+        surfaceColor: ColorSchema.optional().describe("Tint of the visual surface. Defaults to translucent blue (0.15,0.35,0.55,0.6)"),
+        parentId: z.string().optional().describe("GUID of a parent GameObject"),
+    }, async (params) => {
+        const res = await bridge.send("add_water_body", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ── add_render_target_camera ─────────────────────────────────────
+    server.tool("add_render_target_camera", "CCTV / security monitor / mirror / simple portal: creates a secondary camera (IsMainCamera=false, Priority param) positioned/rotated or aimed at a target object, a display surface (scaled box with a ModelRenderer), and GENERATES a sealed wiring component that at runtime creates the render-target Texture (Texture.CreateRenderTarget builder), assigns camera.RenderTarget and sets the texture onto an anonymous complex-shader material on the display (attribute 'Color' = albedo; the screen is scene-lit, not emissive/unlit). Returns {created, camera{id,...}, display{id,...}|null, className, path, generatedCode, attachedAndWired, resolution, nextSteps[]}. FIRST call generates the .cs → follow nextSteps: trigger_hotload, then add_component_with_properties on the display with properties {SourceCamera: <camera GUID>}; a REPEAT call reusing the same `name` after the hotload attaches AND wires everything automatically (attachedAndWired=true). The feed only renders in play mode — verify with start_play + capture_view. If `name`'s .cs file exists but isn't compiled yet, the call errors — hotload first. Scene/file-mutating — refused during play mode.", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class name for the generated wiring component. Defaults to 'RenderTargetDisplay'. Reuse the same name for extra cameras — after a hotload the class is reused and wired in one shot"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Subdirectory for the generated .cs file. Defaults to 'Code'"),
+        cameraName: z
+            .string()
+            .optional()
+            .describe("GameObject name for the camera. Defaults to 'RT Camera'"),
+        position: Vector3Schema.optional().describe("World position of the camera"),
+        rotation: RotationSchema.optional().describe("World rotation of the camera"),
+        lookAtId: z
+            .string()
+            .optional()
+            .describe("GUID of a GameObject to aim the camera at (overrides rotation; from get_scene_hierarchy / find_objects)"),
+        priority: z
+            .number()
+            .optional()
+            .describe("CameraComponent.Priority (integer). Defaults to 1"),
+        fieldOfView: z
+            .number()
+            .optional()
+            .describe("Camera field of view in degrees (clamped 5-170). Engine default when omitted"),
+        resolution: z
+            .string()
+            .optional()
+            .describe("Render-target size as 'width,height' pixels (min 16). Defaults to '512,512'"),
+        backgroundColor: ColorSchema.optional().describe("Camera background colour. Engine default when omitted"),
+        createDisplay: z
+            .boolean()
+            .optional()
+            .describe("Create the display surface GameObject. Defaults to true. Pass false to wire your own surface later"),
+        displayPosition: Vector3Schema.optional().describe("World position of the display surface"),
+        displayRotation: RotationSchema.optional().describe("World rotation of the display surface"),
+        displaySize: z
+            .string()
+            .optional()
+            .describe("Display box extents as 'x,y,z' world units (thin x = a wall screen facing ±x). Defaults to '4,128,72'"),
+        attribute: z
+            .string()
+            .optional()
+            .describe("Material attribute that receives the texture. Defaults to 'Color' (albedo on the complex shader). Sanitized to [A-Za-z0-9_]"),
+    }, async (params) => {
+        const res = await bridge.send("add_render_target_camera", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ── add_daynight_sun ─────────────────────────────────────────────
+    server.tool("add_daynight_sun", "Generate a sun/sky driver component for the clock made by create_day_night_clock — a COMPANION, not a replacement: the clock owns TimeOfDay, this renders it. Every frame it reads TimeOfDay/SunriseHour/SunsetHour off the clock (sibling first, else first in scene, retrying 1/s) and drives a DirectionalLight: sunrise→sunset maps to a 0-180° pitch arc (continuing below the horizon at night), LightColor runs a hardcoded gradient (warm dawn → white noon → orange dusk → dim blue night, HDR-scaled by Intensity since s&box lights have no Brightness field), and optionally lerps the SkyBox2D Tint between night blue and day white. The clock CLASS NAME is baked in as a typed reference — the call ERRORS if `clockClass` isn't found in the TypeLibrary or any project .cs (run create_day_night_clock first; a bad token would break the whole game-assembly compile). Returns {created, path, className, clockClass, sunYaw, intensity, driveSkybox, placedOn, note, nextSteps[]}. Next: trigger_hotload → attach to the DirectionalLight's GameObject → start_play, set_runtime_property TimeOfDay on the clock (6/12/20/0) + capture_view to verify the looks. File/scene-mutating — refused during play mode.", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class name for the generated component. Defaults to 'DayNightSun'"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Subdirectory for the generated .cs file. Defaults to 'Code'"),
+        clockClass: z
+            .string()
+            .optional()
+            .describe("Class name of the day-night clock to bind to (the `name` you gave create_day_night_clock). Defaults to 'DayNightClock'. Must already exist as a compiled type or a project .cs file"),
+        sunYaw: z
+            .number()
+            .optional()
+            .describe("Compass heading of the sun's arc in degrees. Defaults to 30"),
+        intensity: z
+            .number()
+            .optional()
+            .describe("Brightness multiplier on the colour gradient (HDR, >1 valid; intensity = colour magnitude). Defaults to 1"),
+        driveSkybox: z
+            .boolean()
+            .optional()
+            .describe("Also tint the scene's SkyBox2D between night blue and day white. Defaults to true"),
+        targetId: z
+            .string()
+            .optional()
+            .describe("GUID of a GameObject to attach to (only attaches if the type is already loaded — hotload first)"),
+    }, async (params) => {
+        const res = await bridge.send("add_daynight_sun", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=worldrender.js.map

package/package.json

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