ArPhEx Vehicle Damage Patch 2.5.2 — critical Arachnoid repair
Date: 2026-07-03
Targets: Minecraft 1.20.1 / Forge 47.4.20 / ArPhEx 5.0.2 / Superb Warfare 0.8.9 final

Confirmed defects repaired
1. Run-up/launch ground-check conflict
   Stable ground is checked when the run-up starts. A one-call token tied to the exact
   Arachnoid authorizes the completed run-up; no generic boolean/reflection bypass remains.

2. Run-up/launch cooldown mismatch
   The run-up used 75% of the configured cooldown while the actual leap required 100%,
   producing repeated cinematics that could not launch. Both now use the same cooldown.

3. Duplicate same-tick run-up updates
   Multiple Forge paths could update the run-up during one game tick and apply movement
   more than once. Each run-up now processes a given tick only once.

4. Silent handoff failures and infinite loops
   Handoff success is verified from the actual pounce NBT arm. A rejected handoff is logged
   and receives a two-second backoff instead of immediately restarting the cinematic.

5. Green-rush starvation by normal pounce
   The escalation controller no longer overwrites the green-rush timer every tick while a
   pounce/latch is active. The accumulated health-scaled cooldown is preserved.

6. Incomplete attack mutual exclusion
   The green-rush start gate now sees the full normal-pounce lifecycle: preparation,
   scripted flight and latch. It cannot start halfway through a long pounce.

Deep-audit decision: aborted-rush retry policy preserved
   Read alone, its timestamp arithmetic appears inconsistent with the controller's fixed
   2000/2400-tick gate. In the complete event order, BossEscalationController first applies
   the health-scaled reservation and then LowHealthAirRaidController consumes it. Together,
   they produce the intended delayed retry. The 2.5.1 policy was therefore retained exactly.

Preserved behavior
- Pounce and green rush cannot run simultaneously.
- Pounce still requires stable ground and low vertical velocity at reservation time.
- Green-rush recovery continues blocking a normal pounce until recovery ends.
- Finish/abort paths restore gravity, collision, sprinting and glow state.
- Forge @Mod registration is preserved and verified.
- Non-Arachnoid systems are byte-for-byte unchanged except the mod version banner.

Expected log sequence for a successful pounce
ARACHNOID CINEMATIC RUN-UP START
ARACHNOID CINEMATIC RUN-UP COMPLETE
SCRIPTED ARACHNOID POUNCE START
POUNCE HANDOFF ACCEPTED

Expected green-rush marker at <=50% health when ready
GREEN ASCENSION START
