sbox-mcp-server 1.7.0 → 1.8.0

package/dist/tools/networking.js

@@ -114,7 +114,7 @@ export function registerNetworkingTools(server, bridge) {
         syncFlags: z
             .string()
             .optional()
-            .describe("Currently ignored — not yet implemented. The addon emits a plain [Sync] with no SyncFlags"),
+            .describe("Optional SyncFlags to emit as [Sync( SyncFlags.X )] — e.g. 'Interpolate' (smooth interpolation), 'Query', 'FromHost'. Omit for a plain [Sync]"),
         defaultValue: z
             .string()
             .optional()
@@ -129,7 +129,7 @@ export function registerNetworkingTools(server, bridge) {
         };
     });
     // ── add_rpc_method ────────────────────────────────────────────────
-    server.tool("add_rpc_method", "Generate an EMPTY, no-argument RPC method stub in a C# script for you to fill in. The addon inserts the chosen RPC attribute ([Rpc.Broadcast] all clients, [Rpc.Host] host only, [Rpc.Owner] owner only) above a parameterless method with an empty body — it does NOT add parameters or generate body code", {
+    server.tool("add_rpc_method", "Generate an RPC method stub in a C# script. Inserts the chosen RPC attribute ([Rpc.Broadcast] all clients, [Rpc.Host] host only, [Rpc.Owner] owner only) above a method with an empty body. Pass methodParams to give it a parameter list (e.g. 'Vector3 pos, int damage'); the body is left as a TODO for you to fill in", {
         path: z
             .string()
             .describe("Relative path to the script file"),
@@ -141,7 +141,7 @@ export function registerNetworkingTools(server, bridge) {
         methodParams: z
             .string()
             .optional()
-            .describe("Currently ignored — not yet implemented. The addon emits a no-argument method; add parameters yourself afterward"),
+            .describe("Optional parameter list for the RPC method signature, e.g. 'Vector3 pos, int damage'. Omit for a parameterless method"),
         body: z
             .string()
             .optional()

package/dist/tools/playmode.js

@@ -82,7 +82,7 @@ export function registerPlayModeTools(server, bridge) {
         property: z.string().describe("Property name to set"),
         value: z
             .unknown()
-            .describe("New value as a string. Primitive: '5', 'true'. Color/Vector3: '1,0,0,1' / '0,0,200'. Enum: the member name. Asset ref (Model/Material/...): the asset path e.g. 'models/dev/box.vmdl'. GameObject/Component ref: the target GameObject's GUID. Empty/'null' clears the property"),
+            .describe("New value. Primitive: '5', 'true'. Color/Vector3: a comma string ('1,0,0,1' / '0,0,200'), an array ([0,0,200]), or an object ({r,g,b,a} / {x,y,z}). Enum: the member name. Asset ref (Model/Material/...): the asset path e.g. 'models/dev/box.vmdl'. GameObject/Component ref: the target GameObject's GUID. Empty/'null' clears the property"),
     }, async (params) => {
         const res = await bridge.send("set_property", params);
         if (!res.success) {

package/dist/tools/visuals.js

@@ -61,30 +61,30 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── set_fog ────────────────────────────────────────────────────────
-    server.tool("set_fog", "Add or update distance fog in the active scene. v1 supports gradient fog (atmospheric distance haze — great for mood/horror). Re-running on the same target updates it rather than duplicating.", {
+    server.tool("set_fog", "Add or update fog in the active scene. Types: 'gradient' (distance haze — great for mood/horror), 'cubemap' (sky-tinted distance fog), 'volumetric' (a localized fog volume). Re-running on the same target updates it rather than duplicating.", {
         type: z
-            .enum(["gradient"])
+            .enum(["gradient", "cubemap", "volumetric"])
             .optional()
-            .describe("Fog type (default gradient; cubemap/volumetric coming later)"),
+            .describe("Fog type (default gradient)"),
         name: z.string().optional().describe("GameObject name when creating a new fog object"),
         targetId: z
             .string()
             .optional()
-            .describe("GUID of an existing GameObject to host the fog (else a new 'Gradient Fog' object is created)"),
-        color: ColorSchema.optional().describe("Fog colour"),
-        startDistance: z
-            .number()
-            .optional()
-            .describe("Distance (units) where fog begins"),
-        endDistance: z
-            .number()
-            .optional()
-            .describe("Distance (units) where fog reaches full density"),
-        height: z.number().optional().describe("World height the fog settles around"),
-        falloff: z
-            .number()
+            .describe("GUID of an existing GameObject to host the fog (else a new fog object is created)"),
+        color: ColorSchema.optional().describe("Fog colour (gradient/volumetric Color, cubemap Tint)"),
+        startDistance: z.number().optional().describe("gradient/cubemap: distance (units) where fog begins"),
+        endDistance: z.number().optional().describe("gradient/cubemap: distance (units) where fog reaches full density"),
+        height: z.number().optional().describe("gradient: world height the fog settles around"),
+        falloff: z.number().optional().describe("Distance/density falloff exponent (higher = sharper onset)"),
+        blur: z.number().optional().describe("cubemap: sky blur amount"),
+        heightStart: z.number().optional().describe("cubemap: world height where height-fog starts"),
+        heightWidth: z.number().optional().describe("cubemap: height-fog band width"),
+        heightExponent: z.number().optional().describe("cubemap: height-fog falloff exponent"),
+        strength: z.number().optional().describe("volumetric: fog density/strength"),
+        size: z
+            .object({ x: z.number(), y: z.number(), z: z.number() })
             .optional()
-            .describe("Distance falloff exponent (higher = sharper onset)"),
+            .describe("volumetric: bounds size (units) centred on the object"),
     }, async (params) => {
         const res = await bridge.send("set_fog", params);
         if (!res.success) {

package/dist/tools/world.js

@@ -17,17 +17,21 @@ import { z } from "zod";
  */
 export function registerWorldTools(server, bridge) {
     // ── invoke_button ────────────────────────────────────────────────
-    server.tool("invoke_button", "Call a no-argument public method on a component. Matching is tried in order: (1) a [Button] attribute label, (2) the exact method NAME, (3) case-insensitive name with spaces stripped. So this calls ANY parameterless public method, not only [Button]-attributed ones (e.g. 'StartGame' works even without a [Button]). This is the general 'call a component method to drive game state' tool. LIMITATION: parameterless methods only — methods that take arguments are skipped. (list_component_buttons only lists [Button] methods, so a plain method may be invokable yet not appear there.)", {
+    server.tool("invoke_button", "Call a public method on a component. Matching is tried in order: (1) a [Button] attribute label, (2) the exact method NAME, (3) case-insensitive name with spaces stripped. Calls ANY public method, not only [Button]-attributed ones (e.g. 'StartGame'). Pass `args` to call methods that take parameters — the arg count must match and each value is coerced to the parameter type (primitives: string/number/bool work; complex types like Vector3 may not coerce). Omit args (or []) for parameterless methods. (list_component_buttons only lists [Button] methods, so a plain method may be invokable yet not appear there.)", {
         component: z
             .string()
             .describe("Component type name (e.g. 'MapBuilder', 'SasquatchedGame')"),
         button: z
             .string()
-            .describe("A [Button] label OR a public no-arg method name (e.g. 'Build Terrain', 'StartGame'); case- and space-insensitive"),
+            .describe("A [Button] label OR a public method name (e.g. 'Build Terrain', 'StartGame'); case- and space-insensitive"),
         id: z
             .string()
             .optional()
             .describe("Optional GameObject GUID — if omitted, finds first matching component in scene"),
+        args: z
+            .array(z.unknown())
+            .optional()
+            .describe("Arguments to pass (must match the method's parameter count); coerced to each parameter type"),
     }, async (params) => {
         const res = await bridge.send("invoke_button", params);
         if (!res.success)
@@ -49,6 +53,10 @@ export function registerWorldTools(server, bridge) {
         x: z.number().describe("World X coordinate"),
         y: z.number().describe("World Y coordinate"),
         id: z.string().optional().describe("Optional GameObject GUID for MapBuilder"),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the terrain component type name (default MapBuilder)"),
     }, async (params) => {
         const res = await bridge.send("raycast_terrain", params);
         if (!res.success)
@@ -63,6 +71,10 @@ export function registerWorldTools(server, bridge) {
         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(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("add_terrain_hill", params);
         if (!res.success)
@@ -76,6 +88,10 @@ export function registerWorldTools(server, bridge) {
         radius: z.number().default(300),
         rebuild: z.boolean().default(true),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("add_terrain_clearing", params);
         if (!res.success)
@@ -88,6 +104,10 @@ export function registerWorldTools(server, bridge) {
         to: z.object({ x: z.number(), y: z.number() }),
         rebuild: z.boolean().default(true),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("add_terrain_trail", params);
         if (!res.success)
@@ -101,6 +121,10 @@ export function registerWorldTools(server, bridge) {
             .default("all"),
         rebuild: z.boolean().default(true),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("clear_terrain_features", params);
         if (!res.success)
@@ -119,6 +143,10 @@ export function registerWorldTools(server, bridge) {
             .describe("Optional insert position (default: append to end)"),
         rebuild: z.boolean().default(true),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("add_cave_waypoint", params);
         if (!res.success)
@@ -128,6 +156,10 @@ export function registerWorldTools(server, bridge) {
     // ── clear_cave_path ──────────────────────────────────────────────
     server.tool("clear_cave_path", "Clear all waypoints in CaveBuilder and remove the cave from the scene.", {
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("clear_cave_path", params);
         if (!res.success)
@@ -149,6 +181,10 @@ export function registerWorldTools(server, bridge) {
             .default(false)
             .describe("Forest gen is slow (~1s); default false to batch"),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("add_forest_poi", params);
         if (!res.success)
@@ -161,6 +197,10 @@ export function registerWorldTools(server, bridge) {
         to_index: z.number().int(),
         rebuild: z.boolean().default(false),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("add_forest_trail", params);
         if (!res.success)
@@ -172,6 +212,10 @@ export function registerWorldTools(server, bridge) {
         seed: z.number().int().default(77),
         rebuild: z.boolean().default(true),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("set_forest_seed", params);
         if (!res.success)
@@ -181,6 +225,10 @@ export function registerWorldTools(server, bridge) {
     // ── 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(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("clear_forest_pois", params);
         if (!res.success)
@@ -195,6 +243,10 @@ export function registerWorldTools(server, bridge) {
         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(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("sculpt_terrain", params);
         if (!res.success)
@@ -209,6 +261,10 @@ export function registerWorldTools(server, bridge) {
         density: z.number().default(1).describe("Density multiplier (0=clear, 1=normal, 2=dense)"),
         rebuild: z.boolean().default(false),
         id: z.string().optional(),
+        component: z
+            .string()
+            .optional()
+            .describe("Override the builder component type name — set this if your project's terrain/cave/forest component is named differently than the default (MapBuilder/CaveBuilder/ForestGenerator)"),
     }, async (params) => {
         const res = await bridge.send("paint_forest_density", params);
         if (!res.success)

package/package.json

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