Vault Re-Alignment

2026-06-09 23:26:20 -07:00
parent a7405c3f38
commit da522efe7a
63 changed files with 119048 additions and 15 deletions
@@ -0,0 +1,33 @@
+using Unity.Entities;
+using Unity.Mathematics;
+
+namespace ProjectM.Simulation
+{
+    /// <summary>
+    /// MC-1 — server-only Charger lunge state (a KnockbackState SHAPE-twin). Component PRESENCE is the Charger
+    /// discriminator (no enum / brain byte — honours the Burst cross-assembly-enum rule; EnemyAISystem is Bursted):
+    /// a Husk variant baked with LungeState is driven by the Charger branch, every other Husk by the Grunt branch
+    /// (which excludes these via <c>.WithNone&lt;LungeState&gt;()</c>). On a wind-up commit the Charger LOCKS
+    /// <see cref="Dir"/> toward the target and travels at <see cref="Speed"/> until <see cref="UntilTick"/> — dealing
+    /// contact damage if it connects, or staggering into a punish window if it whiffs (wall-stop or overshoot).
+    /// NOT a <c>[GhostField]</c> (the lunged position replicates via the stock LocalTransform variant, like
+    /// KnockbackState). All ticks via <c>TickUtil.NonZero</c>; compared with <see cref="Unity.NetCode.NetworkTick"/> only.
+    /// </summary>
+    public struct LungeState : IComponentData
+    {
+        /// <summary>Fixed planar lunge heading, locked at commit (world XZ -> float2 x,y).</summary>
+        public float2 Dir;
+
+        /// <summary>Lunge speed (world units/s); only meaningful while <see cref="UntilTick"/> is active.</summary>
+        public float Speed;
+
+        /// <summary>Raw tick the lunge ends (NonZero). <c>0</c> = not lunging. Active while .IsNewerThan(serverTick).</summary>
+        public uint UntilTick;
+
+        /// <summary>Raw tick the whiff-stagger punish window ends (NonZero; set at BOTH whiff sites). 0 = not
+        /// staggered — or already punished: HealthApplyDamageSystem zeroes it when the first player-sourced hit
+        /// lands so a window counts ONCE in DevTelemetry.ChargerWhiffPunishesLanded. The attack lockout itself
+        /// rides EnemyAttackCooldown.NextAttackTick; this field only scores the punish.</summary>
+        public uint StaggerUntilTick;
+    }
+}