3. Simulation logic
3.1 One shared simulation authority
Canonical data flows into one shaded simulation, from which GS2D and GS2K are drawn. There is no parallel legacy damage / weapon table that rewrites canonical TECHNREF.
3.2 Helicopter flight physics - shaded force-integrated runtime
Since P5.7.127 GS2D and GS2K have used one common HelicopterFlightModel. Collective, cyclic and yaw are not direct "move" commands: flight state is integrated from rotor stroke, thrust orientation, weight, wind and active assist / reality switches.
- Collective: the persistent position of the lever; changes the rotor requirement of the burst / power. Release of input does not automatically return Collective to the center.
- Cyclic: tilting rotor- thrust vector. Keyboard W / S / A / D from P5.7.155 changes persistent attitude trim in steps; release does not compare machine to 0 °. Long hold speeds up the travel rate. Forward / lateral acceleration is created by the horizontal component of the draw; at the same time the vertical component decreases.
- Ground effect: function of actual AGL and rotor diometer, not fixed screen altitude.
- ETL / translation lift: depends on airspeed; the wind changes the airspeed vs ground speed.
- Reaction torque: depends on rotor power / collecting a rotor architecture. TANDEM / COAXIAL / INTERMESTING do not use the same generic torque as single- main / tail configuration.
- Gross mass / damage / fuel: Resolved aircraft profile transfers weight, powerplant / control metadata and damage coupling to the same runtime model.
Heading 0 ° means forward vector +Y. This is the same axis as canonical nose model and loadout preview.
3.3 Ballistics and terminal effects
Canonical schema has authority CANONICAL_TECHREF_PLUS_EXPLICIT_SIMULATION_MODEL and requires separation weapon → launcher → projectile/missile → warhead → fuze. Guided weapons may have additional guidance / seeker / acquisition / LOS / target- loss / terminal-guidance data.
Runtime today: shaded weapons state creates projectile / missile entities from canonical launch speed, range / lifetime, guidance and target data; guided fire passes through target / sensor / LOS gate and impact / terminal path subsequently changes shaded world / vehicle / passenger / structure state. This is a truly implemented path for both renderers.
Schema prepared for deeper physics: drag model, ballistic coefficient, gravity model, dispersion, air density, altitude, wind and temperature- if-modeled are canonical fields. The Bible does not claim that every project already uses a full 6-DOF / environment integrator; the unfilled or unimplemented parts remain explicit baseline / PENDING.
Armor penetration fail-closed: numerical RHA penetration is accepted only from explicit primary-source reference condition. If the source-backed penetration or target armor reference is missing, runtime will go to QUALITATIVE_EFFECT_ONLY/SOURCE_BLOCKED; may not produce fictional mm RHA from a qualitative "anti-armor 'claim. I source-backed RHA comparison is only a reference- condition gate, not a claim about an accurate compost / RHAe map of the hit-sector.
Accurate speeds, shots, penetration and effects are not copied in this Bible. Belongs to canonical TECHNREF .data and source of audits where each figure is designated SOURCE _ FACT / SIMULATION _ BASELINE / PENDING.
3.4 Construction of buildings and structural damage
Buildings aren't all the same "target" anymore. Runtime uses StructuralDamageAuthority and canonical structural-material profiles (12 currently registered archetypes / profiles in the data authority). The lightweight bamboo / wooden hut, the unreinforced masonry and the reinforced concrete therefore respond differently to the same intervention.
- light construction: small HE / rocket threat may cause severe structural collapse;
- Masonry: greater resistance, fragmentation and local damage without automatic destruction;
- Reinformed concrete / harden: higher structural resistance and less relative damage at the same intervention.
Partial structural damage is a condition that can persist; it is not used universal "non-vehicle hit = destruction."
3.5 WORLD, LOS and cover
The height of the terrain, water, buildings and foliage are canonical WORLD entities. Buildings and foliage can affect LOS, cover, concealment and detection; the damaged structure can change the state of the world and the rubble / obstacle logic.
3.6 Player flight groups and NPC mission authority
PLAYER flight supports group routes A / B and SOLO members. Group waypoint command is replicated only by members of the group; REGROUP returns members to a common formation. Each wingman consumes his own ammunition and uses his own aircraft / model assigment.
npc_runtime_policy always has authority=MISSION_AUTHOR and player_editable=false. Runtime combines mission default with instance / asset override and stores the resulting policy into the internal entity / placement runtime state. This separates the player Hangar from the developer-autohered ALLY / OPFOR configuration.
3.7 Persistent and deterministic contract
Flight / world / mission systems store the status over snapshot / restore instead of reconstruction from the render. Simulation state is authority and renderer is consumer. Random environmental effects shall not be introduced as uncontrolled frame- rate-dependent changes if they break up replay / regression determinism.
P5.7.155 - persistent cyclic, low-level IGE and hover trim
GS2D / GS2K share one incremental keyboard control law. W / S + A / D holds the command after release and has approximately ± 44 ° persistent trim opening; R / F holds the collective and tap / hold have a different progressive speed with an immediate first step. The rotor thrust is not recalculated according to the maximum trim limit: the horizontal and vertical component is directly derived from the current pitch / roll through the unit sin / cos burst vector, for example, the 10 ° tilt has the same physical effect regardless of the permitted maximum trim. Collision Avoidance above the plane does not create a hidden altitude hold. The IGE increases efficiency and dampens descent only aerodynamically. AUTO HOVER uses a short capture transition and then a constant equilibrium collective; a stable hover up to 15 m AGL provides a common readiness gate for sling / hoist / fast- oil runtime.
P5.7.135 - body-frame controls, AP and wingman safety
Horizontal cyclic inputs are transformed according to current headting. After yaw change thus W / S and A / D immediately changes direction of control force together with helicopter; the current ground velocities can physically recharge, but the control vector does not remain in the historical world-space direction.
Waypoint AP uses the same flight model as manual control. Guidance includes speed hold, waypoint capture / braking, AGL terrain following and forward field sampling. Collective / torque is not thrown at zero in the normal correction.
Wingman safety is a separate task-independent layer: soft separation 90 m, hard developer 48 m, preferred distance from PLAYER 115 m and vertical separation 12 m Values are gameplay default. The conflicting AI will temporarily evade and then continue in the original draw.
P5.7.135 SAVE / PROFILE / ROSTER
GS2D and GS2K use separate strict currez- save namespace; runtime migration and fitness fallback are prohibited. PLAYER portrait is a persistent part of the pilot record (portrait_id + asset reference).
DEVELOPER / test save fixture are deliberately diverse for QA roster: each four-member wingman squadron uses four different ranks, four different portraits and four different award / ribbon combinations. The same contract applies to GS2D and GS2K. New current profiles generate wingmans with the same perflight diversity; closed KIA / MIA / RETIRED identities are not regenerated.
3.x P5.7.157 - external operations, mass and defensive crew
game_gs2000_external_ops.py is a common GS2D / GS2K authority for onboard personnel, MEDEVAC, HOIST / FAST ROPE, sling load and door- gunner defensive AI. Crew inside the helicopter is not a self-repatriated character.
- Each onboard person adds its runtime mass; the health status of KIA does not remove the body weight.
- External sling cargo adds full cargo mass to the flight model. Pickup / drop changes gross mass instantly.
- AUTO HOVER uses capture + equilibrium collective. External-ops readability requires stable low hover, standard up to 15 m AGL.
- Ground effect changes rotor efficiency / aerodynamic damping, never moves the Collective Lever for players.