phase(N.4) Adjustment 6: add PartOverrides + HiddenPartsMask to WorldEntity

Resolves Adjustment 4 (Option A): WorldEntity now carries the server-
sent AnimPartChange data as PartOverrides and a HiddenPartsMask bitmask.
EntitySpawnAdapter.OnCreate populates AnimatedEntityState from these
fields at spawn time. GameWindow's CreateObject handler converts the
network-layer AnimPartChange records into lightweight PartOverride
structs.

This unblocks Task 22: the WbDrawDispatcher can now resolve per-part
GfxObj overrides and hidden-part suppression from entity state.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/AcDream.App/Rendering/GameWindow.cs

@@ -2407,6 +2407,19 @@ public sealed class GameWindow : IDisposable
                 SubPalettes: ranges);
         }
 
+        AcDream.Core.World.PartOverride[] entityPartOverrides;
+        if (animPartChanges.Count == 0)
+        {
+            entityPartOverrides = Array.Empty<AcDream.Core.World.PartOverride>();
+        }
+        else
+        {
+            entityPartOverrides = new AcDream.Core.World.PartOverride[animPartChanges.Count];
+            for (int i = 0; i < animPartChanges.Count; i++)
+                entityPartOverrides[i] = new AcDream.Core.World.PartOverride(
+                    animPartChanges[i].PartIndex, animPartChanges[i].NewModelId);
+        }
+
         var entity = new AcDream.Core.World.WorldEntity
         {
             Id = _liveEntityIdCounter++,
@@ -2416,6 +2429,7 @@ public sealed class GameWindow : IDisposable
             Rotation = rot,
             MeshRefs = meshRefs,
             PaletteOverride = paletteOverride,
+            PartOverrides = entityPartOverrides,
         };
 
         var snapshot = new AcDream.Plugin.Abstractions.WorldEntitySnapshot(

src/AcDream.App/Rendering/Wb/EntitySpawnAdapter.cs

@@ -39,15 +39,10 @@ namespace AcDream.App.Rendering.Wb;
 /// </para>
 ///
 /// <para>
-/// <b>Adjustment 4</b>: <see cref="WorldEntity"/> does not currently expose
-/// <c>HiddenPartsMask</c> or <c>AnimPartChanges</c> as direct fields (those
-/// live on the network-layer spawn record and are consumed upstream before
-/// the <see cref="WorldEntity"/> is built). When those fields are promoted to
-/// <see cref="WorldEntity"/>, <see cref="OnCreate"/> should call
-/// <see cref="AnimatedEntityState.HideParts"/> and
-/// <see cref="AnimatedEntityState.SetPartOverride"/> here. For now the mask
-/// stays at 0 (no parts hidden) and no part overrides are set — the draw
-/// dispatcher falls through to Setup defaults for every part.
+/// <b>Adjustment 6</b> (resolved Adjustment 4): <see cref="WorldEntity"/> now
+/// carries <see cref="WorldEntity.PartOverrides"/> and
+/// <see cref="WorldEntity.HiddenPartsMask"/>. <see cref="OnCreate"/> applies
+/// both to the created <see cref="AnimatedEntityState"/>.
 /// </para>
 /// </summary>
 public sealed class EntitySpawnAdapter
@@ -125,11 +120,10 @@ public sealed class EntitySpawnAdapter
         var sequencer = _sequencerFactory(entity);
         var state = new AnimatedEntityState(sequencer);
 
-        // Adjustment 4 placeholder: when WorldEntity gains HiddenPartsMask +
-        // AnimPartChanges fields, apply them here:
-        //   state.HideParts(entity.HiddenPartsMask);
-        //   foreach (var apc in entity.AnimPartChanges)
-        //       state.SetPartOverride(apc.PartIndex, apc.NewModelId);
+        // Adjustment 6: WorldEntity now carries PartOverrides + HiddenPartsMask.
+        state.HideParts(entity.HiddenPartsMask);
+        foreach (var po in entity.PartOverrides)
+            state.SetPartOverride(po.PartIndex, po.GfxObjId);
 
         _stateByGuid[entity.ServerGuid] = state;
         return state;

src/AcDream.Core/World/WorldEntity.cs

@@ -55,4 +55,27 @@ public sealed class WorldEntity
     /// visible trunk, producing "partial passthrough" bugs.
     /// </summary>
     public float Scale { get; init; } = 1.0f;
+
+    /// <summary>
+    /// Server-sent part-swap overrides from <c>AnimPartChange</c>. Each entry
+    /// replaces a Setup part's GfxObj with an alternate model (clothing, weapons,
+    /// helmets). Carried on the entity so <c>EntitySpawnAdapter</c> can populate
+    /// <c>AnimatedEntityState</c>'s override map at spawn time. Empty for atlas-
+    /// tier entities.
+    /// </summary>
+    public IReadOnlyList<PartOverride> PartOverrides { get; init; } = Array.Empty<PartOverride>();
+
+    /// <summary>
+    /// Bitmask of hidden Setup parts. Bit <c>i</c> set hides part <c>i</c> at
+    /// draw time. Sourced from the server's <c>CreateObject</c> record when
+    /// present. Zero (no parts hidden) is the default.
+    /// </summary>
+    public ulong HiddenPartsMask { get; init; }
 }
+
+/// <summary>
+/// Lightweight value type for a server-sent <c>AnimPartChange</c> (part index
+/// → replacement GfxObj id). Decouples <c>WorldEntity</c> (Core) from the
+/// network-layer <c>CreateObject.AnimPartChange</c> type.
+/// </summary>
+public readonly record struct PartOverride(byte PartIndex, uint GfxObjId);