Original Game Simulation Specification

Baseline: origin/master at ab2c2944.

Entity Lifecycle

Entity construction starts from a hull item. It maps the hull grid, initializes armor, thermal mass, conductivity, hardpoints, equipment occupancy, behavior groups, and weapon groups. Activation initializes behaviors and subscriptions for zone membership, hostility, targeting, visibility, and destruction.

Deactivation disposes subscriptions and stops active behavior updates. Parent and child entities share parent pose/velocity and child mass contributes to parent mass. Docking removes the ship from the zone and parents it to a docking entity; undocking restores zone membership and activation.

Death may result from hull depletion, cockpit destruction, heatstroke, or hypothermia. Equipment fitting and cargo placement preserve item identity and validate geometric occupancy.

Evidence: ServerShared/Entity.cs, Zone.cs, Ship.cs, EntitySerializer.cs.

Stat Evaluation

Behavior stats combine authored data with item quality, durability performance, thermal performance, wear, and attached modifiers. Additive and multiplicative modifiers can be attached dynamically by equipment and timed consumables.

The daemon must execute one catalog-derived behavior graph. It must not retain one set of broad serialized fields while advancing a separate synthetic stat model.

Thermal Grid

Each hull/equipment cell has temperature and thermal mass. Orthogonal cells exchange heat according to conductivity edges and mass ratios. Exterior cells radiate according to authored curves and radiation contributes visibility. Behaviors deposit or move heat at their installed location. Item thermal performance and online state derive from local temperature.

Cockpit temperature advances heatstroke/hypothermia accumulation and recovery. Threshold crossings and death are authoritative events.

Energy Network

Capacitors store charge. A demand drains charged capacitors evenly first, then divides unmet demand among online reactors. Behaviors succeed or fail according to the actual transaction. Radiators consume energy to pump heat and produce waste heat. Shields consume energy per intercepted damage.

Behavior Execution

Required behavior families:

propulsion: thruster and Aether drive;
energy: capacitor, reactor, conversion;
thermal: radiator, heatsink, thermotoggle;
sensors: sensor, ping, reflector, visibility;
defense: shield and hull/armor consequences;
weapons: instant, automatic, constant, charged, lock, launcher, guided;
utility: tractor, mining, scanner, item usage, velocity limit;
composition: switches, triggers, behavior groups, stat modifiers;
timed consumables containing ordinary behaviors.

Behavior groups expose semantic switches, triggers, or analog controls. The daemon advertises those controls as current actions. Clients never invoke the behavior implementation directly.

Consumables

Activation requires the actual item in cargo. Non-stackable effects reject a duplicate active effect. Activation removes the item instance and executes its behaviors for authored duration. Quality contributes to stat evaluation. Expiration removes effects and attached modifiers exactly once. ItemUsage may consume another configured cargo item.

Sensors And Visibility

Visibility sources are independently identified and decayed. Passive sensors accumulate observer-relative information from sensitivity, signature, and range. Threshold transitions create/remove classified contacts. Ping consumes energy, raises source visibility, expands in space, and grants information on crossing. Hostility uses faction ownership, security, and presence rules.

AI

Agents own root/current state, task, controls, acceleration, and transitions. Steering compares desired/current velocity. MoveTo is stopping-aware; MatchVelocity converges to target motion. Combat evaluates useful weapon groups and optimum range. Civilian tasks include hauling, mining, patrol, towing, survey, and wandering.

AI reads the same contacts, behavior graph, physics, and command primitives as players. It does not use privileged damage or movement shortcuts.

Quality And Progression

Crafted items carry continuous quality. Quality changes performance, durability response, thermal response, price, and wear. Rarity tiers map quality bands and derive tier/upgrade count. There is no XP/skill-tree system in the baseline.

Ymir Boundary

Ymir owns deterministic bodies, integration, fields, shape/ray/sweep queries, contacts, impulses, projectile trajectories, and spatial placement candidates. The daemon owns equipment interpretation, accepted controls, resource costs, damage meaning, lifecycle, inventory, and persistence.

The current Aetheria-local AetheriaRuntimeYmirProjectilePhysics does not call standalone Ymir.Core; it is migration scaffolding, not completion of this boundary.

Simulation Pipeline

typed commands + elapsed fixed time + catalog-derived behavior graph
  -> validate semantic controls and resource transactions
  -> derive forces/bodies/queries for Ymir
  -> Ymir deterministic spatial step
  -> interpret contacts and spatial results
  -> advance thermal, energy, sensors, AI, behaviors, lifecycle
  -> one atomic daemon commit
  -> durable state + deduplicated event chronology
  -> Eve projections

Order must be made explicit and parity-tested against the baseline. Full daemon boot is not the unit-test boundary: each organ requires narrow ports, mockable clock/physics/catalog dependencies, and adjacent pipeline smokes.

5.5 KiB Raw Blame History