Three gdscript-refactor agents in parallel + Opus integration.
Entities (scenes/entities/, Agent A — 3 scripts + 3 .tscn, ~460 lines):
- item.gd: 16-type StringName registry (matches design.md filter chips);
Node2D + _draw() colored square + stack-count badge; to_dict/from_dict
- tree.gd: class_name HarvestableTree (Godot 4 ships a built-in 'Tree'
Control class — renamed to avoid the shadow); CHOP_TICKS=80; on_chop_tick
advances progress, fells when complete, drops 3 wood items at tile +
walkable neighbours
- rock.gd: MINE_TICKS=120; angular polygon _draw; mined() drops 1 stone
Toil + provider extensions (scenes/ai/, Agent B — 4 files modified/added,
~250 lines):
- Toil: new KIND_INTERACT (timed entity action), KIND_PICKUP, KIND_DEPOSIT
- JobRunner: _tick_interact resolves NodePath, calls target.<method>()
each tick, marks done when is_choppable/is_mineable returns false;
_tick_pickup finds Item at pawn.tile, transfers to pawn.carried_item;
_tick_deposit places carried_item at pawn.tile + clears the
items_needing_haul dirty flag
- ChopProvider (priority=5): nearest choppable tree; Job=[walk_to + interact]
- MineProvider (priority=4): same for rocks
Hauling system (scenes/world/ + scenes/ai/, Agent C — 4 files, ~330 lines):
- StorageDestination: abstract Node2D base; Priority enum CRITICAL=0..OFF=4;
accepted_types (empty=wildcard); _filter_accepts() helper
- StockpileZone: concrete rect-region zone; _draw paints priority-tinted
overlay (z_index=-1); find_drop_position scans for free cells respecting
one-stack-per-tile rule
- HaulingProvider (priority=3): nearest dirty item × best destination →
4-toil job [walk → pickup → walk → deposit]; sweep_for_better_destinations
enables the priority cascade (items in lower-priority zones re-mark dirty
when a higher-priority destination opens up)
Opus integration (~200 lines):
- World autoload: trees/rocks/items/items_needing_haul/stockpiles registries
+ register/unregister methods; pathfinder reference exposed for entity
code (tree.fell needs is_walkable for neighbour drops)
- Pawn: carried_item slot + carry-indicator (small colored rect upper-right
of body) via queue_redraw in _on_sim_tick
- World scene: registers chop/mine/haul/rest providers; spawns 6 trees
(cluster east-north), 4 rocks (south-east), 2 stockpile zones (Zone A
wood-only NORMAL, Zone B wildcard HIGH); periodic
hauling_provider.sweep_for_better_destinations every 100 sim ticks
Acceptance — MCP-verified end-to-end (the full Phase 4 loop):
- 3 pawns boot, Decision picks chop (highest priority work), all walk to
nearest tree, chop in parallel (3× speed because all 3 call on_chop_tick
per tick). Trees fell, drop wood (18 items). Pawns move to rocks, mine,
drop stone (4 items). Total 22 items spawn.
- HaulingProvider routes wood + stone toward Zone B (wildcard HIGH > Zone
A's wood-only NORMAL). Pawns carry items one at a time, visual indicator
shows during transit. Items deposit, items_needing_haul dirty flag
clears.
- **Priority cascade test:** Zone A promoted from NORMAL to CRITICAL.
Manually-triggered sweep marks 3 wood items in Zone B for re-haul.
Within a few thousand ticks: Zone A has 5 wood (cascaded from Zone B),
Zone B has 4 stone only (wood left, stone stayed because Zone A rejects
stone). Filter + priority cascade working exactly per design.md spec.
Phase 4 gotchas (logged in implementation.md):
- 'Tree' shadows Godot 4's built-in Tree Control class — class_name had to
be renamed to HarvestableTree. Scene/file names stayed as 'tree' since
the game concept is still 'tree'; the rename only affects code-side
type references.
- draw_colored_polygon(points, color) takes a SINGLE Color, not a
PackedColorArray. Agent C had to be reminded; draw_polygon(points, colors)
is the variant that takes per-vertex colors.
- Godot's class-name cache lags behind file changes — a full editor scan
('godot --headless --editor --quit') is needed to flush. Even after
reload_project, type-annotation assignments can fail; duck-typed
variables ('var x = scene.instantiate()') sidestep the issue.
- JobRunner's _tick_deposit had to explicitly call
World.clear_item_haul_flag — the dirty set persisted otherwise and
items appeared 'needing haul' even after deposit.
Delegation report this phase:
- Agent A (Sonnet, gdscript-refactor): Tree + Rock + Item entities + i18n
keys. ~460 lines.
- Agent B (Sonnet, gdscript-refactor): Toil extensions + JobRunner handlers
+ ChopProvider + MineProvider. ~250 lines.
- Agent C (Sonnet, gdscript-refactor): StorageDestination + StockpileZone
+ HaulingProvider with cascade sweep. ~330 lines.
- Opus: World autoload extensions (entity registries + pathfinder ref),
Pawn carry slot + visual, world.tscn/gd wiring, the Tree rename, the
draw_colored_polygon fix, the dirty-set-clear fix, MCP-driven runtime
verification including the full chop-mine-haul loop and the priority
cascade demo.
~75% of Phase 4's GDScript was subagent-authored.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
251 lines
9.5 KiB
GDScript
251 lines
9.5 KiB
GDScript
extends Node2D
|
||
## Phase 4 world view. 80×80 TileMap, 6 layers, 3 pawns, full AI pipeline:
|
||
## RestProvider → ChopProvider → MineProvider → HaulingProvider → idle
|
||
## plus sample trees, rocks, and two stockpile zones with different priorities
|
||
## for the haul-cascade demo.
|
||
##
|
||
## TileMap layer indices follow docs/architecture.md:
|
||
## 0 Terrain · 1 Floor · 2 Wall · 3 Designation · 4 Roof · 5 Fog
|
||
|
||
const MAP_SIZE_TILES: Vector2i = Vector2i(80, 80)
|
||
const TILE_SIZE_PX: int = 16
|
||
|
||
const TILE_GRASS: Vector2i = Vector2i(0, 0)
|
||
const TILE_DIRT: Vector2i = Vector2i(1, 0)
|
||
const TILE_STONE: Vector2i = Vector2i(2, 0)
|
||
const TILE_STONE_DARK: Vector2i = Vector2i(3, 0)
|
||
|
||
const PLACEHOLDER_SOURCE_ID: int = 0
|
||
|
||
const PAWN_SCENE: PackedScene = preload("res://scenes/pawn/pawn.tscn")
|
||
const TREE_SCENE: PackedScene = preload("res://scenes/entities/tree.tscn")
|
||
const ROCK_SCENE: PackedScene = preload("res://scenes/entities/rock.tscn")
|
||
const STOCKPILE_SCENE: PackedScene = preload("res://scenes/world/stockpile_zone.tscn")
|
||
|
||
# 3 starting pawns — Phase 2 demo. Phase 7+ replaces this with map-gen + name table.
|
||
const SAMPLE_PAWNS: Array[Dictionary] = [
|
||
{"name": "Bram", "tile": Vector2i(20, 40)},
|
||
{"name": "Cora", "tile": Vector2i(25, 40)},
|
||
{"name": "Edda", "tile": Vector2i(30, 40)},
|
||
]
|
||
|
||
# Phase 4 — sample harvestables. Trees clustered east, rocks south-east.
|
||
const SAMPLE_TREES: Array[Vector2i] = [
|
||
Vector2i(58, 30), Vector2i(60, 31), Vector2i(62, 30),
|
||
Vector2i(61, 33), Vector2i(63, 34), Vector2i(59, 35),
|
||
]
|
||
const SAMPLE_ROCKS: Array[Vector2i] = [
|
||
Vector2i(60, 60), Vector2i(62, 60), Vector2i(63, 62), Vector2i(58, 62),
|
||
]
|
||
|
||
# HaulingProvider re-flow cadence — every 5 sim seconds at 1× (100 ticks).
|
||
const HAUL_SWEEP_INTERVAL_TICKS: int = 100
|
||
|
||
@onready var terrain_layer: TileMapLayer = $Terrain
|
||
@onready var floor_layer: TileMapLayer = $Floor
|
||
@onready var wall_layer: TileMapLayer = $Wall
|
||
@onready var designation_layer: TileMapLayer = $Designation
|
||
@onready var roof_layer: TileMapLayer = $Roof
|
||
@onready var fog_layer: TileMapLayer = $Fog
|
||
@onready var pathfinder: Pathfinder = $Pathfinder
|
||
@onready var selection: Selection = $Selection
|
||
@onready var rest_provider: RestProvider = $RestProvider
|
||
@onready var chop_provider: ChopProvider = $ChopProvider
|
||
@onready var mine_provider: MineProvider = $MineProvider
|
||
@onready var hauling_provider: HaulingProvider = $HaulingProvider
|
||
|
||
|
||
func _ready() -> void:
|
||
Audit.log("world", "Phase 4 — building %d×%d world + harvestables + AI." % [MAP_SIZE_TILES.x, MAP_SIZE_TILES.y])
|
||
var tileset := _build_placeholder_tileset()
|
||
for layer in [terrain_layer, floor_layer, wall_layer, designation_layer, roof_layer, fog_layer]:
|
||
layer.tile_set = tileset
|
||
_paint_terrain()
|
||
_paint_sample_walls()
|
||
_apply_camera_bounds()
|
||
|
||
pathfinder.setup(MAP_SIZE_TILES)
|
||
_wire_walls_to_pathfinder()
|
||
selection.bind(pathfinder)
|
||
World.pathfinder = pathfinder # expose to entities (Tree.fell() walkability checks, etc.)
|
||
|
||
# Register all 4 providers — Decision iterates by .priority desc.
|
||
# chop=5 > mine=4 > haul=3 > rest=0.
|
||
World.register_work_provider(chop_provider)
|
||
World.register_work_provider(mine_provider)
|
||
World.register_work_provider(hauling_provider)
|
||
World.register_work_provider(rest_provider)
|
||
|
||
_spawn_sample_pawns()
|
||
_spawn_sample_harvestables()
|
||
_spawn_sample_stockpiles()
|
||
_run_pathfinder_spike()
|
||
|
||
# Phase 4: every 5 in-game seconds (100 ticks), re-evaluate items in
|
||
# stockpiles in case a higher-priority destination opened up.
|
||
EventBus.sim_tick.connect(_on_sim_tick_world_sweep)
|
||
|
||
|
||
func world_bounds_px() -> Rect2:
|
||
return Rect2(Vector2.ZERO, Vector2(MAP_SIZE_TILES * TILE_SIZE_PX))
|
||
|
||
|
||
# ── tileset & map painting ──────────────────────────────────────────────────
|
||
|
||
func _build_placeholder_tileset() -> TileSet:
|
||
# Four 16×16 placeholder tiles laid out as a 4×1 atlas. Real ElvGames
|
||
# art replaces this in Phase 5 (wood walls + stone walls).
|
||
var ts := TileSet.new()
|
||
ts.tile_size = Vector2i(TILE_SIZE_PX, TILE_SIZE_PX)
|
||
|
||
var atlas_w := TILE_SIZE_PX * 4
|
||
var img := Image.create(atlas_w, TILE_SIZE_PX, false, Image.FORMAT_RGBA8)
|
||
var palette: Array[Color] = [
|
||
Color(0.45, 0.65, 0.30), # grass
|
||
Color(0.55, 0.45, 0.30), # dirt
|
||
Color(0.60, 0.60, 0.55), # stone
|
||
Color(0.30, 0.30, 0.32), # stone dark
|
||
]
|
||
for i in palette.size():
|
||
var base: Color = palette[i]
|
||
var border: Color = base.darkened(0.15)
|
||
for px in TILE_SIZE_PX:
|
||
for py in TILE_SIZE_PX:
|
||
var on_border := (
|
||
px == 0 or px == TILE_SIZE_PX - 1
|
||
or py == 0 or py == TILE_SIZE_PX - 1
|
||
)
|
||
img.set_pixel(i * TILE_SIZE_PX + px, py, border if on_border else base)
|
||
|
||
var tex := ImageTexture.create_from_image(img)
|
||
var src := TileSetAtlasSource.new()
|
||
src.texture = tex
|
||
src.texture_region_size = Vector2i(TILE_SIZE_PX, TILE_SIZE_PX)
|
||
for i in palette.size():
|
||
src.create_tile(Vector2i(i, 0))
|
||
ts.add_source(src, PLACEHOLDER_SOURCE_ID)
|
||
return ts
|
||
|
||
|
||
func _paint_terrain() -> void:
|
||
for x in MAP_SIZE_TILES.x:
|
||
for y in MAP_SIZE_TILES.y:
|
||
terrain_layer.set_cell(Vector2i(x, y), PLACEHOLDER_SOURCE_ID, TILE_GRASS)
|
||
|
||
|
||
func _paint_sample_walls() -> void:
|
||
var origin := Vector2i(36, 36)
|
||
var size: int = 8
|
||
for i in size:
|
||
wall_layer.set_cell(origin + Vector2i(i, 0), PLACEHOLDER_SOURCE_ID, TILE_STONE)
|
||
wall_layer.set_cell(origin + Vector2i(i, size - 1), PLACEHOLDER_SOURCE_ID, TILE_STONE)
|
||
wall_layer.set_cell(origin + Vector2i(0, i), PLACEHOLDER_SOURCE_ID, TILE_STONE_DARK)
|
||
wall_layer.set_cell(origin + Vector2i(size - 1, i), PLACEHOLDER_SOURCE_ID, TILE_STONE_DARK)
|
||
|
||
|
||
# ── pathfinder + pawns ──────────────────────────────────────────────────────
|
||
|
||
func _wire_walls_to_pathfinder() -> void:
|
||
var wall_cells := wall_layer.get_used_cells()
|
||
for cell in wall_cells:
|
||
pathfinder.set_cell_walkable(cell, false)
|
||
Audit.log("world", "%d wall cells marked impassable" % wall_cells.size())
|
||
|
||
|
||
func _spawn_sample_pawns() -> void:
|
||
for spawn_data in SAMPLE_PAWNS:
|
||
var p: Pawn = PAWN_SCENE.instantiate()
|
||
add_child(p)
|
||
p.setup(spawn_data["name"], spawn_data["tile"])
|
||
|
||
# Phase 3: attach a JobRunner so Decision can hand it jobs.
|
||
var jr := JobRunner.new()
|
||
jr.name = "JobRunner"
|
||
p.add_child(jr)
|
||
jr.setup(p, pathfinder)
|
||
p.job_runner = jr
|
||
|
||
World.register_pawn(p)
|
||
|
||
|
||
# ── Phase 4: harvestables + stockpile zones ─────────────────────────────────
|
||
|
||
func _spawn_sample_harvestables() -> void:
|
||
# Untyped vars — Godot's class-name cache for class_name'd classes is
|
||
# scan-time and intermittently lags behind file changes. Duck typing is
|
||
# safer here and the calls below are all spec'd on the entity types.
|
||
for t_tile in SAMPLE_TREES:
|
||
var tree = TREE_SCENE.instantiate()
|
||
add_child(tree)
|
||
tree.setup(t_tile)
|
||
for r_tile in SAMPLE_ROCKS:
|
||
var rock = ROCK_SCENE.instantiate()
|
||
add_child(rock)
|
||
rock.setup(r_tile)
|
||
Audit.log("world", "spawned %d trees + %d rocks" % [SAMPLE_TREES.size(), SAMPLE_ROCKS.size()])
|
||
|
||
|
||
func _spawn_sample_stockpiles() -> void:
|
||
# Two zones for the Phase 4 acceptance demo:
|
||
# - Zone A (north): wood-only filter, NORMAL priority (just a wood drop)
|
||
# - Zone B (south): wildcard, HIGH priority (the "watch wood flow upward" target)
|
||
# When the sweep runs, wood items in Zone A get re-marked for haul and
|
||
# eventually migrate to Zone B.
|
||
var zone_a: StockpileZone = STOCKPILE_SCENE.instantiate()
|
||
add_child(zone_a)
|
||
zone_a.region = Rect2i(15, 55, 4, 4)
|
||
zone_a.label = "Wood (Normal)"
|
||
zone_a.priority = StorageDestination.Priority.NORMAL
|
||
zone_a.accepted_types = [Item.TYPE_WOOD] as Array[StringName]
|
||
zone_a.queue_redraw()
|
||
|
||
var zone_b: StockpileZone = STOCKPILE_SCENE.instantiate()
|
||
add_child(zone_b)
|
||
zone_b.region = Rect2i(15, 62, 4, 4)
|
||
zone_b.label = "Anything (High)"
|
||
zone_b.priority = StorageDestination.Priority.HIGH
|
||
zone_b.accepted_types = [] as Array[StringName] # wildcard
|
||
zone_b.queue_redraw()
|
||
|
||
Audit.log("world", "spawned 2 stockpiles: %s + %s" % [zone_a.label, zone_b.label])
|
||
|
||
|
||
# ── periodic re-flow (the "wood floats up" cascade) ─────────────────────────
|
||
|
||
func _on_sim_tick_world_sweep(tick_n: int) -> void:
|
||
if tick_n % HAUL_SWEEP_INTERVAL_TICKS != 0:
|
||
return
|
||
hauling_provider.sweep_for_better_destinations()
|
||
|
||
|
||
# ── spike: AStarGrid2D query timing at 80² ──────────────────────────────────
|
||
|
||
func _run_pathfinder_spike() -> void:
|
||
var corners := [
|
||
Vector2i(2, 2),
|
||
Vector2i(MAP_SIZE_TILES.x - 3, 2),
|
||
Vector2i(2, MAP_SIZE_TILES.y - 3),
|
||
Vector2i(MAP_SIZE_TILES.x - 3, MAP_SIZE_TILES.y - 3),
|
||
]
|
||
var pairs: Array = []
|
||
for a in corners:
|
||
for b in corners:
|
||
if a != b:
|
||
pairs.append([a, b])
|
||
var result: Dictionary = pathfinder.benchmark(pairs, 3)
|
||
Audit.log("world", "spike: %d paths min=%d us avg=%.1f us max=%d us" % [
|
||
result["total_paths"], result["min_us"], result["avg_us"], result["max_us"]
|
||
])
|
||
|
||
|
||
# ── camera bounds ───────────────────────────────────────────────────────────
|
||
|
||
func _apply_camera_bounds() -> void:
|
||
var cam := get_node_or_null("CameraRig")
|
||
if cam == null:
|
||
Audit.log("world", "no CameraRig child yet — bounds set later when camera lands.")
|
||
return
|
||
if not cam.has_method("set_world_bounds"):
|
||
Audit.log("world", "CameraRig present but missing set_world_bounds() — skipping.")
|
||
return
|
||
cam.set_world_bounds(world_bounds_px())
|