sbox-mcp-server 1.2.0

package/dist/tools/discovery.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+/**
+ * Type discovery and code-search tools.
+ *
+ * These help Claude reference real s&box APIs instead of guessing. Use
+ * describe_type before writing code that touches an unfamiliar type — the
+ * Game.TypeLibrary reflection returns properties, methods, events, and
+ * attributes for any loaded type. Use search_types to find types matching
+ * a name pattern. find_in_project greps the user's project for usage examples.
+ */
+export function registerDiscoveryTools(server, bridge) {
+    // ── describe_type ────────────────────────────────────────────────
+    server.tool("describe_type", "Inspect a type's full surface — properties, methods, events, attributes — via reflection on Game.TypeLibrary and loaded assemblies. Use this before writing code touching an unfamiliar component or s&box API. Examples: 'MeshComponent', 'PlayerController', 'NetworkHelper', 'Vector3'.", {
+        name: z.string().describe("Type name (short or fully-qualified)"),
+    }, async (params) => {
+        const res = await bridge.send("describe_type", params);
+        if (!res.success)
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ── search_types ─────────────────────────────────────────────────
+    server.tool("search_types", "Find types matching a name pattern. Pass components_only=true to filter to Component subclasses only. Useful for discovering 'is there a built-in X for this?'", {
+        pattern: z.string().describe("Substring to match against type name (case-insensitive)"),
+        namespace: z
+            .string()
+            .optional()
+            .describe("Optional namespace filter (case-insensitive substring)"),
+        components_only: z.boolean().default(false),
+        limit: z.number().int().default(50),
+    }, async (params) => {
+        const res = await bridge.send("search_types", params);
+        if (!res.success)
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ── get_method_signature ─────────────────────────────────────────
+    server.tool("get_method_signature", "Get the formal signature(s) of a method on a type — parameter names, types, defaults, return type, all overloads. Use before invoking an API you're unsure of.", {
+        type: z.string().describe("Type name (e.g. 'Scene', 'GameObject')"),
+        method: z.string().describe("Method name (case-sensitive)"),
+    }, async (params) => {
+        const res = await bridge.send("get_method_signature", params);
+        if (!res.success)
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ── find_in_project ──────────────────────────────────────────────
+    server.tool("find_in_project", "Grep the user's s&box project for a symbol. Returns file paths and line numbers. Useful for finding usage examples of an API or seeing how the project already does something.", {
+        symbol: z.string().describe("Substring or symbol to search for"),
+        extension: z.string().default(".cs").describe("File extension filter"),
+        max_results: z.number().int().default(25),
+    }, async (params) => {
+        const res = await bridge.send("find_in_project", params);
+        if (!res.success)
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=discovery.js.map

package/dist/tools/gameobjects.d.ts

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

package/dist/tools/gameobjects.js

@@ -0,0 +1,197 @@
+import { z } from "zod";
+/**
+ * GameObject lifecycle, hierarchy, and selection tools.
+ *
+ * Registers: create/delete/duplicate/rename_gameobject, set_parent,
+ * set_enabled, set_transform, get_scene_hierarchy, get_selected_objects,
+ * select_object, focus_object.
+ *
+ * Uses shared Zod schemas (Vector3Schema, RotationSchema) for consistent
+ * Vector3 and Rotation parameter validation across multiple tools.
+ */
+const Vector3Schema = z
+    .object({
+    x: z.number().describe("X coordinate"),
+    y: z.number().describe("Y coordinate"),
+    z: z.number().describe("Z coordinate"),
+})
+    .describe("3D vector with x, y, z components");
+const RotationSchema = z
+    .object({
+    pitch: z.number().describe("Pitch angle in degrees"),
+    yaw: z.number().describe("Yaw angle in degrees"),
+    roll: z.number().describe("Roll angle in degrees"),
+})
+    .describe("Euler rotation with pitch, yaw, roll in degrees");
+export function registerGameObjectTools(server, bridge) {
+    // ── create_gameobject ────────────────────────────────────────────
+    server.tool("create_gameobject", "Create a new GameObject in the active scene. Returns its GUID for future reference", {
+        name: z
+            .string()
+            .optional()
+            .describe("Display name (e.g. 'Player', 'Enemy Spawn Point'). Defaults to 'New Object'"),
+        position: Vector3Schema.optional().describe("World position"),
+        rotation: RotationSchema.optional().describe("World rotation"),
+        scale: z
+            .union([z.number(), Vector3Schema])
+            .optional()
+            .describe("Uniform scale (number) or per-axis scale (Vector3)"),
+        parent: z
+            .string()
+            .optional()
+            .describe("GUID of parent GameObject. Omit for scene root"),
+    }, async (params) => {
+        const res = await bridge.send("create_gameobject", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── delete_gameobject ────────────────────────────────────────────
+    server.tool("delete_gameobject", "Delete a GameObject from the active scene by its GUID", {
+        id: z.string().describe("GUID of the GameObject to delete"),
+    }, async (params) => {
+        const res = await bridge.send("delete_gameobject", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── duplicate_gameobject ─────────────────────────────────────────
+    server.tool("duplicate_gameobject", "Clone a GameObject with all its components. Optionally offset position or rename", {
+        id: z.string().describe("GUID of the GameObject to duplicate"),
+        name: z.string().optional().describe("New name for the clone"),
+        offset: Vector3Schema.optional().describe("Position offset from original so the clone doesn't overlap"),
+    }, async (params) => {
+        const res = await bridge.send("duplicate_gameobject", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── rename_gameobject ────────────────────────────────────────────
+    server.tool("rename_gameobject", "Change the display name of a GameObject", {
+        id: z.string().describe("GUID of the GameObject"),
+        name: z.string().describe("New display name"),
+    }, async (params) => {
+        const res = await bridge.send("rename_gameobject", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── set_parent ───────────────────────────────────────────────────
+    server.tool("set_parent", "Reparent a GameObject. Set parentId to null or omit to move to scene root", {
+        id: z.string().describe("GUID of the GameObject to reparent"),
+        parentId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GUID of the new parent. Null or omitted = scene root"),
+    }, async (params) => {
+        const res = await bridge.send("set_parent", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── set_enabled ──────────────────────────────────────────────────
+    server.tool("set_enabled", "Enable or disable a GameObject (disabled objects are invisible and inactive)", {
+        id: z.string().describe("GUID of the GameObject"),
+        enabled: z.boolean().describe("true to enable, false to disable"),
+    }, async (params) => {
+        const res = await bridge.send("set_enabled", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── set_transform ────────────────────────────────────────────────
+    server.tool("set_transform", "Set position, rotation, and/or scale on a GameObject. Only provided values are changed", {
+        id: z.string().describe("GUID of the GameObject"),
+        position: Vector3Schema.optional().describe("New position"),
+        rotation: RotationSchema.optional().describe("New rotation"),
+        scale: z
+            .union([z.number(), Vector3Schema])
+            .optional()
+            .describe("New scale — uniform number or per-axis Vector3"),
+        local: z
+            .boolean()
+            .optional()
+            .describe("If true, values are in local space. Default is world space"),
+    }, async (params) => {
+        const res = await bridge.send("set_transform", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── get_scene_hierarchy ──────────────────────────────────────────
+    server.tool("get_scene_hierarchy", "Get the full scene tree — all GameObjects with their names, GUIDs, components, positions, and parent/child relationships. This is how you 'see' the scene", {
+        maxDepth: z
+            .number()
+            .optional()
+            .describe("Maximum depth of the tree to return. Defaults to 10"),
+    }, async (params) => {
+        const res = await bridge.send("get_scene_hierarchy", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── get_selected_objects ─────────────────────────────────────────
+    server.tool("get_selected_objects", "Get the GameObjects currently selected by the user in the s&box editor", {}, async () => {
+        const res = await bridge.send("get_selected_objects");
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── select_object ────────────────────────────────────────────────
+    server.tool("select_object", "Select a GameObject in the editor (highlights it in the hierarchy and scene view)", {
+        id: z.string().describe("GUID of the GameObject to select"),
+        addToSelection: z
+            .boolean()
+            .optional()
+            .describe("If true, adds to current selection instead of replacing it"),
+    }, async (params) => {
+        const res = await bridge.send("select_object", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── focus_object ─────────────────────────────────────────────────
+    server.tool("focus_object", "Move the editor camera to focus on a specific GameObject (like double-clicking in the hierarchy)", {
+        id: z.string().describe("GUID of the GameObject to focus"),
+    }, async (params) => {
+        const res = await bridge.send("focus_object", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=gameobjects.js.map

package/dist/tools/materials.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Material and model tools: assign_model, create_material, assign_material, set_material_property.
+ * Handles .vmat creation, ModelRenderer management, and runtime material property changes.
+ */
+export declare function registerMaterialTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=materials.d.ts.map

package/dist/tools/materials.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+/**
+ * Material and model tools: assign_model, create_material, assign_material, set_material_property.
+ * Handles .vmat creation, ModelRenderer management, and runtime material property changes.
+ */
+export function registerMaterialTools(server, bridge) {
+    // ── assign_model ─────────────────────────────────────────────────
+    server.tool("assign_model", "Set a 3D model on a GameObject's ModelRenderer. Creates the renderer component if it doesn't exist", {
+        id: z.string().describe("GUID of the GameObject"),
+        model: z
+            .string()
+            .describe("Model path (e.g. 'models/citizen/citizen.vmdl', 'models/dev/box.vmdl')"),
+    }, async (params) => {
+        const res = await bridge.send("assign_model", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_material ──────────────────────────────────────────────
+    server.tool("create_material", "Create a new material file (.vmat) with a shader and properties like color, roughness, metallic, texture", {
+        path: z
+            .string()
+            .describe("Relative path for the material (e.g. 'materials/walls/brick.vmat')"),
+        shader: z
+            .string()
+            .optional()
+            .describe("Shader to use. Defaults to 'shaders/complex.shader' (PBR)"),
+        properties: z
+            .record(z.unknown())
+            .optional()
+            .describe("Material properties as key-value pairs (e.g. { \"Color\": \"#ff0000\", \"Roughness\": 0.8 })"),
+    }, async (params) => {
+        const res = await bridge.send("create_material", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── assign_material ──────────────────────────────────────────────
+    server.tool("assign_material", "Apply a material to a ModelRenderer on a GameObject. Optionally target a specific material slot", {
+        id: z.string().describe("GUID of the GameObject"),
+        material: z
+            .string()
+            .describe("Material path (e.g. 'materials/walls/brick.vmat')"),
+        slot: z
+            .number()
+            .optional()
+            .describe("Material slot index. Defaults to 0 (first slot)"),
+    }, async (params) => {
+        const res = await bridge.send("assign_material", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── set_material_property ────────────────────────────────────────
+    server.tool("set_material_property", "Change a property on the material assigned to a GameObject — color, roughness, metallic, texture, etc.", {
+        id: z.string().describe("GUID of the GameObject"),
+        property: z
+            .string()
+            .describe("Material property name (e.g. 'Color', 'Roughness', 'Metalness', 'Normal')"),
+        value: z
+            .unknown()
+            .describe("Property value — number for floats, string for texture paths/colors, {r,g,b,a} for colors"),
+    }, async (params) => {
+        const res = await bridge.send("set_material_property", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=materials.js.map

package/dist/tools/networking.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Networking tools: add_network_helper, configure_network, get_network_status,
+ * network_spawn, set_ownership, add_sync_property, add_rpc_method,
+ * create_networked_player, create_lobby_manager, create_network_events.
+ *
+ * Manages s&box multiplayer: lobby creation, networked objects, RPCs, sync properties.
+ */
+export declare function registerNetworkingTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=networking.d.ts.map

package/dist/tools/networking.js

@@ -0,0 +1,227 @@
+import { z } from "zod";
+/**
+ * Networking tools: add_network_helper, configure_network, get_network_status,
+ * network_spawn, set_ownership, add_sync_property, add_rpc_method,
+ * create_networked_player, create_lobby_manager, create_network_events.
+ *
+ * Manages s&box multiplayer: lobby creation, networked objects, RPCs, sync properties.
+ */
+export function registerNetworkingTools(server, bridge) {
+    // ── add_network_helper ────────────────────────────────────────────
+    server.tool("add_network_helper", "Add a NetworkHelper component to the scene for quick multiplayer setup. Handles lobby creation and player prefab spawning", {
+        id: z
+            .string()
+            .optional()
+            .describe("GUID of existing GameObject. Creates new if omitted"),
+        name: z
+            .string()
+            .optional()
+            .describe("Name for the network manager object. Defaults to 'Network Manager'"),
+        maxPlayers: z
+            .number()
+            .optional()
+            .describe("Maximum number of players in the lobby"),
+        playerPrefab: z
+            .string()
+            .optional()
+            .describe("Path to the player prefab to spawn for each connection"),
+    }, async (params) => {
+        const res = await bridge.send("add_network_helper", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── configure_network ─────────────────────────────────────────────
+    server.tool("configure_network", "Configure networking settings on the existing NetworkHelper: max players, lobby name, player prefab, start server", {
+        maxPlayers: z
+            .number()
+            .optional()
+            .describe("Maximum number of players"),
+        lobbyName: z
+            .string()
+            .optional()
+            .describe("Display name for the lobby"),
+        playerPrefab: z
+            .string()
+            .optional()
+            .describe("Path to the player prefab"),
+        startServer: z
+            .boolean()
+            .optional()
+            .describe("Start the server/lobby immediately"),
+    }, async (params) => {
+        const res = await bridge.send("configure_network", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── get_network_status ────────────────────────────────────────────
+    server.tool("get_network_status", "Check the current multiplayer status: connection state, player count, lobby info, networked objects", {}, async (params) => {
+        const res = await bridge.send("get_network_status", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── network_spawn ─────────────────────────────────────────────────
+    server.tool("network_spawn", "Network-enable a GameObject so it is synchronized across all connected clients. Calls NetworkSpawn()", {
+        id: z.string().describe("GUID of the GameObject to network"),
+    }, async (params) => {
+        const res = await bridge.send("network_spawn", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── set_ownership ─────────────────────────────────────────────────
+    server.tool("set_ownership", "Transfer network ownership of a GameObject to a different connection, or take/drop ownership", {
+        id: z.string().describe("GUID of the networked GameObject"),
+        connectionId: z
+            .string()
+            .optional()
+            .describe("GUID of the target connection. Empty string = drop ownership. Omit = take ownership"),
+    }, async (params) => {
+        const res = await bridge.send("set_ownership", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── add_sync_property ─────────────────────────────────────────────
+    server.tool("add_sync_property", "Add a [Sync] networked property to a C# script. The property auto-replicates across the network", {
+        path: z
+            .string()
+            .describe("Relative path to the script file (e.g. 'code/Player.cs')"),
+        propertyName: z.string().describe("Name for the new property"),
+        propertyType: z
+            .string()
+            .optional()
+            .describe("C# type (float, int, string, Vector3, bool, etc.). Defaults to 'float'"),
+        syncFlags: z
+            .string()
+            .optional()
+            .describe("Sync flags: 'FromHost' (host→clients only). Omit for bidirectional"),
+        defaultValue: z
+            .string()
+            .optional()
+            .describe("Default value expression (e.g. '100f', 'true', 'Vector3.Zero')"),
+    }, async (params) => {
+        const res = await bridge.send("add_sync_property", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── add_rpc_method ────────────────────────────────────────────────
+    server.tool("add_rpc_method", "Add an RPC method to a C# script. Supports [Rpc.Broadcast] (all clients), [Rpc.Host] (host only), [Rpc.Owner] (owner only)", {
+        path: z
+            .string()
+            .describe("Relative path to the script file"),
+        methodName: z.string().describe("Name for the RPC method"),
+        rpcType: z
+            .enum(["Broadcast", "Host", "Owner"])
+            .optional()
+            .describe("RPC type: Broadcast (all), Host (server), Owner (owning client). Defaults to Broadcast"),
+        methodParams: z
+            .string()
+            .optional()
+            .describe("Method parameters as C# signature (e.g. 'float damage, Vector3 hitPos')"),
+        body: z
+            .string()
+            .optional()
+            .describe("Method body code (without braces). Defaults to a log statement"),
+    }, async (params) => {
+        const res = await bridge.send("add_rpc_method", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_networked_player ───────────────────────────────────────
+    server.tool("create_networked_player", "Generate a network-aware player controller with [Sync] properties, owner-only input, and [Rpc.Broadcast] actions", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class name. Defaults to 'NetworkedPlayer'"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Subdirectory under code/"),
+        moveSpeed: z.number().optional().describe("Movement speed. Defaults to 300"),
+        includeHealth: z
+            .boolean()
+            .optional()
+            .describe("Include health/damage system with host-authoritative TakeDamage. Defaults to true"),
+    }, async (params) => {
+        const res = await bridge.send("create_networked_player", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_lobby_manager ──────────────────────────────────────────
+    server.tool("create_lobby_manager", "Generate a lobby manager script with create/join/leave lobby, player spawning, and connection cleanup", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class name. Defaults to 'LobbyManager'"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Subdirectory under code/"),
+        maxPlayers: z
+            .number()
+            .optional()
+            .describe("Default max players. Defaults to 8"),
+    }, async (params) => {
+        const res = await bridge.send("create_lobby_manager", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_network_events ─────────────────────────────────────────
+    server.tool("create_network_events", "Generate a network event handler script implementing INetworkListener for connect/disconnect/chat events", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class name. Defaults to 'NetworkEvents'"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Subdirectory under code/"),
+        includeChat: z
+            .boolean()
+            .optional()
+            .describe("Include a chat message broadcast system. Defaults to false"),
+    }, async (params) => {
+        const res = await bridge.send("create_network_events", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=networking.js.map

package/dist/tools/physics.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Physics tools: add_physics, add_collider, add_joint, raycast.
+ * Manages rigidbodies, colliders, physics constraints, and ray tracing.
+ */
+export declare function registerPhysicsTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=physics.d.ts.map