neon-sprawl/docs/decomposition/modules/E3_M1_ResourceNodeAndGather...

1.9 KiB
Raw Blame History

E3.M1 — ResourceNodeAndGatherLoop

Summary

Field Value
Module ID E3.M1
Epic Epic 3 — Crafting Economy
Stage target Prototype
Status Planned (see dependency register)

Purpose

World resource nodes, gather interactions, and yield outputs feeding inventory (E3.M3) and XP (E2.M2).

Responsibilities

  • Spawn/manage nodes per ResourceNodeDef; resolve GatherResult via ResourceYieldTable; integrate interaction range via E1.M3.

Key contracts

Contract Role
ResourceNodeDef Node type, capacity, regen.
GatherResult Items and depletion state.
ResourceYieldTable Probabilities or fixed yields.

Module dependencies

  • E1.M3 — InteractionAndTargetingLayer.
  • E2.M2 — XpAwardAndLevelEngine.

Dependents (by design)

  • E3.M2 — RefinementAndRecipeExecution (inputs).
  • E4.M2 — SpawnEcologyController.

Epic 3 Slice 2 — 46 node types; resource_gathered, gather_node_depleted.

Prototype implementation anchor (NEO-41): until GatherResult / yield tables exist, the repo treats a successful POST …/interact on an entry with kind: resource_node (prototype_resource_node_alpha) as gather completion for skill XP only — salvage + activity via SkillProgressionGrantOperations (same rules as NEO-38). Migrate this hook when a dedicated gather pipeline lands.

Source anchors