xTr1m/zfxaction26_2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document approved design iteration

Browse Source
This commit is contained in:
Frank Tovar
2026-05-11 21:53:55 +02:00
parent 5ddd1b8ec8
commit 787f1e5e85
2 changed files with 178 additions and 226 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
TASKS.md
View File

@@ -1,9 +1,26 @@
# Reactor Maintenance Rewrite Tasks # Reactor Maintenance Rewrite Tasks
## Current State ## Current State
- Approved design iteration targets the simulation model, rule removal, action economy, reactor requirements, and editor layer workflow.
- Work is proceeding on branch `design-iteration-structural-editor` in methodical commits: docs/tasks, simulation rework, editor rework, cleanup.
## Completed Work ## Completed Work
- Created the approved implementation plan for:
- single multi-service consumers,
- count-based reactor requirements,
- cell-derived doors,
- 0-10 structural integrity,
- fixed automatic rule systems,
- quick/lengthy action economy,
- all-seeing-eye viewing without persistent unlocking,
- layer-aware editor visualization and tools.
## Current Work ## Current Work
- Update design documentation to match the approved model.
- Rework simulation state, validation, serialization, forecasts, and tests.
- Rework Win2D editor layer selection, rendering, tool filtering, drag behavior, and removed panels.
## Future Work ## Future Work
- Add authored sample levels once the new schema stabilizes.
- Tune structural integrity balancing after playtesting.
- Extend UI affordances for inspecting per-carrier consumer service state.

387
docs/design.md
View File

@@ -4,44 +4,58 @@
The player controls a maintenance robot inside a failing reactor facility. The game is a deterministic, turn-based systems puzzle about reading a visible machine, forecasting failure, and choosing between local stabilization and longer-term network control. The player controls a maintenance robot inside a failing reactor facility. The game is a deterministic, turn-based systems puzzle about reading a visible machine, forecasting failure, and choosing between local stabilization and longer-term network control.
The simulation uses a small formal core: The simulation core is built from:
- static floor and wall terrain - static floor and wall terrain,
- underground fuel, coolant, and electricity networks - underground fuel, coolant, and electricity networks,
- surface props for controls, terminals, supplies, doors, and reactor activation - surface props for controls, terminals, supplies, doors, and reactor activation,
- reachable leaks that project hazards onto floor cells - consumers that consume whichever underground services exist under their cell,
- explicit reactor requirements bound to consumer props - reachable leaks that project hazards onto floor cells,
- deterministic rule events and forecasts - transport network structural integrity,
- deterministic fixed simulation rules and forecasts.
The game should feel logical, tactical, readable, and systemic. It should avoid randomness, action pressure, and hidden information after the player earns the relevant diagnostic access. The game should feel logical, tactical, readable, and systemic. It should avoid randomness, action pressure, and hidden information once the player reaches an all-seeing-eye terminal.
## Turn Structure ## Action Economy
Each turn has three phases: There is no per-turn action budget. Player choices are either quick or lengthy.
1. Player phase: the player spends the level action budget. Quick actions do not mutate the level state and do not advance the simulation:
2. Simulation phase: networks, consumers, leaks, hazards, doors, robot safety, and level state resolve.
3. Event phase: rule events, remedy block durations, and heat immunity duration advance.
The simulation advances once after the player spends or ends the turn action budget. Individual player actions do not tick the simulation. - robot movement,
- selection and inspection,
- all-seeing-eye viewing.
Lengthy actions mutate level state and immediately advance one simulation step:
- enabling or disabling a prop,
- opening or closing a door,
- repairing a leak,
- applying a remedy,
- using a heat shield,
- waiting or ending the current interaction beat.
Invalid actions report refusal and do not mutate gameplay state.
## Goal And Failure ## Goal And Failure
Each reactor starts offline. A reactor becomes ready when: Each reactor starts offline. A reactor becomes ready when:
- its bound fuel consumer is enabled, supplied, and producing - every underground network present beneath the reactor control cell has positive amount and intensity,
- its bound coolant consumer is enabled, supplied, and producing - the level has the required number of enabled, fed, producing fuel consumers,
- its bound electricity consumer is enabled, supplied, and producing - the level has the required number of enabled, fed, producing coolant consumers,
- reactor heat is below the terminal condition - the level has the required number of enabled, fed, producing electricity consumers,
- reactor heat is below the terminal condition.
When a reactor is ready, the level shows `REACTOR READY`. The player wins by spending an action at that reactor control site. The required consumer counts are level properties. The reactor is not explicitly bound to any consumer positions.
When a reactor is ready, the level shows `REACTOR READY`. The player wins by activating the ready reactor at the reactor control site.
The level is lost when: The level is lost when:
- reactor heat reaches the terminal threshold - reactor heat reaches the terminal threshold,
- the robot occupies an unsafe final hazard state without applicable protection - the robot occupies an unsafe final hazard state without applicable protection,
- a rule event marks terminal failure - fixed simulation rules mark terminal failure.
- level-authored unrecoverable conditions are met
Consumer starvation blocks readiness but does not directly cause loss. Consumer starvation blocks readiness but does not directly cause loss.
@@ -49,17 +63,17 @@ Consumer starvation blocks readiness but does not directly cause loss.
The player can always inspect: The player can always inspect:
- surface terrain - surface terrain,
- surface props and visible prop state - surface props and visible prop state,
- visible leaks and repair faces - visible leaks and repair faces,
- visible surface hazards - visible surface hazards,
- door state - door state,
- remedy inventory and supply props - remedy inventory and supply props,
- consumer state: disabled, starved, supplied, producing, or unknown - consumer state: disabled, starved, supplied, producing, or unknown,
- level state - level state,
- forecasted warnings the simulation can prove - forecasted warnings the simulation can prove.
Underground topology and numeric network values are hidden until all-seeing-eye terminal access is unlocked. With access, the player can inspect underground fuel, coolant, and electricity topology, network structural state, carrier amount, pressure or voltage, and source-to-consumer connectivity. Underground topology and numeric network values are available through all-seeing-eye viewing after the robot visits an all-seeing-eye terminal. There is no persistent lock or unlock state in the level data.
The editor always sees and authors every layer. The editor always sees and authors every layer.
@@ -69,31 +83,33 @@ Safe, caution, and critical labels are display and forecast bands derived from b
Each map coordinate contains: Each map coordinate contains:
- one static surface terrain cell: `Floor` or `Wall` - one static surface terrain cell: `Floor` or `Wall`,
- zero or one underground fuel cell - zero or one underground fuel cell,
- zero or one underground coolant cell - zero or one underground coolant cell,
- zero or one underground electricity cell - zero or one underground electricity cell,
- zero or one surface prop - zero or one surface prop,
- visible hazard amounts on floor cells - visible hazard amounts on floor cells,
- optionally the robot, only on a floor cell - optionally the robot, only on a floor cell.
Terrain is authored and does not change during play. Wall cells are not walkable and do not store surface hazards. Terrain is authored and does not change during play. Wall cells are not walkable and do not store surface hazards.
Underground cells use one structural state: Underground cells use one structural state:
- `Absent` - `Absent`,
- `Intact` - `Intact`,
- `Leaking` - `Leaking`.
Underground cells store carrier amount plus pressure for fuel/coolant or voltage for electricity. Same-carrier underground cells connect by inferred cardinal adjacency. Underground cells store carrier amount, pressure or voltage intensity, and structural integrity on a 0-10 scale. Max structural integrity supports the highest pressure. Non-max integrity under high pressure worsens proportionally to excess pressure. Low integrity with positive pressure creates a leak. Repairing a leak restores integrity to max.
Same-carrier underground cells connect by inferred cardinal adjacency.
Surface floor cells store: Surface floor cells store:
- leaked fuel - leaked fuel,
- leaked coolant - leaked coolant,
- leaked electricity - leaked electricity,
- heat - heat,
- active elemental remedy blocks - active elemental remedy blocks.
Simulation values use C# `float`. Runtime values are clamped and retain full float precision. UI shows visible values rounded to one decimal plus the safe/caution/critical band. Simulation values use C# `float`. Runtime values are clamped and retain full float precision. UI shows visible values rounded to one decimal plus the safe/caution/critical band.
@@ -112,13 +128,13 @@ The derived level states are:
Surface prop categories: Surface prop categories:
- flow prop - flow prop,
- consumer prop - consumer prop,
- junction prop - junction prop,
- door prop - door prop,
- all-seeing-eye terminal prop - all-seeing-eye terminal prop,
- remedy supply prop - remedy supply prop,
- reactor control prop - reactor control prop.
Props exist on floor cells. Props do not directly participate in the surface hazard pair table. Props exist on floor cells. Props do not directly participate in the surface hazard pair table.
@@ -130,25 +146,19 @@ During network flow, an enabled flow prop injects source carrier amount and pres
### Consumer Props ### Consumer Props
A consumer prop is bound to fuel, coolant, or electricity. It can be `Enabled` or `Disabled`. A consumer prop can be `Enabled` or `Disabled`.
An enabled consumer derives one service state after network propagation: An enabled consumer derives one service state per underground network present beneath it:
- `Supplied`: enough carrier and pressure or voltage reaches the bound underground cell. - `Supplied`: enough carrier and pressure or voltage reaches the underground cell.
- `Starved`: supply predicates fail. - `Starved`: supply predicates fail.
- `Producing`: the consumer was supplied this simulation step and emits service. - `Producing`: the consumer was supplied this simulation step and emits service.
A disabled consumer consumes nothing, produces nothing, and cannot satisfy reactor readiness. A disabled consumer consumes nothing, produces nothing, and cannot satisfy reactor readiness. A consumer on multiple underground layers consumes all present layers and can satisfy one requirement for each carrier that is producing.
### Reactor Control Props ### Reactor Control Props
A reactor control prop is the activation site for one reactor. Each reactor stores required consumer bindings by grid position: A reactor control prop is the activation site for one reactor. Reactor readiness is derived from level-level consumer count requirements and the networks beneath the reactor control cell.
- fuel consumer position
- coolant consumer position
- electricity consumer position
The level is invalid if any binding is missing, out of bounds, or points to the wrong prop type.
### Junction Props ### Junction Props
@@ -156,25 +166,25 @@ A junction prop must be on a floor cell whose coordinate has exactly one undergr
The engine infers incoming and outgoing branch directions from valid network topology and enabled source paths. A valid junction has one incoming branch and either two or three outgoing branches. Ambiguous junction flow is invalid. Ratio numbers are balance-defined weights that divide carrier amount and pressure or voltage. A zero-weight branch receives no intentional outflow. The engine infers incoming and outgoing branch directions from valid network topology and enabled source paths. A valid junction has one incoming branch and either two or three outgoing branches. Ambiguous junction flow is invalid. Ratio numbers are balance-defined weights that divide carrier amount and pressure or voltage. A zero-weight branch receives no intentional outflow.
The gameplay UI exposes a single junction tool and cycles through balance-defined ratio presets for the inferred outgoing branch count.
Editor commands use a verb plus parameters, so carrier-specific choices such as fuel flow or coolant flow are UI presets over one `Flow` command instead of separate simulation concepts.
### Doors ### Doors
A door stores one edge between two adjacent floor cells. Door states are `Open` and `Closed`. A door is a prop on one floor cell. Its orientation is derived from opposing wall cells:
Closed doors block fuel, coolant, electricity, and heat propagation across their edge. They do not block robot movement, underground network flow, source feeding, consumer supply, or hazards already present on either side. - north and south walls mean the door sits in an east-west corridor and blocks west/east propagation while closed,
- west and east walls mean the door sits in a north-south corridor and blocks north/south propagation while closed.
A door must have exactly one valid opposing wall pair. Closed doors block fuel, coolant, electricity, and heat propagation across the corridor cell. They do not block robot movement, underground network flow, source feeding, consumer supply, or hazards already present on either side.
### Terminals And Supplies ### Terminals And Supplies
An all-seeing-eye terminal unlocks underground inspection for the level. An all-seeing-eye terminal allows full underground inspection when visited.
Remedy supply props are single-use pickups: Remedy supply props are single-use pickups:
- `FuelRemedySupply` - `FuelRemedySupply`,
- `CoolantRemedySupply` - `CoolantRemedySupply`,
- `ElectricityRemedySupply` - `ElectricityRemedySupply`,
- `HeatRemedySupply` - `HeatRemedySupply`.
Each supply provides one matching inventory item and then becomes depleted. Each supply provides one matching inventory item and then becomes depleted.
@@ -184,45 +194,30 @@ Each leak stores carrier type, underground coordinate, accessible floor coordina
Fuel and coolant leaks: Fuel and coolant leaks:
- occur under floor cells - occur under floor cells,
- use the same coordinate as their accessible floor coordinate - use the same coordinate as their accessible floor coordinate,
- can be repaired or remediated by the robot standing on that floor cell - can be repaired or remediated by the robot standing on that floor cell.
Electricity leaks: Electricity leaks:
- occur in wall cells - occur in wall cells,
- store exactly one adjacent floor cell as the emission face - store exactly one adjacent floor cell as the emission face,
- can be repaired or remediated from that floor cell - can be repaired or remediated from that floor cell,
- emit only to that stored face - emit only to that stored face.
All leaks must have valid floor access. Repair changes the underground cell from `Leaking` to `Intact` and stops future injection. Repair does not clean existing surface hazards. All leaks must have valid floor access. Repair changes the underground cell from `Leaking` to `Intact`, restores structural integrity to max, and stops future injection. Repair does not clean existing surface hazards.
The robot carries remedial consumables with balance-defined inventory capacity: The robot carries remedial consumables with balance-defined inventory capacity:
- `FuelNeutralizer` - `FuelNeutralizer`,
- `CoolantNeutralizer` - `CoolantNeutralizer`,
- `ElectricityNeutralizer` - `ElectricityNeutralizer`,
- `HeatShield` - `HeatShield`.
Element neutralizers remove the matching surface element from a target floor cell or reachable leak face, then apply a temporary same-element re-entry block. They do not remove other elements, reduce heat, or repair leaks. Element neutralizers remove the matching surface element from a target floor cell or reachable leak face, then apply a temporary same-element re-entry block. They do not remove other elements, reduce heat, or repair leaks.
Heat shield gives the robot heat immunity for a balance-defined number of movement steps. It does not remove heat, block heat propagation, or protect against fuel, coolant, or electricity hazards. Heat shield gives the robot heat immunity for a balance-defined number of movement steps. It does not remove heat, block heat propagation, or protect against fuel, coolant, or electricity hazards.
## Player Actions
Player actions:
- `MoveRobot`: move to an adjacent floor cell.
- `InteractProp`: use the prop on the robot's current floor cell.
- `InteractLeak`: repair a reachable leak or apply a matching elemental remedy.
- `ApplyHeatShield`: activate a carried heat shield.
- `ActivateReactor`: activate a ready reactor at the current reactor control prop.
- `EndTurn`: forfeit remaining actions and run the simulation/event phases.
Each valid action costs one action unless balance or level data defines otherwise. Invalid actions report refusal and do not mutate gameplay state.
`InteractProp` covers flow toggles, consumer toggles, junction ratio changes, door toggles, terminal unlock, and remedy pickup.
## Network Flow ## Network Flow
Network flow runs independently for fuel, coolant, and electricity. Network flow runs independently for fuel, coolant, and electricity.
@@ -248,109 +243,42 @@ Leaking underground cells remain part of network propagation.
During leak injection: During leak injection:
- fuel leaks add leaked fuel to the accessible floor cell - fuel leaks add leaked fuel to the accessible floor cell,
- coolant leaks add leaked coolant to the accessible floor cell - coolant leaks add leaked coolant to the accessible floor cell,
- electricity leaks add leaked electricity to the stored floor emission face - electricity leaks add leaked electricity to the stored floor emission face,
- active matching remedy blocks prevent matching element entry - active matching remedy blocks prevent matching element entry.
Injection magnitude is balance data and may depend on local carrier amount, pressure, or voltage. Injection magnitude is balance data and may depend on local carrier amount, pressure, or voltage.
After injection, the engine evaluates local interactions between leaked fuel, leaked coolant, leaked electricity, and heat on the same floor cell and across unblocked adjacent floor cells. After injection, the engine evaluates local interactions between leaked fuel, leaked coolant, leaked electricity, and heat on the same floor cell and across unblocked adjacent floor cells.
## Hazard Bands And Pair Table ## Fixed Rule Systems
Balance thresholds project numeric values into safe, caution, and critical bands: Data-driven rule predicates and effects are not part of level data. Effects happen through fixed systems:
- `FuelSafe`, `FuelCaution`, `FuelCritical` - player-issued lengthy interactions toggle props, use inventory, open or close doors, repair leaks, and activate reactors,
- `CoolantSafe`, `CoolantCaution`, `CoolantCritical` - automatic simulation systems propagate networks, resolve consumers, weaken structural integrity, create leaks, spread and react hazards, resolve robot safety, derive reactor state, and refresh forecasts.
- `ElectricitySafe`, `ElectricityCaution`, `ElectricityCritical`
- `HeatSafe`, `HeatCaution`, `HeatCritical`
The pair table maps projected bands to deterministic effects: Warnings are generated by fixed forecast and status systems when conditions can be proven.
- `Hold`: no direct change.
The pair table maps projected bands to parameterized verbs:
- `Hold`: no direct change.
- `Flow(amount)`: equalize a surface quantity by a balance-defined transfer amount.
- `Warm(amount)`: increase heat by a balance-defined amount.
- `Quench(amount)`: reduce heat by a balance-defined amount.
- `Short(heat, discharge)`: add heat and discharge electricity by balance-defined amounts.
- `Ignite(heat, fuel)`: add heat and consume fuel by balance-defined amounts.
| Row\Col | FuelSafe | FuelCaution | FuelCritical | CoolantSafe | CoolantCaution | CoolantCritical | ElectricitySafe | ElectricityCaution | ElectricityCritical | HeatSafe | HeatCaution | HeatCritical |
| ------- | -------- | ----------- | ------------ | ----------- | -------------- | --------------- | --------------- | ------------------ | ------------------- | -------- | ----------- | ------------ |
| FuelSafe | Hold | Flow | Flow | Hold | Hold | Hold | Hold | Warm | Ignite | Hold | Warm | Ignite |
| FuelCaution | | Hold | Flow | Hold | Hold | Hold | Warm | Ignite | Ignite | Warm | Ignite | Ignite |
| FuelCritical | | | Hold | Hold | Hold | Hold | Ignite | Ignite | Ignite | Ignite | Ignite | Ignite |
| CoolantSafe | | | | Hold | Flow | Flow | Hold | Short | Short | Hold | Quench | Quench |
| CoolantCaution | | | | | Hold | Flow | Short | Short | Short | Hold | Quench | Quench |
| CoolantCritical | | | | | | Hold | Short | Short | Short | Hold | Quench | Quench |
| ElectricitySafe | | | | | | | Hold | Flow | Flow | Hold | Hold | Hold |
| ElectricityCaution | | | | | | | | Hold | Flow | Hold | Hold | Hold |
| ElectricityCritical | | | | | | | | | Hold | Hold | Hold | Hold |
| HeatSafe | | | | | | | | | | Hold | Flow | Flow |
| HeatCaution | | | | | | | | | | | Hold | Flow |
| HeatCritical | | | | | | | | | | | | Hold |
Design rules:
- fuel becomes dangerous through electricity or heat
- coolant becomes dangerous through electricity
- coolant opposes heat
- heat equalizes between neighboring floor cells
- same-carrier leaked surface amounts equalize between neighboring floor cells
- doors and remedy blocks gate local interactions
## Rule Events
Rule events are deterministic and forecastable. Each event stores enabled state, once/repeat behavior, priority, predicates, effects, and optional forecast text. All predicates must pass for the event to trigger.
Predicate families:
- turn comparisons
- level state comparisons
- reactor readiness/loss/win comparisons
- prop type or state at position
- consumer service state at position
- network value band at position
- surface hazard band at position
- robot position or inventory condition
- all-seeing-eye unlocked state
Effects:
- start a valid leak
- worsen an existing leak
- repair or disable a network cell
- enable or disable a prop
- add or remove surface hazard
- add or remove heat
- add or remove inventory
- mark terminal loss
- emit warning text
## Simulation Order ## Simulation Order
One completed turn resolves in this order: One lengthy interaction resolves in this order:
1. Apply accepted player actions. 1. Apply the accepted player mutation.
2. Validate runtime state. 2. Validate runtime state.
3. Apply matching start-of-simulation rule events. 3. Propagate underground networks.
4. Propagate underground networks. 4. Resolve consumers and service production.
5. Resolve consumers and service production. 5. Resolve structural integrity and automatic leak creation.
6. Inject leaks. 6. Inject leaks.
7. Evaluate same-cell surface interactions. 7. Evaluate same-cell surface interactions.
8. Evaluate adjacent floor interactions across unblocked edges. 8. Evaluate adjacent floor interactions across unblocked door cells.
9. Accumulate and apply deltas in deterministic priority order. 9. Accumulate and apply deltas in deterministic priority order.
10. Clamp values. 10. Clamp values.
11. Resolve robot safety. 11. Resolve robot safety.
12. Derive reactor readiness and level state. 12. Derive reactor readiness and level state.
13. Apply matching end-of-turn rule events. 13. Advance remedy blocks and heat immunity.
14. Advance remedy blocks and heat immunity. 14. Refresh forecasts.
15. Refresh forecasts.
If multiple events modify the same value in one step, deltas accumulate and then clamp. Event priority may consume, reserve, or block a value first.
## Forecasts ## Forecasts
@@ -358,11 +286,11 @@ Forecasts are deterministic simulations over copied state. Forecasting does not
Forecast output includes: Forecast output includes:
- terminal loss forecasts - terminal loss forecasts,
- reactor ready forecasts - reactor ready forecasts,
- starved required consumer warnings - starved required consumer warnings,
- growing hazard warnings when values cross caution or critical bands - growing hazard warnings when values cross caution or critical bands,
- rule event warnings when predicates can be proven within the forecast horizon - structural integrity leak warnings when weakened cells are expected to leak.
The forecast horizon is balance data. The forecast horizon is balance data.
@@ -372,51 +300,58 @@ The editor blocks run and save when validation errors exist. Warnings are visibl
Validation errors: Validation errors:
- invalid dimensions or cell counts - invalid dimensions or cell counts,
- robot out of bounds or not on floor - robot out of bounds or not on floor,
- wall cell with surface hazards - wall cell with surface hazards,
- prop on invalid terrain - prop on invalid terrain,
- missing or invalid reactor consumer binding - invalid required consumer counts,
- invalid door edge - invalid door cell,
- invalid leak access - invalid leak access,
- invalid rule target - junction without exactly one underground carrier,
- junction without exactly one underground carrier - ambiguous junction flow,
- ambiguous junction flow - network loop or equal-source ambiguity at a junction,
- network loop or equal-source ambiguity at a junction - malformed required data.
- malformed required data
Validation warnings: Validation warnings:
- unreachable non-required consumer - unreachable non-required consumer,
- underground cell with no source path - underground cell with no source path,
- initially starved required consumer - initially starved required consumer,
- initially unready reactor - initially unready reactor,
- unused remedy supply - unused remedy supply,
- visible hazard with no detectable nearby remedy or route - visible hazard with no detectable nearby remedy or route.
## Editor And Schema ## Editor And Schema
The editor authors: The editor authors:
- surface terrain - surface terrain,
- underground fuel, coolant, and electricity cells - underground fuel, coolant, and electricity cells,
- flow props and consumer props - flow props,
- reactor controls and explicit reactor consumer bindings - multi-service consumer props,
- junction props and balance-defined ratio mode index - required fuel, coolant, and electricity consumer counts,
- door props and explicit door edges - junction props and balance-defined ratio mode index,
- all-seeing-eye terminals - door props,
- remedy supplies - all-seeing-eye terminals,
- floor leaks and electricity wall leaks with authored access faces - remedy supplies,
- initial surface hazards and heat - floor leaks and electricity wall leaks with authored access faces,
- robot start position - initial surface hazards and heat,
- rule events - robot start position.
The serialized level schema stores level metadata, dimensions, terrain, underground layers, props and prop state, reactor bindings, leaks, doors, robot state, inventory, rule events, all-seeing-eye state, and dynamic state when saving active play. The editor includes layer selection for Surface, Electricity, Fuel, and Coolant:
- Surface active: surface is full opacity, all underground layers are 25% opacity.
- Underground active: surface is 50% opacity, inactive underground layers are 25% opacity, active underground layer is full opacity.
- Coolant renders blue, fuel red, electricity yellow.
- Networks render as thick lines connecting adjacent cell centers; sources render as large centered dots.
- Tools are layer-aware. Cursor is always available. Surface terrain, props, consumers, hazards, doors, and heat tools are available only on Surface. Network painting and sources are available only on their matching underground layer.
The serialized level schema stores level metadata, dimensions, terrain, underground layers including structural integrity, props and prop state, required reactor consumer counts, leaks, robot state, inventory, forecasts, and dynamic state when saving active play.
The loader accepts only schema-valid level data and returns clear errors for malformed data. The loader accepts only schema-valid level data and returns clear errors for malformed data.
## Balancing And Tests ## Balancing And Tests
Balancing defines source strengths, falloff, ratio math, consumer predicates, leak magnitudes, interaction magnitudes, display thresholds, robot safety thresholds, terminal heat thresholds, inventory capacity, remedy duration, heat immunity duration, action costs, and forecast horizon. Balancing defines source strengths, falloff, ratio math, consumer predicates, leak magnitudes, structural integrity thresholds and damage scale, interaction magnitudes, display thresholds, robot safety thresholds, terminal heat thresholds, inventory capacity, remedy duration, heat immunity duration, and forecast horizon.
Tests assert behavior against configured balance values and bands. Coverage includes validation, inferred connectivity, junction effects, consumer states, reactor readiness and activation, terminal loss, robot hazard loss, heat immunity, leak access, remedies, door blocking, rule events, forecasts, and serialization round trips. Tests assert behavior against configured balance values and bands. Coverage includes validation, inferred connectivity, junction effects, multi-service consumer states, reactor readiness and activation, terminal loss, robot hazard loss, heat immunity, structural integrity degradation and leak creation, leak access, remedies, door blocking, forecasts, and serialization round trips.