v2.0.0 to v2.0.1

---

name: godomaster

description: "GodoMaster — Godot 4.x game development intelligence: GDScript, nodes/scenes, 2D/3D rendering, physics, animation, UI, audio, input, shaders, networking, performance, export, file I/O, testing, localization, AI behavior, asset pipeline, and architecture tooling. Complete workflow for indie and professional game development based on official Godot documentation."

argument-hint: "[topic] [context]"

license: MIT

metadata:

author: yanha

---

# GodoMaster

Complete Godot 4.x game development skill: project setup, GDScript, scene architecture, 2D/3D, physics, animation, UI, audio, input, shaders, networking, performance, export, data persistence, localization, AI behavior, and asset pipeline.

## When to Use

This Skill should be used when the task involves **Godot game development** — writing GDScript, designing scenes, implementing gameplay systems, debugging, or optimizing.

### Must Use

This Skill must be invoked in the following situations:

- Creating or configuring a Godot project (renderer, settings, folder structure)

- Writing, reviewing, or debugging GDScript code

- Designing node hierarchies and scene composition

- Implementing 2D or 3D gameplay (sprites, tilemaps, meshes, cameras)

- Setting up physics (collisions, rigid bodies, raycasting)

- Creating animations (AnimationPlayer, Tween, AnimationTree)

- Building UI (menus, HUD, dialogs, themes)

- Adding audio (music, SFX, spatial audio, audio buses)

- Handling input (keyboard, mouse, gamepad, touch, remapping)

- Writing shaders (2D effects, 3D materials, post-processing)

- Implementing multiplayer/networking

- Exporting to platforms (Windows, Mac, Linux, Web, Mobile)

- Optimizing performance (profiling, draw calls, memory)

- Implementing save/load and file I/O

- Implementing localization or multi-language support (tr(), TranslationServer)

- Building AI behavior systems (state machines, behavior trees, utility AI)

- Working with the asset import pipeline (ResourceImporter, EditorImportPlugin, addons)

- Creating GDExtension modules (C++ integration, godot-cpp)

## Sub-skill Routing

| Task | Reference | Details |

|------|-----------|---------|

| New project, renderer, .gitignore | `references/01-godot-project-setup.md` | Project creation, folder structure, autoloads |

| Editor navigation, debug tools | `references/02-godot-editor-mastery.md` | Shortcuts, panels, profiler, remote tree |

| GDScript code, patterns, types | `references/03-gdscript-pro.md` | Type system, signals, movement, state machine |

| Scene tree, node types, composition | `references/04-godot-nodes-scenes.md` | Node reference, lifecycle, component pattern |

| Sprites, tilemaps, 2D lighting | `references/05-godot-2d-fundamentals.md` | AnimatedSprite, TileMapLayer, parallax, camera |

| 3D models, materials, environment | `references/06-godot-3d-fundamentals.md` | Import, PBR, lighting, sky, fog, navigation |

| Collision, physics bodies, raycast | `references/07-godot-physics.md` | CharacterBody, RigidBody, Area, joints |

| Animation, tweens, state machines | `references/08-godot-animation.md` | AnimationPlayer, Tween, AnimationTree |

| Menus, HUD, themes, layouts | `references/09-godot-ui-design.md` | Control nodes, anchors, dialog system |

| Music, SFX, audio buses | `references/10-godot-audio.md` | AudioStreamPlayer, effects, spatial audio |

| Input mapping, gamepad, touch | `references/11-godot-input-system.md` | Input actions, remapping, virtual joystick |

| Export, CI/CD, store publishing | `references/12-godot-export-deploy.md` | Platform presets, optimization, distribution |

| Profiling, FPS, draw calls | `references/13-godot-performance.md` | Monitors, batching, pooling, culling |

| Save/load, JSON, config files | `references/14-godot-file-io.md` | SaveManager, ConfigFile, encryption |

| Shaders, visual effects | `references/15-godot-shaders.md` | CanvasItem, Spatial, fog, post-processing |

| Multiplayer, RPC, sync | `references/16-godot-networking.md` | ENet, WebSocket, WebRTC, lobby, matchmaking |

| Unit tests, integration tests, CI | `references/17-godot-testing.md` | GdUnit4, mocking, scene tests, headless CLI |

| Custom Resources, @tool, plugins, GDExtension | `references/18-godot-architecture-tooling.md` | Resource-based architecture, @tool, GDExtension, EditorPlugin |

| Localization, tr(), TranslationServer | `references/19-godot-localization.md` | .po/.csv import, plural rules, pseudolocalization, RTL |

| AI, behavior trees, utility AI | `references/20-godot-ai-behavior.md` | State machines, BT pattern, navigation AI, LimboAI |

| Asset pipeline, import plugins, addons | `references/21-godot-asset-pipeline.md` | ResourceImporter, EditorImportPlugin, AssetLib distribution |

## Quick Reference

### GDScript Essentials

```gdscript

# File structure

extends CharacterBody2D

class_name Player

const SPEED := 300.0

signal health_changed(new_health: int)

@export var max_health := 100

@export_range(0, 100) var start_health := 100

@export_storage var internal_state: int = 0 # 4.4+ serialized but hidden

@onready var sprite := $Sprite2D

@onready var animation := $AnimationPlayer

var health: int

var velocity := Vector2.ZERO

func _ready() -> void:

health = start_health

func _physics_process(delta: float) -> void:

if not is_on_floor():

velocity.y += gravity * delta

if Input.is_action_just_pressed("jump") and is_on_floor():

velocity.y = jump_velocity

var direction := Input.get_axis("move_left", "move_right")

velocity.x = direction * speed

move_and_slide()

```

### Localization Quick Pattern

```gdscript

# Localization

func _ready() -> void:

label.text = tr("KEY_GREETING")

count_label.text = tr_n("1 enemy", "%d enemies", count) % count

TranslationServer.set_locale("zh_CN")

```

### AI Quick Pattern

```gdscript

# Behavior tree tick pattern

func _physics_process(delta: float) -> void:

behavior_tree.tick(self, blackboard)

# NavigationAgent avoidance (4.4+)

nav_agent.avoidance_enabled = true

nav_agent.set_velocity(desired_velocity)

```

### Scene Composition Patterns

```

Player (CharacterBody2D)

├── CollisionShape2D

├── Sprite2D / AnimatedSprite2D

├── AnimationPlayer

├── Camera2D

├── Hitbox (Area2D) → CollisionShape2D

├── Hurtbox (Area2D) → CollisionShape2D

└── AudioStreamPlayer2D

Enemy (CharacterBody2D)

├── CollisionShape2D

├── Sprite2D

├── AnimationPlayer

├── NavigationAgent2D

├── DetectionArea (Area2D) → CollisionShape2D

└── StateMachine → IdleState, ChaseState, AttackState

HUD (CanvasLayer)

├── MarginContainer

│ ├── TopBar (HBoxContainer) → ScoreLabel, TimerLabel

│ ├── HealthBar (TextureProgressBar)

│ └── BottomBar (HBoxContainer) → HotbarSlots

```

### Node Lifecycle Order

```

_init() → Object created (before tree)

_enter_tree() → Enters scene tree

_ready() → All children ready (bottom-up)

_process() → Every frame

_physics_process()→ Every physics tick

_exit_tree() → Leaves scene tree

```

### Collision Layers

```

Layer 1: Player Mask: 2,3,4

Layer 2: Walls Mask: (none)

Layer 3: Enemies Mask: 1,2

Layer 4: Pickups Mask: 1

Layer 5: Proj(PLY) Mask: 2,3

Layer 6: Proj(ENM) Mask: 1,2

```

### Common Autoloads

```

GameManager → res://scripts/core/game_manager.gd

AudioManager → res://scripts/core/audio_manager.gd

SaveManager → res://scripts/core/save_manager.gd

SignalBus → res://scripts/core/signal_bus.gd

```

### Project Folder Structure

```

project/

├── scenes/ (world/, ui/, actors/, effects/)

├── scripts/ (core/, systems/, components/, ui/)

├── resources/ (data/, themes/, materials/)

├── art/ (sprites/, tiles/, audio/, vfx/)

└── addons/

```

### Renderer Selection

| Renderer | Best For |

|----------|----------|

| **Forward+** | Desktop, high-end visuals |

| **Mobile** | Mid-range, balanced |

| **Compatibility** | Low-end, web, old hardware |

### Input Actions (configure early)

```

move_up/down/left/right → WASD + Left Stick

jump → Space / Gamepad A

attack → Left Click / Gamepad X

interact → E / Gamepad Y

pause → Escape / Start

```