@el4cteo/rbx-studio-mcp 0.6.1 → 0.6.7

package/dist/tools/anim.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+import { json, table, text, textOf } from "../lib/format.js";
+import { defineTool } from "../lib/tool.js";
+/** Downloads go to Roblox's asset servers, which are not always quick. */
+const TIMEOUT_MS = 45_000;
+export function registerAnimTools(context) {
+    const { bridge } = context;
+    defineTool(context, {
+        name: "animation",
+        title: "Read and build animations",
+        description: "Reads an animation's actual keyframes, and builds new ones that play " +
+            "immediately in the open Studio.\n\n" +
+            "Animations are the one part of a place no other tool can see. " +
+            "`inspect` on an Animation instance returns an asset id and stops there " +
+            "— the poses live on Roblox's servers. `read` downloads them, so you can " +
+            "answer 'how long is it', 'which joints does it move', and 'does it end " +
+            "where it started' without opening the Animation Editor and scrubbing.\n\n" +
+            "`read` takes an asset id, an rbxassetid:// string, or the path of an " +
+            "Animation instance in the place — whichever you already have. It reports " +
+            "which RIG the animation was made for, which is the thing most worth " +
+            "knowing: an R15 animation on an R6 character does nothing at all — no " +
+            "error, no movement — and the asset id gives no hint either way.\n\n" +
+            "`build` goes the other way: give it keyframes and it returns a content " +
+            "id you can put straight into an Animation's AnimationId. Nothing is " +
+            "uploaded and nothing is moderated — the id works in this Studio session " +
+            "and nowhere else, which makes it the right way to try an idea and the " +
+            "wrong way to ship one.\n\n" +
+            "`preview` puts an animation ONTO a rig in the open place and freezes it " +
+            "at a chosen moment, so `screenshot` can show you the pose. It works in " +
+            "edit mode — no playtest. Ask for several moments in turn to compare " +
+            "poses across the animation; the rig stays posed until `stop`.\n\n" +
+            "Poses are written the way a CFrame property is: \"0, 1, 0\" for a " +
+            "position, \"0, 1, 0 | 0, 45, 0\" to rotate as well.\n\n" +
+            "The id `build` returns is a bare hash, not an rbxassetid:// URL. Use it " +
+            "exactly as given — prefixing it stops it working.",
+        inputSchema: {
+            op: z
+                .enum(["read", "preview", "build", "stop"])
+                .default("read")
+                .describe("'read' downloads an existing animation, 'preview' poses a rig at one " +
+                "moment of it so you can screenshot it, 'build' makes a new one " +
+                "playable here, 'stop' clears a preview."),
+            assetId: z
+                .union([z.number(), z.string()])
+                .optional()
+                .describe('read only: animation asset id (12345), "rbxassetid://12345", or the ' +
+                'path of an Animation instance ("Workspace.Rig.Animate.run").'),
+            keyframes: z
+                .array(z.object({
+                time: z.number().min(0).describe("Seconds from the start of the animation."),
+                name: z.string().optional().describe('Keyframe name, e.g. "Start" or a marker name.'),
+                poses: z
+                    .record(z.string(), z.string())
+                    .optional()
+                    .describe('Joint name → CFrame, e.g. { "Right Arm": "0, 0.5, 0 | 0, 0, 45" }. ' +
+                    "Joint names must match the rig's parts."),
+            }))
+                .max(200)
+                .optional()
+                .describe("build only: the keyframes, in any order — they are sorted by time."),
+            name: z.string().optional().describe("build only: name for the sequence."),
+            root: z
+                .string()
+                .optional()
+                .describe('build only: the rig part every pose hangs from. Defaults to "HumanoidRootPart", ' +
+                "which is right for an R15 or R6 character."),
+            priority: z
+                .enum(["Idle", "Movement", "Action", "Core"])
+                .optional()
+                .describe("build only: which animations this one plays over."),
+            loop: z.boolean().optional().describe("build only: whether it repeats."),
+            rig: z
+                .string()
+                .optional()
+                .describe('The model, e.g. "Workspace.Dummy". For preview/stop it is the rig to ' +
+                "pose, and needs a Humanoid or an AnimationController inside it. For " +
+                "`build` it is optional and is read for its joint layout — pass it for " +
+                "anything that is not a standard R6 or R15 character (a custom rig, a " +
+                "weapon, a door, a Blender import), or the poses may be attached in the " +
+                "wrong order and the animation will move nothing."),
+            at: z
+                .number()
+                .min(0)
+                .optional()
+                .describe("preview only: the moment to freeze on, in seconds. Ask for several " +
+                "in turn to compare poses across the animation."),
+            hold: z
+                .boolean()
+                .default(true)
+                .describe("preview only: freeze on that frame. Turn off to let it play, but then " +
+                "a screenshot catches whatever pose it happens to be in."),
+            studioId: z.string().optional().describe("Target Studio; omit for the active one."),
+        },
+        readOnly: false,
+        destructive: false,
+    }, async (args) => {
+        if (args.op === "preview" || args.op === "stop") {
+            if (!args.rig)
+                return text("preview needs a `rig` — the model to pose.");
+            const posed = await bridge.call("anim.preview", { op: args.op, rig: args.rig, assetId: args.assetId, at: args.at, hold: args.hold }, { studioId: args.studioId, timeoutMs: TIMEOUT_MS });
+            return json(posed);
+        }
+        if (args.op === "build") {
+            if (!args.keyframes || args.keyframes.length === 0) {
+                return text("build needs a non-empty `keyframes` array.");
+            }
+            const built = await bridge.call("anim.build", {
+                keyframes: args.keyframes,
+                name: args.name,
+                root: args.root,
+                rig: args.rig,
+                priority: args.priority,
+                loop: args.loop,
+            }, { studioId: args.studioId, timeoutMs: TIMEOUT_MS });
+            return json(built, "Set this as an Animation's AnimationId with `modify`, exactly as it appears " +
+                "— it is a bare hash, and adding rbxassetid:// in front of it stops it " +
+                "working. Local to this Studio session: not uploaded, gone on restart.\n\n" +
+                "`hierarchy` says which joint layout the poses were nested against — the " +
+                "rig you named, or the R6/R15 standard guessed from the joint names. " +
+                "Anything in `unmatchedJoints` is a name that layout does not contain: " +
+                "those poses were attached to the root and will almost certainly do " +
+                "nothing. Pass `rig` to fix it.");
+        }
+        if (args.assetId === undefined) {
+            return text("read needs an `assetId` — a number, an rbxassetid:// string, or a path to an Animation.");
+        }
+        const found = await bridge.call("anim.read", { assetId: args.assetId }, { studioId: args.studioId, timeoutMs: TIMEOUT_MS });
+        /*
+         * A summary first, then the timeline. The three facts at the top are what
+         * the question was, and burying them under forty rows of keyframes would
+         * make the tool technically complete and practically unreadable.
+         */
+        const lines = [
+            `${found.name ?? found.assetId} — ${found.rig} rig, ${found.duration}s, ` +
+                `${found.keyframeCount} keyframes, ${found.jointCount} joints moved`,
+            `Priority ${found.priority}${found.looping ? ", loops" : ", does not loop"}` +
+                (found.rigNote !== undefined ? ` — ${found.rigNote}` : ""),
+            "",
+            `Joints: ${found.joints.join(", ") || "none"}` +
+                (found.jointsSampled ? ` … and ${found.jointCount - found.joints.length} more` : ""),
+        ];
+        if (found.rig === "R6" || found.rig === "R15") {
+            lines.push("", `This is an ${found.rig} animation. It will do NOTHING on an ${found.rig === "R6" ? "R15" : "R6"} character — no error, no movement, because the joint names do not exist ` +
+                "on the other rig. Check the character's rig type before using it.");
+        }
+        if (found.looping && found.endsWhereItStarted === false) {
+            lines.push("", "WARNING: this animation loops, but these joints do not end where they " +
+                `started: ${(found.driftingJoints ?? []).join(", ")}. That is what a ` +
+                "visible jump at the loop point looks like.");
+        }
+        lines.push("", textOf(table(["index", "time", "name", "poseCount"], found.keyframes, {
+            more: found.truncated
+                ? `poses expanded for the first 40 keyframes only`
+                : undefined,
+        })));
+        return text(lines.join("\n"));
+    });
+}
+//# sourceMappingURL=anim.js.map

package/dist/tools/anim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anim.js","sourceRoot":"","sources":["../../src/tools/anim.ts"],"names":[],"mappings":"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"}

package/dist/tools/audio.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+import { json } from "../lib/format.js";
+import { defineTool } from "../lib/tool.js";
+export function registerAudioTools(context) {
+    const { bridge } = context;
+    defineTool(context, {
+        name: "audio",
+        title: "Wire up Roblox's audio graph",
+        description: "Builds and inspects the modern audio API — AudioPlayer, emitters, " +
+            "effects and the Wires between them.\n\n" +
+            "Roblox's modern audio is a signal graph, not one instance with a Play " +
+            "method. An `AudioPlayer` holds the asset, an `AudioEmitter` puts the " +
+            "sound in the world or an `AudioDeviceOutput` sends it to the player's " +
+            "speakers, effects sit in between, and NOTHING is connected until a " +
+            "`Wire` joins two named pins. A place can hold a perfectly configured " +
+            "AudioPlayer with the right asset and the right volume and be " +
+            "completely silent, with no error anywhere, because the wire was never " +
+            "made. That is what this tool is for: `create` can make each instance, " +
+            "but the pin names, the direction and the choice of sink are where it " +
+            "actually goes wrong.\n\n" +
+            "`graph` is the one to reach for: it builds a whole working chain in " +
+            "one undoable step. `kind=\"world\"` gives a sound that comes from a " +
+            "part; `kind=\"ui\"` gives one with no position, for menus and music. " +
+            "Add `effects` to splice reverb, EQ or a fader into the chain.\n\n" +
+            "`wire` joins two instances you already have. `inspect` reads an " +
+            "existing graph back and reports every connection — including the ones " +
+            "that report Connected = false, which the Explorer does not show and " +
+            "which are the usual reason for silence.\n\n" +
+            "The old `Sound` instance still works and is still shorter for a plain " +
+            "one-off noise; use `create` for that. Come here when the case needs " +
+            "effects, per-listener mixing, or one emitter fed by several sources.",
+        inputSchema: {
+            op: z
+                .enum(["graph", "wire", "inspect"])
+                .default("graph")
+                .describe("'graph' builds a whole working chain, 'wire' joins two existing " +
+                "instances, 'inspect' reads a graph back."),
+            kind: z
+                .enum(["world", "ui"])
+                .optional()
+                .describe("graph only: 'world' is a sound heard from a place — it needs a " +
+                "part to come from. 'ui' has no position: menu clicks, music. " +
+                "Defaults to 'world'."),
+            parent: z
+                .string()
+                .optional()
+                .describe('graph only: where the graph goes. For kind="world" this is the ' +
+                "part or attachment the sound comes from."),
+            asset: z
+                .string()
+                .optional()
+                .describe('graph only: the audio id, e.g. "rbxassetid://1234". Find one with ' +
+                '`assets op="search" kind="audio"`. Leave it out to build the ' +
+                "chain now and set the asset later."),
+            name: z.string().optional().describe("graph only: name for the AudioPlayer."),
+            effects: z
+                .array(z.string())
+                .optional()
+                .describe("graph only: effect classes to splice between the player and the " +
+                'output, in order, e.g. ["AudioFader", "AudioReverb"]. Also ' +
+                "accepts AudioEqualizer, AudioCompressor, AudioEcho, " +
+                "AudioDistortion, AudioPitchShifter, AudioChorus, AudioFlanger " +
+                "and AudioLimiter."),
+            from: z.string().optional().describe("wire only: the instance sound comes OUT of."),
+            to: z.string().optional().describe("wire only: the instance sound goes INTO."),
+            fromPin: z
+                .string()
+                .optional()
+                .describe('wire only: the source\'s output pin. Defaults to "Output", which ' +
+                "is right for everything but a channel splitter."),
+            toPin: z
+                .string()
+                .optional()
+                .describe('wire only: the target\'s input pin. Defaults to "Input". A wrong ' +
+                "pin name is accepted by the engine and produces silence, so the " +
+                "name is checked against the instance before the wire is made."),
+            path: z
+                .string()
+                .optional()
+                .describe("inspect only: where to look. Omit to walk the whole place, which " +
+                "is the right call when tracking down silence of unknown origin."),
+            studioId: z.string().optional().describe("Target Studio; omit for the active one."),
+        },
+    }, async (args) => {
+        const { op, studioId, ...rest } = args;
+        const response = await bridge.call(op === "wire" ? "audio.wire" : op === "inspect" ? "audio.inspect" : "audio.graph", rest, { studioId, timeoutMs: 30_000 });
+        if (op === "graph") {
+            return json(response, "Nothing plays on its own — call `AudioPlayer:Play()` from a script, " +
+                "or set `Playing` with `modify`. Check the result's `note` and " +
+                "`warnings` first: they are the difference between a graph that is " +
+                "wired and one that is audible.");
+        }
+        return json(response);
+    });
+}
+//# sourceMappingURL=audio.js.map

package/dist/tools/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/tools/audio.ts"],"names":[],"mappings":"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"}

package/dist/tools/character.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { json } from "../lib/format.js";
+import { json, table, text, textOf } from "../lib/format.js";
 import { defineTool } from "../lib/tool.js";
 export function registerCharacterTools(context) {
     const { bridge } = context;
@@ -33,8 +33,9 @@ export function registerCharacterTools(context) {
             "use `playtest op=play`.",
         inputSchema: {
             op: z
-                .enum(["moveTo", "act", "state"])
-                .describe("'moveTo' walks somewhere, 'act' performs an action, 'state' only reports."),
+                .enum(["moveTo", "path", "act", "state"])
+                .describe("'moveTo' walks somewhere, 'path' checks a route without walking it, " +
+                "'act' performs an action, 'state' only reports."),
             to: z
                 .string()
                 .optional()
@@ -43,6 +44,46 @@ export function registerCharacterTools(context) {
                 .string()
                 .optional()
                 .describe("moveTo only: walk to this instance instead of a coordinate."),
+            from: z
+                .string()
+                .optional()
+                .describe('path only: where the route starts, e.g. "0, 5, 0". Defaults to the character.'),
+            fromPath: z
+                .string()
+                .optional()
+                .describe('path only: an instance to start from, e.g. "Workspace.SpawnLocation".'),
+            toPath: z
+                .string()
+                .optional()
+                .describe("path only: an instance to end at instead of `to`."),
+            agentRadius: z
+                .number()
+                .min(0.1)
+                .max(50)
+                .optional()
+                .describe("How wide the walker is, in studs. Defaults to 2 — a standard " +
+                "character. Raise it to ask whether a bigger NPC fits through the " +
+                "same gaps a player does."),
+            agentHeight: z
+                .number()
+                .min(0.1)
+                .max(100)
+                .optional()
+                .describe("How tall the walker is. Defaults to 5, a standard character."),
+            canClimb: z.boolean().optional().describe("Whether it may climb truss. Off by default."),
+            spacing: z
+                .number()
+                .min(0.1)
+                .max(100)
+                .optional()
+                .describe("Studs between waypoints, default 4. Tighter follows the geometry more " +
+                "closely; wider is a coarser route."),
+            costs: z
+                .record(z.string(), z.number())
+                .optional()
+                .describe('Material or PathfindingModifier label → cost, e.g. { "Water": 20 } to ' +
+                "avoid swimming. Higher is more avoided; the route chosen is the " +
+                "cheapest total, not the shortest."),
             direct: z
                 .boolean()
                 .default(false)
@@ -69,15 +110,64 @@ export function registerCharacterTools(context) {
         },
         destructive: false,
     }, async (args) => {
+        /*
+         * Agent shape travels with both ops, from one place, so a route `path`
+         * reports as walkable is a route `moveTo` walks with the same body.
+         */
+        const agent = {
+            agentRadius: args.agentRadius,
+            agentHeight: args.agentHeight,
+            canJump: args.canJump,
+            canClimb: args.canClimb,
+            spacing: args.spacing,
+            costs: args.costs,
+        };
+        if (args.op === "path") {
+            const route = await bridge.call("character.path", { from: args.from, fromPath: args.fromPath, to: args.to, toPath: args.toPath, ...agent }, { studioId: args.studioId, timeoutMs: 30_000 });
+            if (!route.reachable) {
+                return text(`No route: ${route.status}.\n` +
+                    `${route.from} → ${route.to} is ${route.straightLineDistance} studs apart in a ` +
+                    `straight line, but nothing walkable connects them for an agent this size.\n\n` +
+                    route.hint);
+            }
+            const lines = [
+                `Reachable — ${route.pathDistance} studs walked vs ${route.straightLineDistance} ` +
+                    `straight (detour ${route.detour}x), ${route.waypointCount} waypoints, ${route.jumps} jump(s).`,
+            ];
+            if (route.detour > 2) {
+                lines.push("", `That is a long way round for the distance. Something between the two points ` +
+                    "is forcing a detour — worth a look if it was meant to be a direct route.");
+            }
+            if (route.jumps > 0) {
+                lines.push("", `${route.jumps} jump(s) on this route. Anything that cannot jump — a vehicle, ` +
+                    "an NPC with jumping disabled — cannot follow it.");
+            }
+            lines.push("", textOf(table(["index", "action", "position", "label"], route.waypoints, { more: "walking waypoints between these are omitted" })));
+            return text(lines.join("\n"));
+        }
         if (args.op === "moveTo") {
-            const response = await bridge.call("character.moveTo", { to: args.to, path: args.path, direct: args.direct, canJump: args.canJump, player: args.player }, 
+            const response = await bridge.call("character.moveTo", { to: args.to, path: args.path, direct: args.direct, player: args.player, ...agent }, 
             // Walking a long route is genuinely slow, and the handler waits for
             // each waypoint rather than returning before it arrives.
             { studioId: args.studioId, timeoutMs: 60_000 });
             const notes = [];
             if (response.note)
                 notes.push(response.note);
-            if (!response.arrived && response.pathStatus === "Enum.PathStatus.Success") {
+            /*
+             * Only add the vague advice when the handler could not name a cause.
+             * With `blockedBy` set it already said which instance is in the way,
+             * and following that with "something is in the way" reads as if the
+             * tool did not know — which it did.
+             */
+            /*
+             * Only when the handler said nothing itself. It already explains what
+             * happened in `note`, and appending "something is physically in the
+             * way" after "nothing was in the ray's way" contradicts it in the same
+             * breath.
+             */
+            if (!response.arrived &&
+                response.note === undefined &&
+                response.pathStatus === "Enum.PathStatus.Success") {
                 notes.push("The path was valid but the character did not reach the end — something " +
                     "is physically in the way, or it fell. Take a `screenshot` to see where it stopped.");
             }

package/dist/tools/character.js.map

@@ -1 +1 @@
-{"version":3,"file":"character.js","sourceRoot":"","sources":["../../src/tools/character.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"character.js","sourceRoot":"","sources":["../../src/tools/character.ts"],"names":[],"mappings":"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"}