Equipment: weapon-granted abilities + gear mods (DR-027 Phase 1)

Equipment slots reusing the AbilityRef/StatModifier machinery: EquipmentSlot [GhostField] buffer (index=slot), server-only event-driven EquipSystem (RPC). Weapon -> AbilityRef.Id swaps the attack (prefab + base stats, prediction-correct); gear -> StatModifiers tagged a reserved per-slot EquipSourceId, stripped target-agnostically via RemoveBySourceId. Item mods are INLINE on ItemDefBlob (a nested BlobArray reads empty under the by-value TryGetItem copy). Atomic equip-over swap (no item loss); DefaultAbility restores the unarmed ability on weapon-unequip. Client keys + build-safe hooks; HUD equipment panel + click-to-equip. 4 catalog weapon/gear items wired + re-baked.

Play-validated host+client: weapon equip swaps AbilityRef on both worlds, gear folds into EffectiveCharacterStats, unequip reverses + restores DefaultAbility, all replicated to the owner. See DR-027.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Assets/_Project/Scripts/Simulation/Items/DefaultAbility.cs

@@ -0,0 +1,17 @@
+using Unity.Entities;
+
+namespace ProjectM.Simulation
+{
+    /// <summary>
+    /// The player's "unarmed" / base ability id, baked from PlayerAuthoring.PrimaryAbility. Restored into
+    /// <see cref="AbilityRef"/>.Id by EquipSystem when a weapon is unequipped. NOT replicated (it never changes,
+    /// so a [GhostField] would waste snapshot bytes and there is no client consumer). AbilityRef itself cannot
+    /// serve double duty because EquipSystem overwrites AbilityRef.Id when a weapon is equipped — this preserves
+    /// the immutable default to fall back to. Server-read only.
+    /// </summary>
+    public struct DefaultAbility : IComponentData
+    {
+        /// <summary>The <see cref="AbilityId"/> (as a byte) the player fires with no weapon equipped.</summary>
+        public byte Id;
+    }
+}