server-deploy/windows-dev-stack/godot-mcp-pro-v1.14.1/server/build/tools/animation-tree-tools.js

import { z } from "zod";
import { formatErrorForMcp } from "../utils/errors.js";
export function registerAnimationTreeTools(server, godot) {
    server.tool("create_animation_tree", "Create an AnimationTree node with an AnimationNodeStateMachine as root, optionally linked to an AnimationPlayer", {
        node_path: z.string().describe("Path to the parent node where the AnimationTree will be added"),
        anim_player: z.string().optional().describe("Relative path from the AnimationTree to the AnimationPlayer (e.g. '../AnimationPlayer')"),
        name: z.string().optional().describe("Name for the AnimationTree node (default: 'AnimationTree')"),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("create_animation_tree", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("get_animation_tree_structure", "Read the full structure of an AnimationTree including all states, transitions, and blend tree nodes", {
        node_path: z.string().describe("Path to the AnimationTree node"),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("get_animation_tree_structure", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("add_state_machine_state", "Add a state to an AnimationNodeStateMachine (animation clip, blend tree, or nested state machine)", {
        node_path: z.string().describe("Path to the AnimationTree node"),
        state_name: z.string().describe("Name for the new state"),
        state_type: z.enum(["animation", "blend_tree", "state_machine"]).optional().describe("Type of state: 'animation' (default), 'blend_tree', or 'state_machine'"),
        animation: z.string().optional().describe("Animation name to play (only for state_type='animation')"),
        state_machine_path: z.string().optional().describe("Slash-separated path to a nested state machine (e.g. 'Run/SubState'). Empty or omit for root."),
        position_x: z.number().optional().describe("X position in the graph editor (default: 0)"),
        position_y: z.number().optional().describe("Y position in the graph editor (default: 0)"),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("add_state_machine_state", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("remove_state_machine_state", "Remove a state from an AnimationNodeStateMachine (also removes connected transitions)", {
        node_path: z.string().describe("Path to the AnimationTree node"),
        state_name: z.string().describe("Name of the state to remove"),
        state_machine_path: z.string().optional().describe("Slash-separated path to a nested state machine. Empty or omit for root."),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("remove_state_machine_state", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("add_state_machine_transition", "Add a transition between two states in an AnimationNodeStateMachine with configurable switch mode, advance mode, and expression conditions", {
        node_path: z.string().describe("Path to the AnimationTree node"),
        from_state: z.string().describe("Source state name (use 'Start' for the entry point)"),
        to_state: z.string().describe("Destination state name (use 'End' for the exit point)"),
        switch_mode: z.enum(["at_end", "immediate", "sync"]).optional().describe("When to switch: 'at_end' (wait for animation), 'immediate' (default), 'sync'"),
        advance_mode: z.enum(["disabled", "enabled", "auto"]).optional().describe("How to advance: 'disabled', 'enabled' (default, uses travel), 'auto' (automatic)"),
        advance_expression: z.string().optional().describe("GDScript expression that triggers this transition (e.g. 'is_running')"),
        xfade_time: z.number().optional().describe("Cross-fade time in seconds"),
        state_machine_path: z.string().optional().describe("Slash-separated path to a nested state machine. Empty or omit for root."),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("add_state_machine_transition", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("remove_state_machine_transition", "Remove a transition between two states in an AnimationNodeStateMachine", {
        node_path: z.string().describe("Path to the AnimationTree node"),
        from_state: z.string().describe("Source state name"),
        to_state: z.string().describe("Destination state name"),
        state_machine_path: z.string().optional().describe("Slash-separated path to a nested state machine. Empty or omit for root."),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("remove_state_machine_transition", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("set_blend_tree_node", "Add or replace a node inside an AnimationNodeBlendTree state (Add2, Blend2, TimeScale, Animation, etc.) with optional connection", {
        node_path: z.string().describe("Path to the AnimationTree node"),
        blend_tree_state: z.string().describe("Name of the BlendTree state in the state machine"),
        bt_node_name: z.string().describe("Name for the node inside the BlendTree"),
        bt_node_type: z.enum(["Animation", "Add2", "Blend2", "Add3", "Blend3", "TimeScale", "TimeSeek", "Transition", "OneShot", "Sub2"]).describe("Type of BlendTree node to create"),
        animation: z.string().optional().describe("Animation name (only for bt_node_type='Animation')"),
        connect_to: z.string().optional().describe("Name of another BlendTree node to connect this node's output to"),
        connect_port: z.number().optional().describe("Input port index on the target node (default: 0)"),
        state_machine_path: z.string().optional().describe("Slash-separated path to a nested state machine. Empty or omit for root."),
        position_x: z.number().optional().describe("X position in the graph editor (default: 0)"),
        position_y: z.number().optional().describe("Y position in the graph editor (default: 0)"),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("set_blend_tree_node", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
    server.tool("set_tree_parameter", "Set an AnimationTree parameter value (conditions, blend amounts, time scale, etc.)", {
        node_path: z.string().describe("Path to the AnimationTree node"),
        parameter: z.string().describe("Parameter path (e.g. 'conditions/is_running', 'Blend2/blend_amount'). 'parameters/' prefix is auto-added if missing."),
        value: z.union([z.string(), z.number(), z.boolean()]).describe("Parameter value. Strings are auto-parsed for Vector2, Color, etc."),
    }, async (params) => {
        try {
            const result = await godot.sendCommand("set_tree_parameter", params);
            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
        }
        catch (e) {
            return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
        }
    });
}
//# sourceMappingURL=animation-tree-tools.js.map