# 获取子节点
@onready var sprite = $Sprite2D
@onready var collision = $CollisionShape2D
# 通过路径获取节点
var player = get_node("/root/Main/Player")
# 按类型查找节点
var camera = get_tree().get_first_node_in_group("camera")
Area3D, CharacterBody3D, RigidBody3D, StaticBody3D: 3D physics bodies
Common Nodes:
Timer: Execute code after a delay
AudioStreamPlayer: Play sounds
AnimationPlayer: Control complex animations
Godot MCP Tools
You have access to specialized Godot MCP tools:
mcp__godot__launch_editor: Open Godot editor for a project
mcp__godot__run_project: Run the game project
mcp__godot__get_debug_output: Get console output and errors
mcp__godot__stop_project: Stop running project
mcp__godot__get_godot_version: Check Godot version
mcp__godot__list_projects: Find Godot projects in a directory
mcp__godot__get_project_info: Get project metadata
mcp__godot__create_scene: Create a new .tscn scene file
mcp__godot__add_node: Add nodes to existing scenes
Project Structure Best Practices
project/
├── project.godot # Project configuration
├── scenes/ # All scene files
│ ├── main/ # Main game scenes
│ ├── ui/ # UI scenes
│ ├── characters/ # Character scenes
│ └── levels/ # Level scenes
├── scripts/ # GDScript files
│ ├── autoload/ # Singleton scripts
│ ├── characters/ # Character scripts
│ └── systems/ # Game systems
├── assets/ # Art, audio, etc.
│ ├── sprites/
│ ├── audio/
│ ├── fonts/
│ └── shaders/
└── resources/ # .tres resource files
├── materials/
└── animations/
GDScript Patterns
Node References:
# Get child node
@onready var sprite = $Sprite2D
@onready var collision = $CollisionShape2D
# Get node by path
var player = get_node("/root/Main/Player")
# Find node by type
var camera = get_tree().get_first_node_in_group("camera")
Common Lifecycle Methods:
func _ready():
# Called when node enters scene tree
pass
func _process(delta):
# Called every frame
pass
func _physics_process(delta):
# Called every physics frame (fixed timestep)
pass
Common Tasks
Creating a Basic 2D Character:
Create scene with CharacterBody2D root
Add Sprite2D child for visuals
Add CollisionShape2D child for physics
Attach script to root node
Implement movement in _physics_process
Setting Up Camera:
2D: Add Camera2D, enable "Current"
3D: Add Camera3D, adjust position and rotation
Use smoothing for better feel
Input Handling:
func _input(event):
if event.is_action_pressed("jump"):
jump()
func _process(delta):
var direction = Input.get_axis("left", "right")
When to Use This Skill
Activate when the user:
Asks about Godot features or capabilities
Needs help creating or modifying scenes
Wants to add nodes or configure properties
Has questions about GDScript
Needs project structure advice
Encounters Godot-specific errors
Asks about best practices for game development in Godot
Use the MCP tools proactively to accomplish tasks rather than just explaining how to do them manually.
