create-scene

Create a Scene

Templates available. Pass <template> <name> (e.g. 2d-player Player, 3d-character Hero, main-menu MainMenu).

If no template matches, fall back to manual scaffolding using the principles in godot-patterns.

Templates

2d-player — CharacterBody2D player

{Name} (CharacterBody2D)
├── Sprite2D (or AnimatedSprite2D)
├── CollisionShape2D
├── Hurtbox (Area2D)            -> takes damage; layer: PlayerHurtbox
│   └── CollisionShape2D
├── Hitbox (Area2D)             -> deals damage; layer: PlayerHitbox
│   └── CollisionShape2D
├── HealthComponent (Node)
├── StateMachine (Node)
│   ├── Idle (Node)
│   ├── Run (Node)
│   ├── Jump (Node)
│   └── Fall (Node)
├── Camera2D (optional, for player-following)
└── AnimationPlayer

Script: extends CharacterBody2D, class_name Player. Connect Hurtbox.area_entered and forward to HealthComponent.take_damage. Use setup-collision-layers skill for the layer config.

The Player scene re-emits HealthComponent's signals so coordinators can connect on the root node instead of digging into children:

class_name Player
extends CharacterBody2D

signal health_changed(old: float, new: float)
signal died

@onready var _health: HealthComponent = $HealthComponent

func _ready() -> void:
    _health.health_changed.connect(func(old, new): health_changed.emit(old, new))
    _health.died.connect(func(): died.emit())

3d-character — CharacterBody3D player or NPC

{Name} (CharacterBody3D)
├── MeshInstance3D (or Skeleton3D for rigged)
├── CollisionShape3D
├── Hurtbox (Area3D)
│   └── CollisionShape3D
├── HealthComponent (Node)
├── StateMachine (Node)
├── CameraPivot (Node3D)         -> rotated by input
│   └── SpringArm3D              -> collision-aware camera arm
│       └── Camera3D
├── AnimationPlayer / AnimationTree
└── NavigationAgent3D (NPCs only)

Script: set velocity, call move_and_slide(). Camera: rotate CameraPivot from mouse/stick.