Jajce Resource States 05

Captured: 2026-07-17

Files

full resources
low resources
depleted resources
world/resource_nodes/ResourceAmountVisual.gd
world/jajce/HarvestableTreePresentation.tscn
tests/jajce_resource_presentation_state_test.gd

The three images use the same 1280×720 cross-river camera, daylight value, warmup, and Metal renderer. Debug labels are hidden. The lower-left berry patch and right-hand harvestable tree are shown at their authored full amounts, at 40%/50% respectively, and at zero.

Amount-derived visual language

ResourceAmountVisual finds its owning ResourceNode and derives one of three tiers from amount_remaining / initial_amount:

full keeps all five berry leaf clumps, eight berries, and four tree canopies;
low keeps three leaf clumps, four berries, and two tree canopies; and
depleted keeps a two-leaf fruitless remnant and replaces the tree with a low-poly stump and warm cut face.

The threshold is deliberately simple and readable: a positive source at or below half amount is low. The berry keeps using two bounded MultiMeshes, so thinning changes only visible_instance_count; it does not create or destroy nodes during play. The tree wrapper reuses the existing wind-reactive standing tree and toggles authored crown/stump parts.

Authority and restore proof

ResourceStateRecord remains the only amount authority. ResourceNode now emits its existing amount_changed presentation signal when authoritative state is rebound, including restore. The visual contract listens to that signal and also refreshes once after scene readiness, covering either bind order.

The focused scenario performs two real player harvests on berry_bush_river_02 and two real NPC gather completions on tree_river_resource_01, checks the low presentation and NPC wood inventory, then fully depletes both through those same production paths. It restores low and depleted snapshots in turn and verifies the presentation is reconstructed. The resource records contain no visual, visibility, tier, or stump fields.

The capture tool's optional amount overrides also construct and bind ordinary ResourceStateRecords. They do not directly manipulate visual children, so the review images exercise the same runtime contract as gameplay.

Next slice

Apply this contract to the existing tree_forest_grove_01 and tree_forest_grove_02 stable IDs in one bounded forest-edge cluster. Decorative canopy and understory should stay presentation-only while the two finite trees remain reachable, discoverable, depletable, and restore correctly.

Capture commands

HOME="$PWD/logs/quality/godot_profile" \
APPDATA="$PWD/logs/quality/godot_profile" \
LOCALAPPDATA="$PWD/logs/quality/godot_profile" \
/Applications/Godot.app/Contents/MacOS/Godot \
  --path "$PWD" --script res://tools/capture_jajce_lookdev.gd -- \
  --scene=res://world/jajce/JajceResourceStateLookdev.tscn \
  --output=res://docs/baselines/jajce_resource_states_05_full.png \
  --hide-resource-labels

For the low frame, append:

--resource-amount=berry_bush_river_02:2
--resource-amount=tree_river_resource_01:4

For the depleted frame, use the same arguments with both amounts set to 0.

3.3 KiB Raw Permalink Blame History Unescape Escape