This directory defines the generalized simulation and hardware contract for the ATOS hex-tile world.
The central idea is that tracks, buildings, stations, machines, scenery, train cars, road vehicles, and portable power modules are all physical entities attached to a common tile fabric. Each entity declares what it can contain, consume, produce, transform, sense, and express through light, motion, audio, and other effects.
- Physical World Model — durable domain model and simulation boundaries.
- Entity Capability Contract — common contract for tiles, set pieces, and vehicles.
- Resources, Recipes, and Logistics — inventories, transformations, demand, and transport.
- Hex Tile Runtime — topology, power, data, payload discovery, and scheduling.
- Vehicles, Consists, and Routes — cargo vehicles, dynamic consists, and addressed movement authorities.
- Modular Sled Platform — S1 sled/module identity, interface, datums, couplers, ballast experiments, and route-admission boundary.
- S1 Vehicle Dynamics and Loading Envelope — provisional mass, center-of-mass, curve, coupler, clearance, dynamic, route-admission, and prototype-test limits.
- Effects and Spatial Audio — state-driven light, motion, and low-latency sound.
- Design Precedents — lessons adapted from OpenSC2K, Factorio, Mindustry, and Satisfactory.
- Worked Examples — houses, church, factory, station, and train examples.
- Physical identity and simulated state are separate.
- Every entity uses the same capability vocabulary.
- Resources move through explicit ports and inventories.
- Recipes transform resources over time and under constraints.
- Effects are projections of state, not the source of state.
- Safety-critical track control remains deterministic and local.
- The simulation may degrade presentation loads without corrupting authoritative state.
- Definitions are data-driven and versioned so new set pieces do not require core-engine changes.