← Back to SKILL.md
Worked Example: A "Chest" Interactable
A complete walk-through showing how the brainstorming process turns into code and a documented design entry. The five planning steps (Name & root, Responsibility groups, Node types, Signal map, Reuse candidates) live in SKILL.md Section 2.
Resulting GDScript sketch
# chest.gd
class_name Chest
extends StaticBody2D
signal opened(loot: Array[ItemData])
@export var loot_table: LootTable
var _is_open: bool = false
var _player_nearby: bool = false
@onready var animation_player: AnimationPlayer = $AnimationPlayer
@onready var prompt_label: Label = $PromptLabel
@onready var interaction_area: Area2D = $InteractionArea
func _unhandled_input(event: InputEvent) -> void:
if _player_nearby and not _is_open and event.is_action_pressed("interact"):
_open()
func _open() -> void:
_is_open = true
prompt_label.hide()
animation_player.play("open")
opened.emit(loot_table.roll())
func _on_area_body_entered(body: Node2D) -> void:
if body.is_in_group("player"):
_player_nearby = true
prompt_label.show()
func _on_area_body_exited(body: Node2D) -> void:
if body.is_in_group("player"):
_player_nearby = false
prompt_label.hide()C#
// Chest.cs
using Godot;
using System.Collections.Generic;
[GlobalClass]
public partial class Chest : StaticBody2D
{
[Signal]
public delegate void OpenedEventHandler(Godot.Collections.Array<ItemData> loot);
[Export]
public LootTable LootTable { get; set; }
private bool _isOpen;
private bool _playerNearby;
private AnimationPlayer _animationPlayer;
private Label _promptLabel;
public override void _Ready()
{
_animationPlayer = GetNode<AnimationPlayer>("AnimationPlayer");
_promptLabel = GetNode<Label>("PromptLabel");
}
public override void _UnhandledInput(InputEvent @event)
{
if (_playerNearby && !_isOpen && @event.IsActionPressed("interact"))
Open();
}
private void Open()
{
_isOpen = true;
_promptLabel.Hide();
_animationPlayer.Play("open");
EmitSignal(SignalName.Opened, LootTable.Roll());
}
private void OnAreaBodyEntered(Node2D body)
{
if (body.IsInGroup("player"))
{
_playerNearby = true;
_promptLabel.Show();
}
}
private void OnAreaBodyExited(Node2D body)
{
if (body.IsInGroup("player"))
{
_playerNearby = false;
_promptLabel.Hide();
}
}
}Design Output Format
Capture your design in a comment block at the top of the root script, or in a DESIGN.md file next to the scene. A complete design entry has four parts.
Scene Tree ASCII Diagram
Chest (StaticBody2D) # root — owns all chest state
├── Sprite2D # visual: closed or open frame
├── AnimationPlayer # plays "open" animation
├── CollisionShape2D # physical body shape
├── InteractionArea (Area2D) # detects player proximity
│ └── CollisionShape2D # trigger radius
├── PromptLabel (Label) # "Press F to open"
└── LootTable (Node) # @export items: Array[ItemData]Node Responsibilities
| Node | Responsibility |
|---|---|
Chest |
Owns _is_open flag; handles interact input; emits opened |
Sprite2D |
Displays closed or open texture |
AnimationPlayer |
Plays "open" clip on first open |
InteractionArea |
Emits body_entered / body_exited to drive prompt visibility |
PromptLabel |
Shown/hidden by Chest; no logic of its own |
LootTable |
Rolls and returns Array[ItemData]; reused by other interactables |
Signal Map
| Signal | Source | Consumer | Payload |
|---|---|---|---|
body_entered |
InteractionArea |
Chest |
body: Node2D |
body_exited |
InteractionArea |
Chest |
body: Node2D |
animation_finished |
AnimationPlayer |
Chest |
anim_name: StringName |
opened |
Chest |
InventorySystem / EventBus |
loot: Array[ItemData] |
Data Flow
Player enters InteractionArea
→ body_entered fires
→ Chest shows PromptLabel
Player presses "interact"
→ Chest._unhandled_input fires
→ Chest._open() called
→ AnimationPlayer plays "open"
→ LootTable.roll() returns items
→ opened signal emits with loot array
→ InventorySystem receives loot
→ PromptLabel hidden
→ _is_open = true (prevents re-opening)