Game Data Generated Item Family Adapters
What This System Is
Generated item family adapters turn compact family manifests into concrete game-data item rows, crop rows, provenance records, and aggregate catalog output.
How Authors Use It
Authors edit assets/gameplay/game_data_item_families.json when a repeated item family should generate predictable rows. Engineers add generator adapters when a new family type needs custom parsing, asset validation, or output rows.
Rules And Invariants
Generated rows must not override authored rows. Adapter output must be deterministic. Provenance must point back to the family manifest so source maps, doctor reports, and generated aggregate checks can explain where a row came from.
Validation And Debugging
Unsupported generators, schema mismatches, asset validation errors, and duplicate generated ids should fail before the aggregate is accepted. Debug generated rows by inspecting family source, adapter id, and provenance fields.
Examples
A crop family can generate seed bag, planted seed, produce, sign, and crop catalog rows from one manifest entry. If crops.sunflower is missing, inspect the family manifest before editing the generated aggregate.