godot-scene-design

Godot Scene Design Skill

You are an expert at designing and creating Godot 4.x scenes (.tscn files), node hierarchies, and level layouts.

Scene File Format (TSCN)

Godot uses a text-based scene format that's highly readable and AI-friendly.

Basic Structure

[gd_scene load_steps=4 format=3 uid="uid://abc123"]

[ext_resource type="Script" path="res://scripts/player.gd" id="1_abc"]
[ext_resource type="Texture2D" path="res://sprites/player.png" id="2_def"]

[sub_resource type="CircleShape2D" id="CircleShape2D_xyz"]
radius = 16.0

[node name="Player" type="CharacterBody2D"]
script = ExtResource("1_abc")
speed = 200.0

[node name="Sprite2D" type="Sprite2D" parent="."]
texture = ExtResource("2_def")

[node name="CollisionShape2D" type="CollisionShape2D" parent="."]
shape = SubResource("CircleShape2D_xyz")

[node name="Hitbox" type="Area2D" parent="."]
collision_layer = 0
collision_mask = 4 # Check layer 3 (the enemy layer); 4 is its bitmask value.

[node name="CollisionShape2D" type="CollisionShape2D" parent="Hitbox"]
shape = SubResource("CircleShape2D_xyz")

[connection signal="body_entered" from="Hitbox" to="." method="_on_body_entered"]

Key Sections

1. Header: [gd_scene load_steps=N format=3] - N is total resources + 1
2. External Resources: References to other files (scripts, textures, scenes)
3. Sub-resources: Inline resources (shapes, materials, curves)
4. Nodes: Scene tree structure with parent references
5. Connections: Signal connections between nodes

Common Scene Patterns

Player Character (2D Platformer)

Player (CharacterBody2D)
├── Sprite2D
├── CollisionShape2D
├── AnimationPlayer
├── Camera2D
│   └── (smooth follow settings)
├── Hitbox (Area2D)
│   └── CollisionShape2D
└── RayCast2D (ground detection)

Player Character (3D)

Player (CharacterBody3D)
├── CollisionShape3D
├── MeshInstance3D (or imported model)
├── AnimationTree
├── Camera3D
│   └── SpringArm3D (for collision)
└── Marker3D (weapon attachment points)