EXP materials and production atlas

The materials-driven catalog is the full proposed material inventory and replacement plan. This atlas explains its structure and production routes. The living resource economy defines resource renewal and depletion. Apparel, AI, and mobility expands the product families.

The current implementation remains in lib/adventure/catalog/. Its generated tiers and fallback recipes are legacy data, not proof that the new production model exists. Complete bills of materials, quantities, yields, and skill assignments remain unfinished. The compositions below are proposed design examples, not validated manufacturing instructions.

flowchart TD
  E[Ecology and deposits] --> R[Gathered resources]
  A[Ark salvage] --> R
  R --> F[Prepared feedstock]
  F --> M[Engineered materials]
  M --> S[Standard forms: sheet, wire, cloth]
  S --> C[Components]
  C --> P[Products]
  P --> Y[Connected systems]
  Y --> V[Services: water, shelter, transport]
  P --> U[Use and wear]
  Y --> U
  U --> Q[Inspect and repair]
  Q --> P
  U --> D[Disassemble and sort]
  D --> F
  D --> W[Unrecoverable waste]
  W --> T[Treatment or safe disposal]
  K[Knowledge, labor, tools, energy, time] -.-> F
  K -.-> C
  K -.-> Q

Services consume capacity. A pump is a product; reliable water delivery is a service. A workshop cannot promise unlimited repairs because someone owns a wrench.

This table organizes the inventory in the source design. Named additions there remain proposals until curated into stable records.

Do not assign universal quality tiers. Composition, purity, form, workmanship, condition, rarity, and technology are separate fields. A battery is an assembly. Water is not a five-tier weapon material.

Each row ends in a useful service. These are the ten routes selected by the source design for the first catalog rewrite.

flowchart LR
  H[Hemp crop] --> B[Bast fiber]
  H --> S[Woody stalk core]
  H --> G[Seed]
  B --> Y[Yarn]
  Y --> C[Cloth]
  Y --> R[Rope]
  C --> A[Apparel and repair patches]
  R --> L[Lashing and cargo handling]
  S --> P[Specified building or bedding material]
  G --> O[Food or oil process]
  H --> X[Residues]
  X --> N[Controlled nutrient recovery]

This is a proposed game route. Each output needs its own process and suitability checks. One harvest cannot allocate its full mass to every branch. Planting needs suitable land, seed, water, labor, and time. Harvest and processing can create pollution or loss.

These are component-level drafts. Counts, masses, process yields, and approved substitutes are still open.

A filter alone does not establish potable water. A cloth recipe does not establish a safe pressure suit. The game needs validated process and test records before it teaches safety-critical claims.

flowchart TD
  B[Bill of materials] --> O[Item instance]
  R[Process route and revision] --> O
  Q[Measured quality and tests] --> O
  O --> H[Use history]
  H --> I[Inspection]
  I --> F[Repair with named replacement parts]
  F --> H
  I --> D[Disassembly]
  D --> S[Recovered lots with measured condition]

A bill of materials answers what is inside. A process route answers how workers make it. An item instance records what they actually used and what passed inspection. A service contract records what the system must deliver and who maintains it.

Example: “The mill needs a bearing.” The player can repair it, make one, or arrange delivery. The world shows the wheel turning again. PupBRO offers the composition and production route only when requested.

The simulation checks the inputs underneath that choice. It does not ask the player to manage every fastener. Work plans stop safely when inputs or permissions run out. No daily claim is needed.

1. Export every current catalog ID and its art reference.
2. Mark each as keep, split, merge, replace, or retire. Preserve references until migration is tested.
3. Build stable material and component records for the ten routes.
4. Define each product's bill and each process's inputs, outputs, losses, and limits.
5. Assign exact skill-tree IDs after review. Do not guess ownership from an item name.
6. Replace fallback recipes only when a reviewed route exists.
7. Test vendors, harvest, loot, repair, salvage, and shipping against the same records.

The replacement is complete only when every retained item has a reviewed mapping. Unknown composition is an explicit gap, never an invisible default.

Tests must reject negative stock, duplicated salvage, missing inputs, incompatible substitutes, and shipments that credit both worlds. Repeated manufacture/recycle loops must not create matter or free energy. Service capacity must fall when required inputs fail. Recovery may preserve material while losing purity or useful form.

• Exhaustive old-to-new item mapping and final record counts.
• Exact quantities, units, yields, and process durations.
• Which Ark machines and feedstocks survive.
• Skill ownership, facility capacity, and robot maintenance demand.
• Evidence review for health, chemicals, life support, and frontier science.
• Economic tuning through the civilization simulator.

This guide organizes the agreed direction. It does not claim that those decisions or algorithms are finished.