io.github.HaD0Yun/gopeak

Add a state to an AnimationTree state machine

Adds a property or method track to an animation. Prerequisite: animation must exist (use create_animation first). Use to animate position, rotation, color, or call methods at specific times. Keyframes define values over time.

Registers a script/scene as an autoload singleton. Use for global managers (GameManager, AudioManager, etc.). Loads automatically on game start.

Registers a new input action in project.godot InputMap. Use to set up keyboard, mouse, or gamepad controls for player actions like jump, move, attack.

Adds ANY node type to an existing scene. This is the universal node creation tool — replaces all specialized create_* node tools. Supports ALL ClassDB node types (Camera3D, DirectionalLight3D, AudioStreamPlayer, HTTPRequest, RayCast3D, etc.). Set any property via the properties parameter with type conversion support (Vector2, Vector3, Color, etc.). Use query_classes to discover available node types. Use query_class_info to discover available properties for a type.

Generate and apply theme-appropriate shader to a material in a scene

Call a method on a node in a running Godot instance

Capture a screenshot of the running Godot game viewport. Requires the runtime addon to be active (game must be running with the MCP runtime autoload).

Capture a viewport texture as base64 image from the running Godot game. Similar to capture_screenshot but captures a specific viewport by path.

Connect two states with a transition

Creates a signal connection between nodes in a scene. Prerequisite: source and target nodes must exist. Use to wire up button clicks, collision events, custom signals. Saved to scene file.

Creates a new animation in an AnimationPlayer. Prerequisite: AnimationPlayer node must exist in scene (use add_node first). Use to set up character animations, UI transitions, or cutscenes. Supports loop modes: none, linear, pingpong.

Create an AnimationTree node linked to an AnimationPlayer

Creates a new audio bus for mixing. Use to set up separate volume controls for music, SFX, voice, etc.

Creates a material resource for 3D/2D rendering. Types: StandardMaterial3D (PBR), ShaderMaterial (custom), CanvasItemMaterial (2D), ParticleProcessMaterial (particles).

Creates a NavigationAgent for AI pathfinding. Use for enemies, NPCs that need to navigate around obstacles.

Creates a NavigationRegion for pathfinding. Use to define walkable areas for AI navigation.

Creates ANY resource type as a .tres file. This is the universal resource creation tool — replaces all specialized create_* resource tools (PhysicsMaterial, Environment, Theme, etc.). Supports ALL ClassDB resource types. Set any property via the properties parameter with type conversion support. Use query_classes with category "resource" to discover available resource types. Use query_class_info to discover available properties.

Creates a new Godot scene file (.tscn) with a specified root node type. Use to start building new game levels, UI screens, or reusable components. The scene is saved automatically after creation.

Creates a new GDScript (.gd) file with optional templates. Use to generate scripts for game logic. Templates: "singleton" (autoload), "state_machine" (FSM), "component" (modular), "resource" (custom Resource).

Creates a shader file (.gdshader) with optional templates. Types: canvas_item (2D), spatial (3D), particles, sky, fog. Templates: basic, color_shift, outline.

Creates a TileSet resource from texture atlases. Use for 2D tilemaps in platformers, RPGs, etc. Supports multiple atlas sources.

Continue execution after a breakpoint or pause

Get captured Godot DAP console output lines

Get the current stack trace from the Godot debugger

Pause execution of the running Godot debug target

Remove a breakpoint in a Godot script at a specific line

Set a breakpoint in a Godot script at a specific line

Step over the current line in the debugger

Removes a node and all its children from a scene. Use to clean up unused nodes. Cannot delete root node. Scene is saved automatically unless saveScene=false.

Disables a plugin in the project. Updates project.godot automatically. Plugin files remain in addons/ folder.

Removes a signal connection from a scene. Use to clean up unused connections or rewire logic.

Creates a copy of a node with all its properties and children. Use to replicate enemies, UI elements, or any repeated structures. Scene is saved automatically unless saveScene=false.

Enables a plugin from addons/ folder. Updates project.godot automatically. Use list_plugins first to see available plugins.

Exports the project to a distributable format. Use to build final game executables. Requires export templates installed.

Download a CC0 asset from any supported source (Poly Haven, AmbientCG, Kenney) to your Godot project.

Finds all files that reference a resource. Use before deleting or renaming to avoid breaking references.

Lists all audio buses and their configuration. Use to check current audio setup.

Retrieves console output and errors from the currently running Godot project. Use after run_project to check logs, errors, and print statements. Returns empty if no project is running.

Analyzes resource dependencies and detects circular references. Use to understand what a scene/script depends on before refactoring.

Returns the installed Godot engine version string. Use to check compatibility (e.g., Godot 4.4+ features like UID). Returns version like "4.3.stable" or "4.4.dev".

Returns current import settings for a resource. Use to check compression, mipmaps, filter settings before modifying.

Returns import status for project resources. Use to find outdated or failed imports. Shows which resources need reimporting.

Returns all properties of a specific node in a scene. Use to inspect current values before modifying. Returns property names, values, and types.

Generates a health report with scoring for project quality. Checks for unused resources, script errors, missing references, etc.

Returns metadata about a Godot project including name, version, main scene, autoloads, and directory structure. Use to understand project before modifying. Requires valid project.godot.

Reads a value from project.godot settings. Use to check game name, window size, physics settings, etc.

Get performance metrics from a running Godot instance

Checks if a Godot game instance is running and connected for live debugging. Use before other runtime tools.

Analyzes a GDScript and returns its structure: functions, variables, signals, class_name, extends. Use before modify_script to understand existing code.