HUD & UI Implementation Plan

Problem, Scope & Execution Boundary

UI ปัจจุบันเป็น UMG widgets ที่ถูกเปิดโดย GameInstance subsystems แยกกันและยังไม่มี screen stack กลาง ขณะที่ target design ต้องรองรับ menu navigation, modal priority, controller focus, dynamic glyphs, multiplayer input blocking, SP pause, localization และทุกระบบที่ยังพัฒนาไม่ครบ แผนนี้จึงสร้าง foundation ก่อน แล้วค่อยย้าย screen แบบ vertical slices โดยไม่ตัดระบบเดิมพร้อมกันทั้งหมด

Verified Current Implementation vs Target

Gate G0 Baseline & Review Evidence

Decision and evidence register

Verified legacy asset-reference snapshot

Config snapshot: DefaultGame.ini points HUD and inventory soft classes to WBP_HUD and WBP_Inventory. Lambeer.Build.cs includes UMG/Slate/SlateCore but not CommonUI/CommonInput, and Lambeer.uproject does not enable CommonUI. Xbox and PlayStation glyph assets exist under /Game/Lambeer/UI/ControllerGlyphs/.

Frozen migration/rollback strategy — owner approved 2026-09-06

1. Make a source-control checkpoint limited to the verified HUD/UI source, config, and seven legacy widget assets; do not mix unrelated dirty assets into the migration checkpoint.
2. Create the CommonUI root and new screens alongside legacy paths. Do not rename, move, delete, or redirect WBP_HUD, WBP_Inventory, or WBP_InteractionPrompt during G1–G2.
3. Switch through the existing soft-class config/facade seam only after the new root compiles and a missing-class path fails explicitly.
4. Before each legacy removal, repeat Asset Registry dependency/referencer capture, fix config/C++ fallback paths, run redirector validation, compile Editor/Game/Server, and complete cook/package smoke.
5. Rollback by restoring the legacy soft-class config and compatibility facades; remove redirectors only after the matching user PIE regression result is recorded.

User-supplied PIE baseline evidence

Unreal MCP log corroboration: user-run New Editor Window PIE started on /Game/Lambeer/World/Maps/L_Dev_Sandbox/L_Dev_Sandbox at 20:12 and 20:13 local time with one dedicated-server world and two client worlds. The logs prove session topology/start/teardown only, not visual or interaction correctness.

Reviewed user-only baseline acceptance matrix

Gate G1 Implementation & Verification Record

Implemented and verified without PIE

Completed through Unreal MCP: root Blueprint (UI-FND-005)

1. Create Widget Blueprint /Game/Lambeer/UI/HUD/WBP_UIRoot with parent class ULambeerUIRootWidget.
2. Add four full-screen children in this paint order and mark each Is Variable: Layer_GameHUD as Overlay; Layer_Screens as CommonActivatableWidgetStack; Layer_Modals as CommonActivatableWidgetStack; Layer_Toast as Overlay. Names and types must match exactly.
3. Anchor every layer to fill the root, then Compile and Save. There is no required Blueprint graph logic.

Fixture assets and owner-run PIE complete (UI-FND-010)

1. Complete 2026-09-07: /Game/Lambeer/UI/Tests/WBP_G1_DummyScreen and WBP_G1_DummyModal are parented to ULambeerActivatableWidget, contain two focusable buttons, and implement GetInitialFocusTarget. Both compile and are saved.
2. Complete 2026-09-07: /Game/Lambeer/UI/Common/Input/DT_UI_CommonActions and BP_LambeerCommonUIInputData provide the global CommonUI Accept/Back actions; Config/DefaultGame.ini selects the generated Input Data class.
3. Owner result 2026-09-07: the initial run passed all checks except Escape because CommonUI Input Data was missing. After the action table and Input Data class were configured and the Editor restarted, the owner reran the test and confirmed Escape closes the top modal first, then the underlying dummy screen. The complete requested G1 matrix is reported passing.
4. Start PIE yourself. Open the console and run UI_G1PushTestWidget /Game/Lambeer/UI/Tests/WBP_G1_DummyScreen.WBP_G1_DummyScreen_C false, then UI_G1PushTestWidget /Game/Lambeer/UI/Tests/WBP_G1_DummyModal.WBP_G1_DummyModal_C true. These development-only commands avoid temporary level/PlayerController Blueprint wiring.
5. For KBM, Xbox, and PlayStation controllers, verify focus starts on the first button, directional navigation cannot escape the top modal, Back closes the modal before the screen, the cursor/input mode is correct, and closing the final layer restores gameplay input.
6. Repeat once in standalone/single-player and once in the current multiplayer PIE topology. While the screen is open, run UI_G1SetPauseRequested true, verify only standalone pauses, then run UI_G1SetPauseRequested false. Multiplayer must never pause the server. Stop PIE and report pass/fail per device plus any log warnings or screenshots.

Optional recovery commands: UI_G1PopTestLayer true pops the modal; UI_G1PopTestLayer false pops the screen. G1 is closed from the owner-reported results above; these commands remain available for future regression diagnosis.

Gate G2 Implementation & Handoff Record

Implemented evidence

Owner PIE record used to close G2

1. Complete: Editor rebuild and compile/save of WBP_UIRoot and WBP_G2_ComponentGallery were required before the scale and culture helpers could be verified in PIE.
2. Complete 2026-09-07: Regular, Medium, SemiBold and Bold were imported as Font Face assets under /Game/Lambeer/UI/Common/Fonts/; runtime composite font FF_UI_Primary contains the four named faces and OFL.txt remains in source control.
3. PASS 2026-09-08 — step 5.2: owner confirmed Thai glyph rendering after FF_UI_Primary was assigned to all 17 gallery TextBlocks.
4. Step 5.4 PASS — owner confirmed 2026-09-08: HUDScale after the runtime Fill/Fill fix, then SafeZoneScale and TextScale. Regression command remains UI_G2SetPresentationScales HUDScale TextScale SafeZoneScale. Increased HUD Scale must grow inward: top-left grows down/right, top-right down/left, bottom-left up/right and bottom-right up/left. Windows Safe Zone comparison uses r.DebugSafeZone.TitleRatio 0.90 and r.DebugSafeZone.Mode 1 between scale 0.0 and 1.0, then restore TitleRatio 1.0 and Mode 0. Full-bleed visuals are not the Safe Zone observation target. No approved maximum HUD scale or overlap policy is established.
5. Step 5.7 PASS — owner confirmed Thai 2026-09-08: UI_G2SetCulture th and UI_G2SetCulture en switch the four bound Gallery samples. Remaining Gallery development labels are not covered by those String Table bindings. The widget references ST_UI_Common_EN; Thai is resolved from Game.locres.
6. Deferred by owner 2026-09-08: all physical Xbox and PlayStation glyph/focus/navigation checks wait until the controllers are available. Preserve them as unverified; do not record failure or pass. This does not reopen G2.

Gate G3 Implementation & Handoff Record

How to test prompt quantity / denied / hold (checklist 8)

PromptHost already projects near the target. Quantity and denied use live interactables. Hold has no authored duration in this sandbox. Lambeer.SpawnPickup and Lambeer.GiveItem require a host pawn; a Dedicated Server client Preview prints needs host, and the Dedicated Server window usually has no pawn.

1. Quantity (Dedicated Server clients): look at Pickup_L1810_Test or the sledgehammer. The prompt should read Pick up {name} plus x1. HUD appends xN whenever quantity is greater than 0; a qty-1 pickup must not invent a larger count. Quantity x10: start Listen Server PIE instead, then on the host window run Lambeer.SpawnPickup Item.Wood 10 and look at that cube for x10.
2. Denied: do not pick up L1810 first. Pick up the sledgehammer so both hands are locked, then look at the remaining L1810 cube. Pickup CanInteract is true if any hand is empty or inventory CanFit. Typical spawn has no worn storage, so pockets cannot fit and the prompt should stay visible with the second line Cannot interact. Pressing E must not take it. Optional, same client: Lambeer.InteractDump should print can=no for that pickup. If pants/backpack are already equipped, leftover pickups still go to pockets; unequip that storage or fill on Listen Server (Lambeer.GiveItem is also host-only).
3. Hold: no G3 interactable implements GetInteractHoldDuration above zero. Bed, pickups and barber are tap actions. The HUD would append HOLD Ns only when an interactable returns a duration. Missing HOLD text on Sleep/Pick up is not a HUD bug. Owner closed G3 without a debug hold fixture; HOLD presentation waits for a real hold action.

Owner-only PIE checklist after Editor rebuild

1. Hold one item: hold Middle Mouse for more than the item windup, then release. Exactly one pickup should leave the hand and remain collectible after landing.
2. Release before the windup completes: the hand and world item count must remain unchanged.
3. During windup click Left Mouse, then release Middle Mouse: nothing is thrown. Repeat with Right Mouse; cancellation must not toggle ADS on mouse release.
4. Hold two different items: only the right item is thrown. With only the left hand occupied, the left item is thrown.
5. Hold Wood ×10: one throw leaves Wood ×9 in the same hand and creates one Wood pickup. Recover it and check conservation of the total count.
6. Compare a short completed windup with a long hold: launch speed must stay constant. Change one item's authored windup/speed and confirm that item uses its own values.
7. Swap, stow or drop an item while winding up; releasing afterward must not throw a replacement item.
8. Repeat near a wall, on a client and with another player observing. Check blocked spawn retains the item, flight/landing are visible and no duplicate pickups appear.
9. L_Dev_Sandbox already has BP_Bed_Test near PlayerStart. Press the same Interact key used for pickups (IA_Interact, E) while looking at the cube; standing still is not required to start sleep. The screen should dim slightly while Sleeping. Energy/Sleep should recover. Move after sleep has started, take damage or destroy the bed: recovery must stop and the dim must clear. The cube is a functional bed placeholder; final bed art and sleeping animation are not implemented. Pick up the placed Sledgehammer, confirm two-hand occupancy and the melee reticle, then throw it.

Backend decisions required before implementation

Use the existing canonical feature decisions below; no gameplay tuning or approval state is inferred. Pending questions have been sent to the owner.

Backend source progress, 2026-09-10: server weather intensity, shelter queries, survival rates/hysteresis, body/lens wetness, held-item and worn-clothing rain/swim/dry, bed interaction and HUD survival delegates are added. ApplyDamage can drive the blood overlay. Owner reported Lambeer.Damage 10 on a dedicated-server client on 2026-09-10, then nearby 2 m / LOS hits, low-health edges, rain-lens shelter, and prompt quantity/denied the same day. L1810 instance ammo and timed field inspection are in source; owner reported that inspection working the same day. MCP verified the sandbox G3 actors are saved. Owner decided rain VFX is out of G3. Skeletal L1810, magazine-as-item and material wet-look are G3.2. G3 is closed.

• Combat: Melee trigger is confirmed as holding a melee weapon. Check chords, durations and press-once/sequential behavior are now canonical in field inspection inputs. Owner confirmed right-hand firearm then left-hand firearm on 2026-09-09. Per-firearm duration, discarding newly collected results on interruption and actual item truth are confirmed. IA_Throw exists; MCP verified its MiddleMouseButton mapping. Throw lifecycle is confirmed in the HUD input contract. Runtime source: DA_Item_L1810 / Item.Weapon.L1810, capacity 18. G3 new stacks used full mag / empty chamber; G3.2 new stacks spawn with no magazine. Timed inspection applies HUD knowledge only after the full sequence. Owner reported Shift+R / magazine inspection working on 2026-09-10. Debug UI_G3ObserveWeapon remains. G3 used Engine-cube world/held visuals; G3.2 assigned SKM_L1810 on 2026-09-11. Owner reported skeletal world/held/back visuals and magazine-as-item on 2026-09-11.
• Blood: owner confirmed maximum 2 metres to the pawn view with no intervening obstruction for nearby impacts. Hits on the local pawn always start that client’s overlay. Owner reported Lambeer.Damage 10 on a dedicated-server client on 2026-09-10, then nearby 2 m / LOS hits and low-health 30/20/10 edges the same day. The confirmed 2-second hold / 5-second fade remains unchanged.
• Rain/wetness: follow the owner-approved weather/shelter decision. Occupied clothing slots wet from rain. MCP placed a G3 shelter volume and tagged roof in L_Dev_Sandbox; map save verified 2026-09-10. Owner reported UI_G3SetRain lens droplets plus shelter on 2026-09-10. G3 rain presentation is HUD droplets + UI_G3SetRain only. Rain VFX is out of G3. Material wet-look mapping is G3.2.
• Survival: Energy/Sleep/Immunity rates and fatigue hysteresis are approved; interact with a bed starts sleep. Injury and treatment tuning remain unresolved. Approved starting values are in the survival decision.

Owner PIE notes (2026-09-08)

• Slots 3–0 with Wood: reported working.
• UI_G3NotifyBlood, UI_G3NotifyWet 1, UI_G3PushStatus Bleeding 2 1: reported working.
• UI_G3AddMarker Death: later PIE reported working (compass/minimap diamonds).
• Later same-day PIE still failing (not fixed in that session): UI_G3GiveBackWeapons; ADS does not hide the center square reticle; UI_G3ObserveWeapon does not put an item in a hand; eight bars remain gray. Session tooling: docs/handoff-g3-hud.md. Owner later reported those HUD close items passed on 2026-09-10; see checklist 1–7.

Implemented evidence

Handedness debug commands — 2026-09-08

UI_G3GiveOneHanded [Key=1] uses the existing Item.Weapon.MockBack OneHanded fixture. UI_G3GiveTwoHanded [Key=2] uses Item.Weapon.MockTwoHanded, explicitly TwoHanded. Key accepts 1–9 or 0 as printed on the keyboard: 1–2 equip a back slot, 3–0 bind an inventory fixture to use-quick. Both commands execute on the server for the owning client. For Q3–Q0, an already-held matching fixture is bound without granting a duplicate; failed grants report weight/cell usage. They are disabled in Shipping/Test, preserve conflicting assignments and report capacity/assignment failure in the client console. Mocks have no mesh; inspect the hand cards. The TwoHanded fixture copies the existing mock's test weight/stack/durability settings, not production weapon tuning; real Data Assets remain unchanged.

• OneHanded scenario, empty target slots and sufficient capacity: UI_G3GiveOneHanded 1, UI_G3GiveOneHanded 2, then keys 1→2. Both hands should be occupied; key 1 returns only Back1. For use-quick instead, use UI_G3GiveOneHanded 3 with key 1→3 and verify both hands.
• TwoHanded scenario, separate clean setup: UI_G3GiveOneHanded 1, UI_G3GiveTwoHanded 2, then keys 1→2→1. Entering TwoHanded stores the outgoing weapon in the selected occupied slot and locks the sibling hand; subsequent Q1/Q2 input follows selected-slot storage/exchange. UI_G3GiveTwoHanded 4 tests a use-quick two-handed item instead. An ordinary two-handed item without a back origin must be stowed manually before another item can replace it.
• Clear/drop earlier test fixtures or use a fresh setup between scenarios if the existing inventory capacity is reached. Repeated setup must not overwrite another assignment. Run on dedicated-server client as well as standalone/listen server; owner results remain pending.

Owner PIE steps

1. Compile the Editor target after the latest C++ HUD pass, then start PIE yourself on L_Dev_Sandbox.
2. Confirm eight colored bars with icons, no numbers, no hit marker. Bars should fill from GAS without needing UI_G3NotifyBlood first; re-check after respawn and confirm subsequent attribute changes update the bars.
3. Console: UI_G3GiveBackWeapons from the owning client in dedicated-server PIE (also re-check standalone/listen server), then keys 1 and 2 to hold both one-handed Mock Back Weapons simultaneously. Confirm each back slot becomes empty when its item is drawn; the held item appears only in Hands. Press the same key again to return it; test 1→2→1 (only Back1 returns; Back2 stays in hand) and 1→3 (Wood alongside a one-handed weapon), including full inventory and two identical weapons with distinct durability. With only Q1 assigned, draw using 1 then press empty Q2: confirm storage in Q2, Q1 clears and the hand empties. With right-hand A and Q2 B, press 2 and verify exact-stack exchange (including durability). Empty Q1/Q2 with no held item is a no-op; missing Q3–Q0 items leave held state unchanged. Slots 3–0 remain Wood use-quick.
4. ADS: quick click Right Mouse to toggle; hold Right Mouse for Shoulder Aim; or console UI_G3ToggleADS. ADS hides the reticle both away from and while facing an interactable; exit ADS restores the appropriate reticle. The projected prompt is a separate widget.
5. UI_G3AddMarker Death should show a red diamond on the compass tape and minimap ring, 4 m ahead, plus an on-screen hint.
6. UI_G3ObserveWeapon 0 1 8 should change the bottom-left right-hand card from UNKNOWN to Chamber 1 / Mag 8. If the hand is empty, the server gives/takes the mock into that hand first. Also test UI_G3ObserveWeapon 1 1 8 for the left hand; wait for replication. Mock has no assigned mesh, so verify the hand card rather than a visible weapon model. Change held item/quantity and confirm UNKNOWN returns. Check full inventory, two-handed occupancy and repeated give commands for clear feedback/no replacement of occupied slots.
7. Map save verified 2026-09-10: the G3 actors are already in saved L_Dev_Sandbox. After Editor rebuild if C++ changed: pick up Pickup_L1810_Test (cube near the sledgehammer, negative Y) or UI_G3GiveL1810 / Lambeer.GiveItem Item.Weapon.L1810. Bottom-left hand card should read L1810 with Chamber UNKNOWN and Mag UNKNOWN immediately; no separate magazine item is required in this slice. Click the PIE viewport so it has keyboard focus. Stand still: Shift+R should print a cyan “Checking chamber (3s)” then Chamber 0; Alt+R should print “Checking magazine (5s)” then Mag 18. Both use the authored Enhanced Input chords (R + IA_Shift / R + IA_Alt); there is no extra magazine bind. If the gun is not in a hand, cyan “No firearm in hands to inspect.” Moving, taking damage, dying or swapping the held item before the timer finishes must leave UNKNOWN. Lambeer.Damage 10 should print a red “Blood overlay”, splash a full-screen red tint (2 s hold / 5 s fade), and show ok in the console. Compare with UI_G3NotifyBlood if isolating the overlay. Owner-reported pass 2026-09-10: L1810 field inspection and Lambeer.Damage 10 on a dedicated-server client Preview window.
8. After Editor rebuild: UI_G3SetRain 1 should start lens droplets while unsheltered at PlayerStart. Worn clothing and held items should gain WetAmount (no wet mesh look until G3.2 materials expose it). Walk +X under the cube roof around (400, 0) to enter RainShelter_G3Test; wetting from rain should stop. UI_G3SetRain 0 should start the 5-second lens fade. G3 rain presentation is HUD droplets + UI_G3SetRain only; rain VFX is out of G3. Owner-reported pass 2026-09-10: droplets plus shelter.
9. Owner-reported pass 2026-09-10: prompt quantity/denied per checklist 8. HOLD presentation waits for a real hold action.
10. Optional Session Frontend: Tools → Session Frontend → Automation, filter Lambeer.HUD, run those tests. This is an Editor automation pass, not PIE.
11. Xbox/PlayStation results remain deferred. Leftover PIE-UI-001–005 rows stay partial where noted; they do not reopen G3.

Gate G3.2 HUD Visual Follow-through

• UI-HUD-015 — Complete. C++ skeletal pipeline plus MCP-assigned SKM_L1810 on DA_Item_L1810. Owner reported world/held/back skeletal presentation (not a visible Engine cube). Grip pose remains unpolished content. Character holster sockets back_weapon_1 / back_weapon_2 were authored 2026-09-18; per-slot BackHolster1Relative / BackHolster2Relative are now on ULambeerItemDefinition and stay identity until calibrated. Owner PIE for that placement is not claimed. L1810_PhysicsAsset exists on disk but is not assigned to the skeletal mesh; the Engine cube remains the pickup collision proxy.
• UI-HUD-016 — Complete. Tarkov magazine-as-item. Owner reported: new L1810 shows No mag; magazine inspect after Alt+R is 0; load ammo onto mag; 3 s mag install while standing still; move cancels install; RMB remove magazine (3 s) and unload ammo. Data Assets and sandbox pickups were MCP-saved 2026-09-11.
• UI-HUD-017 — deferred by owner. MI_L1810, the magazine MI, and MetaHuman materials have no WetAmount parameter. Do not invent roughness/albedo/drip mapping. WetAmount scalar remains on pawns/stacks. This does not reopen G3.2 015/016.

G3 historical full-mag spawn is superseded for new stacks only; it does not reopen G3. Debug UI_G3ObserveWeapon remains.

Map save verified 2026-09-11 (L_Dev_Sandbox is_dirty false). MCP placed magazine and ammo pickups beside the existing L1810 pickup: Pickup_L1810_Test at (200, −150, 260); Pickup_L1810_Magazine_Test at (240, −150, 260), stack Item.Magazine.L1810 ×1; Pickup_Ammo_9x19_Test at (280, −150, 260), stack Item.Ammo.9x19 ×18.

Manual PIE checklist (owner-reported pass 2026-09-11)

1. Owner-reported pass: Dedicated Server + two client Preview windows. Type cheats in a client Preview console, not the dedicated-server window.
2. Owner-reported pass: UI_G3GiveL1810 or pick up Pickup_L1810_Test: skeletal L1810 in hand and in the world (not a visible Engine cube). Inventory label shows No mag. Shift+R / Alt+R still work; after magazine inspect, Mag is 0.
3. Owner-reported pass: UI_G3GiveL1810Magazine and UI_G3Give9x19, or pick up Pickup_L1810_Magazine_Test and Pickup_Ammo_9x19_Test. Drag ammo onto the mag (count rises). Drag mag onto the gun and stand still 3 s. Moving should cancel. Right-click the gun: Remove magazine (3 s). Right-click the mag: Unload ammo.
4. Owner-reported pass: Holster/draw: skeletal mesh on back as well as the world pickup.
5. Wet-look is not in this gate. Rain remains HUD droplets + UI_G3SetRain.

Gate G4 Core Survival Screens

UI-CORE-001 — inventory activatable lifecycle

C++ in this change set:

• ULambeerInventoryWidget derives ULambeerActivatableWidget. BindWidget names and assignment/magazine/drop logic are unchanged.
• ULambeerInventorySubsystem opens through ULambeerUIManagerSubsystem::PushWidget on UI.Layer.Screen and closes with DeactivateWidget. It no longer calls PresentLegacyWidget, DismissLegacyWidget, or ReleaseKeyboardToGame.
• Delegates bind in NativeOnActivated and unbind in NativeOnDeactivated/NativeDestruct. Back/Close notify the facade so the open map cannot go stale.
• Input mode stays on the UI manager. The widget no longer forces viewport focus or disables its tree. Fallback focus target is Button_Close when Blueprint GetInitialFocusTarget is unset.
• Escape uses the existing CommonUI Back contract. While the screen is open, CommonUI Menu mode blocks the PlayerController IA_Inventory bind. Registering that same UInputAction through RegisterUIActionBinding crashed on 2026-09-12 because CommonUI Enhanced Input support is off (LegacyActionData assert). Tab is consumed by a Slate input preprocessor while the screen is active. Owner-reported pass 2026-09-12: Tab opens and closes; Escape still closes.

Unreal MCP 2026-09-11 (after owner Editor rebuild): PIE was not running. CompileWidgetBlueprint and save of /Game/Lambeer/UI/Inventory/WBP_Inventory succeeded. Parent remains ULambeerInventoryWidget (Common UI Plugin category). GetWidgets still reports 20 widgets including bound Button_Close.

Owner PIE (UI-CORE-001)

1. Owner-reported pass 2026-09-12: Dedicated Server + two client Preview windows. Type in a client Preview window.
2. Owner-reported pass 2026-09-12: Open inventory with Tab. Existing layout still shows hands, Q1–Q0, pockets/containers, weight and Close.
3. Owner-reported pass 2026-09-12: Close with Tab (IA_Inventory again). Escape (CommonUI Back) and Close remain available. After close, movement/look and the game cursor state return.
4. Repeat one drag/assignment you already know works (Wood among hands/pockets and a Q3–Q0 bind). This slice must not lose that logic. Pocket drag/drop already passed 2026-09-08.
5. In this multiplayer topology the world must keep running while inventory is open. Do not treat Xbox/PlayStation as required for this slice.

UI-CORE-002 — inventory command backends

[CONFIRMED 2026-09-11 owner answers] Command rules below are canonical. Stale-selection uses ExpectedItemId (the stack’s ItemId at the requested index). There is no generation token. Server rejects when the index is empty, missing, or holds a different item.

• Merge: dragging the same mergeable item onto another stack combines them up to MaxStack; remainder stays on the source. Durability-tracked items and magazines still do not merge.
• Split: fails unless the same container has an empty slot. Does not merge into an existing same-item stack. Context menu: Split 1, Split half, and Split amount... (typed 1…quantity−1).
• Sort: by display name, weight, or item type, per container (each bag separately). Empty container cells still open this menu.
• Inventory Search: removed from UI, native filtering and the G4.2 contract by owner decision on 2026-09-14.
• Drop: context menu Drop throws the whole stack. Same world pickup as the Drop slot.
• Pickup/store: Clothing equips an empty matching slot (no replace). Weapon goes to an empty hand first. Other types merge incomplete stacks, then an empty storage cell, then an empty hand. bCanHolsterOnBack takes an empty back slot before storage.
• Take All: source inventory → player, filling every player storage container that can fit (TryAddStack / PickContainerWithSpace). Side-by-side loot UI is UI-CORE-003 in G4.2. World-container interact opens inventory loot panels; Take All from those panels uses TryTakeAllFromWorldLoot, not vacuum TransferAllTo on Interact.
• Transfer All: one player container at a time into the linked target, not the whole character. Shown only when LinkedTransferInventory is set.
• Use: from the inventory slot in place. No authored consume/heal/eat fields exist; TryUseStackAt rejects without consuming and logs.
• Equip (menu / Ctrl+RMB / drag onto Worn or Back): automatic or explicit slot. Clothing uses Def->EquipmentSlot. Holsterable Weapon/Tool uses the first empty BackWeapon1 then BackWeapon2; if both are occupied, Equip displaces BackWeapon1. Occupied slots pack the previous worn-storage contents into NestedContents, then move that item into player storage when there is space, otherwise drop it as a world pickup. Drag from loot/death-bag cells onto Worn/Back uses TryEquipStackFromWorldLoot. World pickup/store still does not replace worn clothing.

Context menu still includes Unload ammo / Remove magazine. Owner-reported command pass 2026-09-11 for merge, split, drop, sort, search, Use (no consume), Equip, and pickup routing. Two gaps in that PIE were worn clothing wear slots and Tab-close. Those crashed on the first rebuild (RegisterUIActionBinding / LegacyActionData). Owner-reported pass 2026-09-12: inventory opens without that crash; Tab closes; nine wear slots are visible at the top of Scroll_Containers; sandbox Pants/Glasses/Body Armor/Backpack pickups equip into Legs/Eyes/Armor/Pack. G4.2 now binds the nine Worn targets to designer Box_WornSlots above the container list (not inside the scroll) and replaces the temporary C++ split window with an in-widget overlay. Take All / Transfer All presentation is that G4.2 transfer layout.

Map save verified 2026-09-12 (L_Dev_Sandbox is_dirty false). MCP placed the four existing clothing/equipment pickups on a row opposite the L1810 cubes (positive Y, Z 260): Pickup_Clothes_Pants_Test at (200, 50, 260) Item.Clothes.Pants ×1; Pickup_Clothes_Glasses_Test at (240, 50, 260) Item.Clothes.Glasses ×1; Pickup_Clothes_BodyArmor_Test at (280, 50, 260) Item.Clothes.BodyArmor ×1; Pickup_Backpack_Improvised_Test at (320, 50, 260) Item.Backpack.Improvised ×1. No Head, Torso, Feet, Hands, or Vest Data Assets exist, so those wear slots have no sandbox pickup.

Owner Editor rebuild then PIE (UI-CORE-002)

1. Owner-reported pass 2026-09-12: Close Unreal Editor so UnrealEditor-Lambeer.dll is not locked.
2. Owner-reported pass 2026-09-12: Compile LambeerEditor Win64 Development and reopen this project.
3. Tell the agent the Editor is open again if Unreal MCP should recompile WBP_Inventory.
4. Owner-reported pass 2026-09-12: Dedicated Server + two client Preview windows. Type in a client Preview window.
5. Owner-reported pass 2026-09-12: Tab opens and closes. Escape and Close may still work.
6. Owner-reported pass 2026-09-12: Worn row at the top of the container list. Pickup/Equip of Pants, Glasses, Body Armor and Improvised Backpack into Legs / Eyes / Armor / Pack. Head, Torso, Feet, Gloves, and Vest stay empty until those items exist.
7. Owner-reported pass 2026-09-11: Right-click a stack with quantity > 1: Split 1 / Split half / Split amount. Drop throws the whole stack.
8. Owner-reported pass 2026-09-11: Drag two incomplete Wood stacks onto each other: they merge up to MaxStack.
9. Owner-reported pass 2026-09-11: Right-click a container cell (including empty): Sort by name / weight / type reorders only that bag.
10. Owner-reported pass 2026-09-11: Right-click clothing or a holsterable weapon/tool: Equip. Right-click any item: Use must not consume it.
11. Owner-reported pass 2026-09-11 / clothing pickup 2026-09-12: Pickup: empty clothing slot wears it; occupied clothing slot stores. Weapon to empty hand first. Other items merge then empty cell then hand. Holsterable items take an empty back slot before storage.
12. [OWNER 2026-09-15] Drag clothing/backpack from a death bag or other loot onto Worn slots must equip. Occupied slots store or drop the previous item. RMB Equip and Ctrl+RMB equip from inventory or loot. Ctrl+LMB transfers one stack between the character and an open non-death-bag container. Action hints show those shortcuts. Owner PIE pending after the native rebuild.
13. Take All / Transfer All wait for the side-by-side layout unless a linked inventory is present. This remains UI-CORE-003 in G4.2.

UI-CORE-003 is preserved on Gate G4.2. It owns the approved Character + Container Focus hierarchy, WBP_ContainerTransfer, and context/split overlay presentation. Inventory Search was removed by owner decision on 2026-09-14. Map, death/spawn, pause and settings remain closed G4 tasks.

UI-CORE-004 — world map screen / view model

C++ in this change set. Owner-reported pass 2026-09-12 for the north-up minimap and frozen full-map death-diamond retest. Owner-reported pass 2026-09-13 for pan/zoom/center, shared ping, filter toggles, map↔inventory Tab switching, and the zoom-clip retest. Unreal MCP 2026-09-12 (after owner Editor reopen): created, compiled and saved /Game/Lambeer/UI/Map/WBP_WorldMap. Parent is ULambeerMapScreen. GetWidgets reports an empty designer tree (0 widgets). Runtime layout still comes from the C++ fallback in ULambeerMapScreen::EnsureLayout. DefaultGame.ini MapWidgetClass now points at WBP_WorldMap_C. Unreal MCP 2026-09-12: imported owner-supplied temporary map image as /Game/Lambeer/UI/Map/T_WorldMap_Temporary (1024×576, TEXTUREGROUP_UI, clamp, never-stream). Source file: RawResource/UI/Map/WorldMap_Temporary.jpg. The canvas draws that texture with the same pan/zoom as markers. The image is not geographically registered to L_Dev_Sandbox or any production footprint; TBD-WORLD-001 is unchanged.

• ULambeerMapScreen derives ULambeerActivatableWidget and opens through ULambeerMapSubsystem on UI.Layer.Screen. Opening the map closes inventory and the reverse, so the two screens do not stack.
• Toggle is M via runtime IA_UI_Map_Runtime (or authored IA_UI_Map if present). Menu mode blocks the PlayerController bind, so the map screen uses a Slate preprocessor the same way inventory uses Tab. Escape/Close still use CommonUI Back. Tab from the map switches to inventory.
• The map starts fully revealed: there is no fog of war. Category filters are local on ULambeerHUDAdapter and already feed compass/minimap. The screen exposes All plus one toggle per ELambeerUIMarkerCategory.
• Pan (left-drag), wheel zoom toward the cursor, and Center player are local view state. Zoom 1 is the full bounds; the 32× ceiling is an implementation safety clamp, not an approved gameplay setting. The canvas and map overlay clip paint to bounds so a zoomed image cannot cover the filter list or action row.
• World XY → UV uses optional authored bounds on the widget. Empty/inverted bounds fall back to a square of at least 50 m half-extent captured when the map opens (player-centered, expanded to include then-visible markers) and frozen while the screen stays open. Walking updates the player chevron; it does not recapture bounds, so a death diamond keeps its world UV. Reopening the map recaptures. That fallback is an implementation readability clamp, not a production map size. Production footprint remains TBD-WORLD-001. Temporary image T_WorldMap_Temporary fills world UV 0–1 and pans/zooms with the view. Player/marker positions on that image are not a claimed geographic match.
• Minimap Image_Disc draws the same temporary T_WorldMap_Temporary inside the circular disc, north-up. The image does not rotate with camera yaw. Nearby markers use the 50 m implementation range on a north-up disc (HUD east / Unreal −X right, world +Y up) and sit inward from the rim; markers beyond the clamp stay on the rim. Looking around rotates the center heading chevron only. Walking moves markers relative to the pip. The center player pip is 8 px so a 4 m death diamond is not covered. Compass tape remains heading-only. The 50 m value is not an approved radar radius. Player/marker positions on that image are not a claimed geographic match. [OWNER CORRECTION 2026-09-14] east-is-right follows look-right, not Unreal +X.
• Shared ping: click places, click the owner’s existing ping removes. ALambeerPlayerState replicates one ping per player. The server rejects non-finite positions. No ping duration or max range is authored. Debug: UI_G4ToggleMap, UI_G4SetPing / UI_G4SetPing 0.

Owner PIE (UI-CORE-004)

1. Owner-reported ready 2026-09-12: Close Unreal Editor so UnrealEditor-Lambeer.dll is not locked.
2. Owner-reported ready 2026-09-12: Compile LambeerEditor Win64 Development and reopen this project. WBP_WorldMap was created after that reopen.
3. Owner-reported pass 2026-09-12: Close Unreal Editor again. The temporary map image needs a new LambeerEditor Win64 Development compile so Live Coding / the locked DLL does not keep the previous map paint path.
4. Owner-reported pass 2026-09-12: Compile LambeerEditor Win64 Development and reopen this project.
5. Owner-reported pass 2026-09-12: Dedicated Server + two client Preview windows. Type in a client Preview window.
6. Owner-reported pass 2026-09-13: Press M (or UI_G4ToggleMap). The map opens without stacking on inventory and shows T_WorldMap_Temporary (island aerial). The “No authored map image” label is hidden. M, Escape and Close dismiss it. After close, movement/look return. In this multiplayer topology the world keeps running.
7. Owner-reported pass 2026-09-12: UI_G3AddMarker Death. A filled red death diamond appears, then stays on the same full-map location while the player chevron moves. Minimap shows the temporary island image north-up (it does not spin with the camera). The heading chevron shows facing. The nearby death diamond sits inward from the rim, stays in world direction when looking around, and moves on the disc only when the player walks. Owner-reported pass 2026-09-13: filter toggles. Do not expect those diamonds to sit on a correct island location.
8. Owner-reported pass 2026-09-13: Drag to pan, mouse wheel to zoom, Center player. The island image pans/zooms with the markers and stays inside the map panel. Zooming out past the full map is not possible.
9. Owner-reported pass 2026-09-13: Click the map to place a ping. The other client sees that ping on map/compass/minimap. Click the same ping to remove it. UI_G4SetPing is an alternate path 4 m ahead of the pawn.
10. Owner-reported pass 2026-09-13: Tab from the map opens inventory; M from inventory opens the map. They do not remain stacked.
11. Do not treat Xbox/PlayStation as required. Do not treat this image as production map art or as a locked world footprint.

UI-CORE-005 — death/respawn state and death-marker lifecycle

C++ in this change set. Owner-reported pass 2026-09-12 for nested backpack dump, death-bag loot-panel interact with individual take, and immediate-respawn HUD/death-screen refresh. Owner-reported pass 2026-09-13 for UI-CORE-005. Last Bed and four-town Fresh Spawn were UI-CORE-006 and later passed 2026-09-13. Full-loot hardcore: inventory stacks, then held items, then worn/back equipment dump into ALambeerDeathBag. Worn-container contents (backpack, pants, vest, …) whose ContainerId matches that worn item’s ItemId are packed into FInventoryStack::NestedContents on that item, so they stay inside the dropped backpack instead of flattening as loose bag stacks. Body.Pockets stacks stay loose. Empty dump does not spawn a bag; the death screen still opens. Interact on the bag (and other AWorldDropContainer crates) opens inventory loot panels instead of vacuum TransferAllTo. Clients read ReplicatedLootStacks because the container inventory is not owner-replicated. Take / drag into a player container uses TryTakeFromWorldLoot; Take All uses TryTakeAllFromWorldLoot. Nested panels list packed contents so another player can pick those items individually. Equipping a packed storage item unpacks NestedContents back into worn ContainerId stacks. The bag destroys itself when emptied. G4.2 side-by-side transfer layout is not used yet; loot panels append under the current Scroll_Containers list. No production despawn timer is authored; UI_G4DestroyDeathBag / Lambeer.DestroyDeathBag covers the despawn-without-empty path. Death diamonds come from live replicated bags for every client, not from UI_G3AddMarker. Killer name is empty for self/unknown (UI shows Unknown). Cause ids are Damage / Unknown. Last selected bed for G4 is the bed last used to start Sleep. Health restores to MaxHealth on respawn; Hunger/Energy and other attributes are not reset. Owning-client HUD refresh on respawn clears the blood overlay timer and suppresses stale 0-Health low-HP edges until attributes replicate (NotifyLivingPresentation / ClientNotifyLivingPresentation). No ragdoll: movement is disabled until a valid respawn. Death-bag slot/weight caps are implementation so full-loot is not truncated (MinDeathBagSlots = 20, MinDeathBagWeight = 100000), not a production bag size.

• FLambeerDeathRecord replicates on ALambeerPlayerState. Lethal Health clamp on the PlayerState ASC calls AuthorityNotifyLethalDamage once.
• Opening death UI closes inventory and map. Tab/M do not open those screens while dead. Escape does not dismiss the death screen without a spawn choice.
• Debug: Lambeer.Kill / UI_G4Kill, Lambeer.DestroyDeathBag / UI_G4DestroyDeathBag, UI_G4RespawnBed, UI_G4RespawnTown (default Town.NorthCoast).

UI-CORE-006 — death/respawn screen

C++ in this change set. Owner-reported pass 2026-09-12 that immediate respawn closes this screen. Owner-reported pass 2026-09-13 for Last Bed after Sleep and Fresh Spawn to the four sandbox towns. ULambeerDeathScreen derives ULambeerActivatableWidget and hosts the same map canvas as the world map (pan/zoom, no ping). Runtime layout comes from C++ EnsureLayout when the Widget Blueprint designer tree is empty. Unreal MCP 2026-09-12 (after owner Editor reopen): created, compiled and saved /Game/Lambeer/UI/Map/WBP_DeathRespawn. Parent is ULambeerDeathScreen. GetWidgets reports an empty designer tree (0 widgets). DefaultGame.ini DeathWidgetClass points at WBP_DeathRespawn_C. Map save verified 2026-09-12 (L_Dev_Sandbox is_dirty false). Four ALambeerSpawnRegion sandbox stand-ins sit in outliner folder G4/SpawnRegions, about 8 m from PlayerStart (0, 0, 302) on the lower sandbox floor: SpawnRegion_NorthCoast Town.NorthCoast at about (0, 800, 151); SpawnRegion_SouthCoast Town.SouthCoast at about (0, −800, 150); SpawnRegion_River Town.River at about (800, 0, 150); SpawnRegion_Isthmus Town.Isthmus at about (−800, 0, 150). They are not geographically registered and TBD-WORLD-001 is unchanged. Missing regions disable that town button with reason “No authored spawn region”. Last Bed is disabled until a sleep-on-bed has been recorded. Fresh Spawn does not include a sleeping bag.

Owner PIE (UI-CORE-005 / UI-CORE-006)

1. Owner-reported ready 2026-09-12: Close Unreal Editor so UnrealEditor-Lambeer.dll is not locked.
2. Owner-reported ready 2026-09-12: Compile LambeerEditor Win64 Development and reopen this project. Unreal MCP then created WBP_DeathRespawn and the four sandbox spawn regions.
3. Owner-reported pass 2026-09-12: Dedicated Server + two client Preview windows. Type in a client Preview console, not the dedicated-server window.
4. Owner-reported pass 2026-09-12: Put items in a worn backpack, then Lambeer.Kill. Those items stay inside the backpack in the death bag, not as loose bag stacks. Killer Unknown, cause Damage, death-screen copy, Last Bed disabled, and four town buttons were not newly itemized.
5. Owner-reported pass 2026-09-12: The other client Interact (E) opens inventory loot panels like a storage box, not vacuum-loot, and can pick a nested backpack item individually. Owner-reported pass 2026-09-13: UI-CORE-005.
6. Owner-reported pass 2026-09-12: Immediate respawn after death. Blood overlay and low-HP red edges clear; the death screen closes. In this multiplayer topology the world must keep running.
7. Owner-reported pass 2026-09-13: Last Bed after Sleep, and Fresh Spawn to the four sandbox towns. No sleeping bag. Sandbox towns are not production geography.
8. Do not treat sandbox town locations as production geography. Do not treat Xbox/PlayStation as required.

UI-CORE-007 — pause/menu policy by session type

C++ in this change set. Unreal MCP 2026-09-12 (after owner Editor reopen): created, compiled and saved /Game/Lambeer/UI/Menus/WBP_PauseMenu. Parent is ULambeerPauseScreen. GetWidgets reports an empty designer tree (0 widgets). Runtime layout comes from C++ EnsureLayout. DefaultGame.ini PauseWidgetClass points at WBP_PauseMenu_C. Owner-reported pass 2026-09-12 for dedicated-server client pause, inventory-first Escape, and Tab/M not stacking. Owner-reported pass 2026-09-13 for standalone PAUSED/world-pause. ULambeerPauseScreen derives ULambeerActivatableWidget and opens through ULambeerPauseSubsystem on UI.Layer.Screen. Opening pause closes inventory and map. Death and character-creation screens refuse pause. Tab/M do not open inventory or map while pause is open. Settings and Exit-to-main remain out of this slice (UI-CORE-008 and Gate G5).

• World pause uses session NetMode, not “am I a client?”. Only NM_Standalone may pause. Listen-server and dedicated-server clients never pause; engine APlayerController::SetPause is already a no-op on NM_Client, but listen-server would pause every connected pawn if that guard used “not client”.
• Multiplayer shows the confirmed persistent warning WORLD CONTINUES WHILE MENU IS OPEN. Title is MENU. Standalone title is PAUSED and the warning is hidden. Local move/look remain blocked by the existing UI manager Menu input path.
• HUD-only Escape opens pause by reusing the existing runtime Escape mapping (IA_InventoryEscape_Runtime). While pause is open, Escape/Back/Resume close it. Inventory still consumes the first Escape. Map still uses CommonUI Back. Death still ignores Back.
• Debug: UI_G4TogglePause. G1 UI_G1SetPauseRequested remains a standalone-only manager flag and is not the pause screen.

Owner PIE (UI-CORE-007)

1. Owner-reported ready 2026-09-12: Close Unreal Editor so UnrealEditor-Lambeer.dll is not locked.
2. Owner-reported ready 2026-09-12: Compile LambeerEditor Win64 Development and reopen this project. Unreal MCP then created /Game/Lambeer/UI/Menus/WBP_PauseMenu.
3. Owner-reported pass 2026-09-12: Dedicated Server + two client Preview windows. Type in a client Preview window, not the dedicated-server window.
4. Owner-reported pass 2026-09-12: From HUD-only, press Escape (or UI_G4TogglePause). The menu opens, movement/look stop, and the warning WORLD CONTINUES WHILE MENU IS OPEN. is visible. The dedicated-server world and the other client keep running. Resume, Escape and CommonUI Back close it and restore movement/look.
5. Owner-reported pass 2026-09-12: With inventory open, Escape closes inventory and does not open pause on that same press. Tab/M do not stack inventory or map on the pause screen. A second Escape from HUD-only opening pause was not newly itemized beyond the HUD-only Escape check above.
6. Owner-reported pass 2026-09-13: Optional standalone/single-player pass: the same menu pauses the world (PAUSED, no WORLD CONTINUES warning) and Resume unpauses. This check is in addition to the dedicated-server topology; do not treat a dedicated-server client as single-player.
7. Do not treat Xbox/PlayStation as required. Settings are UI-CORE-008. Do not treat Exit-to-main as part of this slice.

UI-CORE-008 — settings model, staged apply/revert, per-category adapters

C++ in this change set. ULambeerUserSettings subclasses UGameUserSettings. DefaultEngine.ini sets GameUserSettingsClassName=/Script/Lambeer.LambeerUserSettings. HUD Scale, Safe Zone Scale and language (en/th) persist on that object. Text Scale is not a G4 Settings field (owner decision 2026-09-13; runtime stays at 1.0). Display resolution and window mode use engine UGameUserSettings fields. Opening the screen copies applied values into a draft. Apply validates then writes; Revert restores the last applied draft. HUD scale changes live-preview and persist only on Apply. Display changes apply tentatively and must be confirmed; they revert after 15 seconds, on Revert, or if the screen closes. That 15-second window is an implementation clamp, not an approved gameplay setting. Graphics, Audio, Voice, Controller, Mouse + Keyboard, Gameplay and Accessibility are listed with an explicit unavailable reason and have no persistable fields. Crosshair Customization is listed under HUD as waiting for approved values. Exit-to-main remains Gate G5. Invalid culture, non-positive scales, Safe Zone outside 0–1, non-positive resolution and unknown window mode cannot persist. ULambeerSettingsScreen derives ULambeerActivatableWidget and opens through ULambeerSettingsSubsystem on UI.Layer.Screen. Pause Settings stacks this screen without closing pause. Escape/Back close settings first. Tab/M still do not stack. Death closes settings then pause. Unreal MCP 2026-09-12 (after owner Editor reopen): created, compiled and saved /Game/Lambeer/UI/Menus/WBP_Settings. Parent is ULambeerSettingsScreen. GetWidgets reports an empty designer tree (0 widgets). Runtime layout comes from C++ EnsureLayout. DefaultGame.ini SettingsWidgetClass points at WBP_Settings_C. Debug: UI_G4ToggleSettings, UI_G4ApplySettings, UI_G4RevertSettings, UI_G4ConfirmDisplay.

• Editable G4 categories are HUD (HUD Scale, Safe Zone Scale + English/Thai) and Display (engine resolution/window mode). Text Scale is not adjustable in G4 Settings.
• Settings labels use G2 string tables ST_UI_Common_EN / ST_UI_Common_TH. Apply th sets culture like UI_G2SetCulture, then refreshes this screen from the TH table. Owner reported 2026-09-12 that Apply th left the settings labels in English, then <MISSING STRING TABLE ENTRY>, then Thai tofu boxes (C++ EnsureLayout used engine Roboto). Follow-through writes the 36 Settings.* keys, force-saves the tables, and applies /Game/Lambeer/UI/Common/Fonts/FF_UI_Primary to settings/pause runtime TextBlocks. Owner-reported pass 2026-09-13: Thai settings labels render with FF_UI_Primary (no tofu). C++ HUD/pause NSLOCTEXT still stays English until a later locres gather. G2 Gallery samples still switch through Game.locres; that Gallery path is not newly itemized in this retest.
• Unsupported categories cannot persist. Their adapters expose a reason string only.
• Dedicated-server client Preview windows may not change OS resolution; the confirm/revert path still runs. Do not treat a Preview window as a shipping display test.

Owner PIE (UI-CORE-008)

1. Owner-reported ready 2026-09-12: Close Unreal Editor so UnrealEditor-Lambeer.dll is not locked.
2. Owner-reported ready 2026-09-12: Compile LambeerEditor Win64 Development and reopen this project. Unreal MCP then created /Game/Lambeer/UI/Menus/WBP_Settings.
3. Owner-reported pass 2026-09-13: Dedicated Server + two client Preview windows. Type in a client Preview window, not the dedicated-server window.
4. Owner-reported pass 2026-09-13: From HUD-only, Escape to pause, then Settings (or UI_G4ToggleSettings). The nine confirmed categories are listed. HUD and Display are editable. Graphics/Audio/Voice/Controller/Mouse + Keyboard/Gameplay/Accessibility show a reason and Apply is disabled.
5. Owner-reported pass 2026-09-13: HUD Scale / Safe Zone Apply-revert persist. Text Scale is not in G4 Settings (locked at 1.0). Owner confirmed the HUD category has no Text Scale control after rebuild.
6. Owner-reported pass 2026-09-13: HUD Language th then Apply switches the settings category/field labels to the TH string-table copy and renders those glyphs with FF_UI_Primary (no tofu). fr is not offered and cannot persist. C++ HUD/pause NSLOCTEXT remaining in English is not a fail for this slice. G2 locres-backed Gallery samples are not newly itemized in this retest.
7. Owner-reported pass 2026-09-13: Display Apply then Revert re-applies the previous resolution. Keep / 15-second timeout were not listed as failing. Do not treat a Preview window as a shipping display test.
8. Owner-reported pass 2026-09-13: Escape/Back from settings returns to pause. A further Escape closes pause. Tab/M must not stack. The dedicated-server world and the other client keep running.
9. Do not treat Xbox/PlayStation as required. Do not treat colorblind, subtitles, rebind, camera shake, Disable Flashing, Crosshair Customization, audio volumes, graphics quality or Text Scale as part of this slice. Do not treat Exit-to-main as part of this slice.

Gate G4.2 Inventory Presentation & Container Transfer

Current owner direction — 2026-09-14: Inventory_UI_NEW.png replaces Rescue Equipment as the complete Inventory/transfer visual source of truth. Runtime behavior and the approved layout remain unchanged.

Night Ops presentation replacement — owner selected 2026-09-14

Theme authority: FEAT-HUD-UI Night Ops override. The legacy anchor g42-rescue-pack is preserved for inbound document links. Runtime tokens in LambeerInventoryPresentation.h are Background #070D12, Surface #0D161C, Raised #121E26, Border #364A56, Border Bright #617580, Accent #58EBEF, Text #DFE7EA and Muted #8797A0. Google Sans Medium/SemiBold plus letter spacing provides the reference's condensed technical hierarchy while preserving English/Thai glyph support.

Owner reference fidelity pass — 2026-09-13

The owner supplied Inventory_UI_NEW.png and requested a full presentation replacement while preserving behavior and layout. The reference does not add its sample inventory, capacities, clothing, character or key hints to runtime state.

• Saved Editor changes — 2026-09-14: all four Inventory Widget Blueprints compile/save against the rebuilt native class and carry the Night Ops resource-less chrome. Readback reported zero former Rescue texture paths, 46 RoundedBox brush occurrences across the four assets and the renamed Night Ops focus mask on WBP_InventorySlot. Lambeer.HUD.InventoryActivatable, Lambeer.HUD.InventoryCommandRules and Lambeer.HUD.InventoryPresentationFallback passed 3/3 with zero warnings/errors.
• Removed former theme: all seven /Game/Lambeer/UI/Inventory/Textures/RescueEquipment/ assets, their source pack and the superseded RawResource/ConceptReference/Inventory_UI.png were deleted after empty referencer checks. They remain recoverable from version control. The neutral focus-corner mask was moved and renamed under NightOps; it is not used with the former palette.
• Item artwork: all 13 discovered ULambeerItemDefinition assets had no Icon. Generated, inspected, imported and assigned all 13 icons under /Game/Lambeer/UI/Inventory/Textures/Items/. Sources and full built-in prompts: Icons/generation.json. L1810, its magazine and Sledgehammer used MCP asset-thumbnail references; the other icons are representative art for existing definitions whose inspected world mesh was a placeholder. The icons deliberately use an opaque navy background. No item quantities, ownership or gameplay values were changed.

Latest owner correction — 2026-09-14; native build passed; owner PIE pending: The prior WrapBox still received only its desired width because its HorizontalBox slot used HAlign_Left. The saved asset and native layout now use HAlign_Fill on that parent slot, while the WrapBox contents remain left-aligned. NativeGetDesiredFocusTarget now returns the first equipment slot instead of its non-focusable layout panel. This corrects the earlier explanation of the focus warning. WBP_Inventory compiled/saved and parent alignment readback passed; LambeerEditor Win64 Development rebuilt successfully on 2026-09-14 (DLL 00:21:19). Focused non-PIE Lambeer.HUD.InventoryCommandRules passed 1/1 with zero warnings/errors; report: Saved/Automation/InventoryWornWidthFocus/index.json. Owner client PIE must still verify row fill and absence of the focus warning.

• Newest Worn flow source built: The 2026-09-14 accepted layout used fixed 126×126 Worn/container/loot squares, 150% of the prior 84×84 baseline. The 2026-09-15 owner request compacted those cells to 88×88 (~30% smaller) without changing WrapBox flow, action-slot heights, or command routes. Owner PIE rejected the fixed five-column UniformGridPanel because it moved four cells down despite remaining right-side width. WBP_Inventory now contains a left-aligned, allotted-width Wrap_WornSlots; it places as many cells as fit on the current row and wraps only the remainder. Q3–Q0 and Drop remain 104×104 action targets; Q1/Q2 and Left/Right Hand remain 104 high and stretch horizontally to consume the remaining row width. Item titles and quantities are separate floating Overlay layers; neither contributes a VerticalBox layout height or pushes the icon. Every item brush remains centered at its authored aspect, and the square root clips residual overflow. Container grids use left alignment. Worn/Quick title rows are collapsed. Drop is a frameless navy arrow-to-tray icon with tooltip and color-state feedback. Slot and item titles use 12-point white text over the navy well with ellipsis/full tooltip and no label plate. Close and per-container Sort retain the 14-point compact token; Search is removed. Unreal MCP replaced the Worn UniformGrid with WrapBox, compiled/saved the Widget Blueprint, and readback confirmed responsive allotted-width flow with 4 px spacing. With Editor and Live Coding closed, LambeerEditor Win64 Development rebuilt successfully. Focused non-PIE Lambeer.HUD.InventoryCommandRules passed without warnings/errors.
• Character portrait source built; runtime acceptance pending: a transient local SceneCapture2D shows the owning character and attached actors only while Inventory is active in character mode; it releases capture/target/material on close or transfer. Activation now recreates it immediately, invalid resources are rebuilt as a unit, and the portrait Image material brush is rebound on each update so the empty brush left by deactivation cannot persist across reopen. Framing derives from the pawn capsule and preview aspect. The UI material /Game/Lambeer/UI/Inventory/Materials/M_UI_InventoryPortrait was created, wired, compiled and saved via MCP (SceneColor RGB, inverted capture alpha). Lighting, pose, attachment visibility, gamma, framing and capture cost have not been observed in PIE.

Acceptance result and remaining gate check

[OWNER-REPORTED G4.2 PASS 2026-09-14] The owner accepted the final Night Ops PIE presentation and confirmed drag, split, sort, drop, hand/Q1/Q2 and Player/Target transfer passed. Search failed and was explicitly removed as unsuitable for this game. After removal, Development Game/Editor builds, WBP_Inventory compile/save/readback and focused non-PIE Inventory automation 3/3 passed; the saved widget tree has 43 widgets and no Search widget. The owner then confirmed the field-free header, Title/Weight/Close layout and complete item presentation passed. G4.2 / UI-CORE-003 is closed.

Legacy UMG source texture packs — removed

The earlier olive/brass pack was removed on 2026-09-13. The superseded seven-texture Rescue Equipment pack and its Inventory_UI.png reference were removed on 2026-09-14 after empty referencer checks. Night Ops now uses resource-less brushes plus one neutral focus-corner mask.

Approved layout contract

• Reference and safe zone: author against the 1920×1080 reference canvas inside the project Safe Zone. FHD is the reference density; 2K/4K use DPI scaling. 16:10 gains vertical container space; 21:9/32:9 gain outer gutters without stretching slot proportions.
• Header: compact row with Inventory title, carried weight and Close. Inventory Search is intentionally absent by owner decision.
• Main split: Character region 36% and Inventory region 64%. Character preview fills the left region; Left Hand, Right Hand and Drop are fixed below it.
• Worn: Head, Eyewear, Hands, Backpack, Torso, Body Armor, Vest, Legs and Feet remain fully visible above the right-side container list as fixed 88×88 squares. Worn does not share the container scroll.
• Containers: one panel per authoritative player storage container. Player and loot cells are the same 88×88 squares. Only this region scrolls. Each panel header exposes used/capacity and its own Sort action; empty equipment may remove a storage panel but never removes its Worn target.
• Quick Slots: exactly one fixed Q1–Q0 row spans the bottom. Q1–Q2 exclusively represent Back Weapon 1–2; Q3–Q0 are use-quick references. There is no duplicate Back Weapon panel.
• Actions and state: one footer hosts device-dependent action hints, including Drag, RMB menu, Ctrl+RMB Equip, Ctrl+LMB Transfer and Tab close. Focus/selection uses the Night Ops cyan accent plus a corner/shape indicator so meaning is not color-only. Visual state changes must not resize the slot.
• Transfer mode: corpse, death bag, crate and storage replace the character preview area with Player Inventory / Target Inventory side-by-side. Player container headers expose Transfer All; the target header exposes Take All. Q1–Q0 and action hints remain in their normal positions.

Implementation sequence — UI-CORE-003

1. Widget/binding audit: inspect WBP_Inventory, WBP_InventoryContainer and WBP_InventorySlot through Unreal MCP before editing. Preserve the existing parent classes and C++ BindWidget names: CharacterPreview, Slot_HeldRight, Slot_HeldLeft, Slot_Drop, Box_UseQuickSlots, Scroll_Containers, optional Box_WornSlots, Text_Weight and Button_Close. Edit_Search was removed 2026-09-14.
2. Reusable presentation pieces: apply the resource-less shell/panel/slot/button/input/scrollbar brushes and single Night Ops focus mask defined in the current theme contract. Keep text, quantities, item icons and focus markers as live UMG layers. Do not use the full-screen concept PNG as the runtime background.
3. Normal inventory hierarchy: rebuild WBP_Inventory as Safe Zone → header → 36/64 main split → fixed Q1–Q0 row → action footer. Bind the existing nine Worn slots above Scroll_Containers; keep only the container list scrollable. The optional character capture may retain a placeholder until its capture actor is authored.
4. Container panels: update WBP_InventoryContainer so title, used/capacity and per-container Sort remain visible while its slot grid is rebuilt. Preserve C++ generation and server-authoritative container capacity; do not infer slots from the concept image.
5. Transfer screen: create proposed /Game/Lambeer/UI/Inventory/WBP_ContainerTransfer only after confirming the required parent/factory path through Unreal MCP. Reuse the existing LinkedTransferInventory seam and existing Take All / Transfer All commands; the widget must not own or duplicate either inventory.
6. Context and split presentation: replace the temporary C++ split-amount window only when an activatable modal can expose Split 1, Split half and validated typed amount without changing ExpectedItemId semantics. Context, Sort, Use, Equip, Drop, magazine actions and failure reasons remain projections of existing C++ commands. Search is excluded.
7. Input/focus: define deterministic visual and CommonUI navigation order Worn → Containers → Hands/Drop → Quick Slots, with explicit escape routes to Header/Close. Drag-and-drop must have click/context and keyboard/controller equivalents; changing input method must preserve the same semantic focus.
8. Responsive/localization pass: validate English and Thai at supported Text Scale, HUD/UI Scale and Safe Zone settings. Do not bake labels into PNG textures. Long labels may wrap or use a verified tooltip, but may not clip silently.
9. Editor verification: compile and save every changed Widget Blueprint through Unreal MCP when its tools cover the required hierarchy/properties. If a required property cannot be authored through MCP, stop at that exact step and provide the owner with the manual procedure; do not use computer-use.
10. Owner PIE: the owner runs Dedicated Server + two client Preview windows and records the G4.2 matrix. The agent may inspect logs and saved assets but may not start or control PIE.

Owner PIE checklist — Dedicated Server + two client Preview windows

1. Tab opens inventory: Safe Zone header shows title, weight and Close with no Search field; Character 36% / Inventory 64%; Hands/Drop under the preview; nine Worn slots fully visible above the container list; only container panels scroll; one Q1–Q0 row; no duplicate Back Weapon panel.
2. Every non-empty player/target stack remains visible; no client-side Search filter exists.
3. Per-container Sort still sorts that container; merge/split/drop/use/equip still use ExpectedItemId. Split uses the in-widget overlay (Split confirm/cancel); Escape closes the overlay first.
4. Focus/selection shows cyan plus the corner overlay, not color alone. Hover/focus does not resize slots.
5. English and Thai labels remain live text (not baked into PNG). Long labels wrap or remain readable.
6. Interact a crate/storage/corpse: character preview hides; Player | Target side-by-side; Take All on the target; Transfer All only on player containers that may deposit.
7. Death bag: loot on the target side; Take All works; depositing / Transfer All into the death bag stays blocked.
8. Opening inventory in this dedicated-server PIE does not pause the world. Xbox/PlayStation remain deferred.

Exit criteria

• WBP_Inventory, child widgets and WBP_ContainerTransfer compile/save with every required BindWidget resolved and no duplicate Back Weapon UI.
• All nine Worn targets, Hands, Drop, Weight, Close, one Q1–Q0 row and action hints remain readable at FHD, 2K, 4K, 16:10, 21:9 and 32:9 without overlap or clipping; only the container list scrolls.
• Normal inventory and side-by-side transfer mode expose the same authoritative merge/split/drop/sort/use/equip/take/transfer commands through drag, click/context and keyboard paths; Inventory Search is absent.
• Take All fills eligible player containers; Transfer All acts on one selected player container; stale indices continue to reject through ExpectedItemId; opening the screen in multiplayer never pauses the world.
• Selection/focus/denied/drop-target states remain distinguishable without color alone, and switching English/Thai or scaling text does not hide required actions.
• Owner-reported KBM PIE evidence is required to close the implemented slice. Physical Xbox/PlayStation checks remain deferred/unverified until hardware is available and are not recorded as pass or failure.

Gate G4.3 HUD UMG Artwork & Presentation Pass

Night Ops HUD redesign — Option A / Stats V2 approved and implemented

All three concepts keep the confirmed HUD information contract and use Inventory_UI_NEW.png only as the palette, surface, border, typography and cyan-state reference. Option A / Stats V2 is the owner-approved implementation reference. Options B and C remain reference-only. Images are layout/presentation concepts, not screenshots or approved gameplay data. Exact prompts, provenance, selection and implementation state are recorded in generation.json.

Option A — Peripheral Grid / Stats V2

Owner-approved and implemented. Maximum open view. Eight Stats use the compact 2×4 live icon-node system with four equal shaped segments, threshold ticks, angular current-level markers, exact current values and restrained semantic fills. Q1–Q0 are square; single-hand, empty-hand and both-hands cards share one fixed size.

Option B — Lower Command Rail

Unselected reference. All persistent controls form one low-profile bottom rail while compass, minimap and statuses stay above.

Option C — Split Wings

Unselected reference. Stats and slots form opposing lower wings with a deliberate center opening.

Night Ops source-to-Unreal register

Import and Brush contract

• All six textures: imported as Texture2D using UE 5.8's UI compression setting (TC_EditorIcon), TEXTUREGROUP_UI, NoMipmaps, Never Stream, Clamp X/Y, sRGB and preserved alpha.
• Runtime texture caps: focus/melee/throw are 256; low-health/blood/wet are 2048. Source PNGs remain unresampled and alpha-capable.
• Resource-less chrome: stat gauges, hand cards, quick slots, contextual status rows, prompt card and minimap ring use Night Ops Box/RoundedBox/Slate geometry with 0.94–0.97 blue-black fills, 1 px steel outlines and restrained cyan live emphasis. The stronger opacity prevents bright world color from washing the HUD green. No old olive/brass frame bitmap is imported.
• Image overlays: reticles and full-screen effects use ordinary Image Brushes and remain Hit Test Invisible. The minimap ring is drawn above its north-up map image and below marker/heading projection.
• Semantic state: health/stamina/etc. fills, quick-slot selection, denied state, focus and availability stay live UMG color/opacity/visibility layers. Do not duplicate PNGs just to bake state colors.

Widget implementation contract

• Status cluster: ULambeerStatusBarsWidget consumes eight snapshot values that preserve normalized, exact current and maximum values and caches the eight verified stat textures. Its resource-less custom paint draws the 2×4 icon nodes, four equal shaped segments, three threshold ticks, continuous angular markers and the exact current value at right. Filled-segment count, marker, icon, shape and number encode state without color-only meaning.
• Hands / Quick Slots / Prompt / Status rows: empty and occupied single-hand cards and the both-hands card share a fixed 300×116 logical presentation, with 9 pt titles over larger item art while retaining localized detail, UNKNOWN ammunition knowledge and durability semantics. Q1–Q0 cards are 96×96 logical squares with compact 9 pt Q labels; Q1–Q2 retain physical Back Weapon behavior and are distinguished by a shaped top-edge notch, while active state uses the accepted cyan corner mask. BACK/in-hand detail remains in tooltips rather than crowding the visible key label. The prompt uses a bordered E keycap plus separate action/detail copy while quantity/denied/hold data remains unchanged.
• Reticle: map HipRelaxed, Melee, Throw and Interaction to the four PNGs. ShoulderAim reuses HipRelaxed with a narrower live presentation. ADS collapses the reticle entirely. Do not create a HitMarker path.
• Compass / Minimap: the compass paints compact cardinal/intercardinal labels, ticks, baseline and cyan center caret instead of the oversized heading readout. Facing N, W is screen-left and E is screen-right; looking right from N centers E. WorldYawToHudYaw maps Unreal look-right onto HUD east for the tape, compass markers and north-up heading chevrons. Minimap/full-map X follow HUD east (Unreal −X) so symbols rotate with the camera. Preserve the north-up temporary map, 8 px player pip, 50 m clamp and authority; this owner correction changes only E/W screen mapping.
• Screen effects: preserve existing low-health 30/20/10 behavior, blood 2-second hold plus 5-second fade, wet-lens 5-second fade and Sleeping dim alpha 0.22. Keep the center readable and retain reticle/prompt visibility ordering. Blood remains non-directional.
• Responsive layout: respect HUD Scale, Safe Zone and Text Scale. Edge HUD follows physical viewport edges on ultrawide; reticle and prompt stay centered. PNG artwork must not be used as a fixed full-screen coordinate layout.

Implementation sequence — UI-HUD-018

1. Use Unreal MCP to inspect the current WBP_HUDRoot, WBP_StatusBars, WBP_Hands, WBP_QuickSlots, WBP_Reticle, WBP_Minimap, WBP_ContextStatusList and WBP_ScreenEffects hierarchy, parent classes and BindWidget names before editing.
2. Done 2026-09-14: inspect the eight HUD Widget Blueprints through Unreal MCP with PIE stopped.
3. Done 2026-09-14: import the six Night Ops PNG sources into /Game/Lambeer/UI/HUD/Textures/NightOps/, apply/read back the import contract and record caps.
4. Done 2026-09-14: implement the owner-approved Option A anchors and Stats V2 live paint. The status designer keeps only its root canvas; no fixed full-screen concept image, baked values or duplicated state textures are used.
5. Done 2026-09-14: apply frame/card/quick-slot/minimap presentation without changing data providers, replicated state, command routing or marker projection.
6. Done 2026-09-14: map the reticle sources to the existing state machine; ShoulderAim reuses the focus mask at a narrower live size, ADS collapses, Interaction adds a live diamond and no hit-confirmation state exists.
7. Done 2026-09-14: replace procedural/placeholder screen-effect art with the three overlays while keeping the existing timers, thresholds, Sleeping dim and respawn reset behavior.
8. Non-PIE scope done 2026-09-14: Unreal MCP readback verifies physical-edge anchors and fixed panel extents without changing center anchors. MCP does not provide an authoritative rendered FHD/2K/4K, 16:10/21:9/32:9 and English/Thai matrix, so the visible responsive/language result remains owner checklist 8.
9. Done 2026-09-14: with Editor/Live Coding closed, final LambeerEditor Win64 Development passed and headless non-PIE Lambeer.HUD automation passed 24/24. After reopening, Unreal MCP compiled/saved/read back the four Option A-affected Widget Blueprints against the rebuilt DLL; all packages are clean.
10. Revision 2 built 2026-09-14: after owner visual rejection of the first runtime screenshot, align scale, insets, opacity and hierarchy directly to HUD_UI.png; fix the white Stats render path; rebuild compass/minimap/prompt/hands/slots presentation. Editor build and HUD automation 24/24 pass; Unreal MCP compiles/saves the six affected Widget Blueprints. Owner PIE acceptance remains pending.
11. Revision 3 built and owner-accepted 2026-09-14: apply the owner's annotated runtime corrections: equal fixed-size hand cards, smaller titles, square Quick Slots, four equal Stat segments with exact current values, themed weight icon-node and compact compass spacing. Editor build and HUD automation 24/24 pass; Unreal MCP compiles/saves/reads back the five affected Widget Blueprints. The owner reported the complete G4.3 PIE matrix passed.
12. Owner PIE done 2026-09-14: the owner ran the required G4.3 matrix and reported all checks passed. The agent did not start or control PIE.
13. Owner correction 2026-09-14 — compass/map E/W: after the G4.3 close, the owner reported the tape mirrored E/W, then that looking right toward E showed W on both the tape and map/minimap symbols. WorldYawToHudYaw maps Unreal look-right onto HUD east; minimap disc X, full-map UV X and the north-up island image follow that convention. This does not reopen G4.3. Closed-Editor LambeerEditor Win64 Development compiled and linked; headless non-PIE Lambeer.HUD passed 24/24 (0 failed / 0 not run). Evidence: Saved/Logs/CompassEWFix.log and Saved/Automation/CompassEWFix/index.json. Owner PIE remains pending.

Exit criteria

• The implemented, owner-approved Option A / Stats V2 HUD passes deferred owner PIE checklist 1, 2 and 8; Options B and C remain reference-only.
• All six Night Ops Texture2D assets exist at the documented targets with alpha and UI import settings verified; resource-less chrome and final runtime caps are recorded.
• All changed HUD Widget Blueprints compile/save with their existing BindWidget contract intact and no C++ gameplay or authority regression.
• Owner PIE confirms eight live segmented gauges, hand/quick-slot state, prompt quantity/denied, north-up minimap/markers and reticle states; ADS stays hidden and no HitMarker appears.
• Owner PIE confirms low-health 30/20/10 edges, nearby non-directional blood, rain/swim wet lens, Sleeping dim and respawn clearing still follow the G3/G4 timings and lifecycle.
• At supported aspect ratios and scales, edge art does not clip required content, center effects do not obscure prompt/reticle readability, Thai/English text is not baked or clipped, and multiplayer remains unpaused.
• Satisfied 2026-09-14: G4.3 is closed from the owner's full checklist pass. G4.4 subsequently passed and closed. Xbox/PlayStation physical verification remains deferred until hardware is available and is not included in either closure claim.

Gate G4.4 Pause & Settings Night Ops Presentation

Menu concept decision

The three concept boards preserve the completed UI-CORE-007/UI-CORE-008 behavior. Option B is the implementation reference; A and C remain unselected references. Generated examples, provenance and prompt constraints are recorded in generation.json.

Option A — Centered Command

Unselected reference. A centered modal composition with balanced symmetry.

Option B — Tactical Side Rail

Owner-selected and implemented. Pause uses a narrow left command rail; Settings expands the same rail into a wide operator workbench.

Option C — Minimal Overlay

Unselected reference. Sparse overlay chrome that keeps more of the world visible.

Implementation contract — UI-MENU-001

• Pause: a 340×820 logical left rail uses the Night Ops blue-black surface stack, steel-blue outline, cool-white hierarchy and cyan interaction state. Standalone still pauses the world and multiplayer still leaves the world running, but the owner-directed current presentation does not display the former world-continues warning.
• Settings: a centered 1480×820 logical workbench uses a 300 px category rail, broad content area, framed setting rows, selected-category cyan state, bottom Apply/Revert/Back strip and a matching display-confirm modal. The language selector displays white self-language names English and ภาษาไทย; persisted culture IDs remain en/th.
• Runtime strategy: scalable resource-less RoundedBox geometry and the shared Google Sans/Night Ops style are used; no concept screenshot is baked into the runtime and no new texture import is required.
• Scope boundary: preserve UI-CORE-007/UI-CORE-008, keep Text Scale locked at 1.0, keep unsupported categories unavailable, and do not add Exit-to-main or any G5 feature.

Owner-only PIE acceptance — passed 2026-09-14

1. In Dedicated Server + two client Preview windows, open Pause and confirm the left tactical rail, no world-continues warning text, local input blocking, other client/server continuity, Resume, Escape and Back behavior.
2. In Standalone, open Pause and confirm PAUSED/session presentation, real world pause and resume.
3. Open Settings and confirm HUD/Display content, category selection styling, unavailable categories, HUD Scale, Safe Zone, white English/ภาษาไทย language options, Apply/Revert/Back and the display-confirm modal.
4. Verify English and Thai at supported FHD/2K/4K and 16:10/21:9/32:9 layouts: no clipped required copy, overlap, focus trap or off-safe-zone action.
5. Confirm Inventory/Map/Death stacking and Back priority still behave exactly as the closed G4 contracts specify.

Gate G5 Frontend & Session Flow

Owner-only dedicated join / disconnect / rejoin

1. After the closed-Editor native rebuild, open this project in UE 5.8. Play: Net Mode Play As Client, Number of Players 2, map L_Dev_Sandbox. Type in a client Preview window. The dedicated world is started automatically and is hidden under one-process PIE.
2. Confirm Output Log contains P08 advertised session or P08 advertised session start GameSession (ok) on the dedicated server. The dedicated world and the other client must keep running for the rest of this checklist.
3. Owner-reported pass 2026-09-16: On a client with no saved character, finish Character Creation and starter-town selection. The follow camera sits behind the pawn, not inside the mesh. A new extra client such as pie-3 is the required first-time-creation check; returning clients that skip creation do not cover this.
4. Owner-reported pass 2026-09-16: On client 1, finish Character Creation if this window has no character, then move. Open Pause: title is MENU / ONLINE SESSION; SAVE is hidden; EXIT TO MAIN MENU is visible. The dedicated world and client 2 keep running.
5. Owner-reported pass 2026-09-16: Choose EXIT TO MAIN MENU. Client 1 returns to Main Menu. The dedicated server stays up. Client 2 remains in the world and can still move.
6. Owner-reported pass 2026-09-16: On client 1 Main Menu, open Server Browser. Keep the Community tab (default). Refresh. A Community dedicated row appears. Join it. An empty list would still be a listing/join bug, not a missing Net Mode option.
7. Owner-reported restore pass 2026-09-16, including after Server Browser Join: returning to the same dedicated world restores the same character/position/inventory instead of opening a replacement Character Creation.
8. Optional failure checks: Cancel during Refresh; Join while the list is stale after a long wait should show an explicit reason. Steam discovery is out of this checklist.

Optional session name/type for local dedicated: -LambeerServerName="Bangkok Test", -LambeerOfficial, -LambeerFriendlyFire=1. Unmarked dedicated sessions stay Community and omit friendly-fire metadata rather than inventing a value.

Target Architecture [CONFIRMED 2026-09-06]

Owner approved. The Hybrid CommonUI + UMG architecture, one root per local player, four-layer ownership model, compatibility-facade migration, and SP/MP input-state policy below are frozen for G1 implementation.

ULambeerUIManagerSubsystem : ULocalPlayerSubsystem
└─ WBP_UIRoot : ULambeerUIRootWidget / UCommonUserWidget
   ├─ Layer_GameHUD : Overlay                         // passive UMG
   │  ├─ WBP_HUDRoot : ULambeerHUDWidget
   │  ├─ WBP_ContextStatusList
   │  ├─ WBP_NotificationFeed
   │  └─ WBP_InteractionPromptHost
   ├─ Layer_Screens : UCommonActivatableWidgetStack  // one primary screen
   ├─ Layer_Modals  : UCommonActivatableWidgetStack  // context/split/errors
   └─ Layer_Toast   : WBP_ToastQueue                 // non-blocking notices

Gameplay components replicate canonical state.
UI manager owns only local presentation, activation, focus, safe-zone and device state.
Every server mutation is requested through the owning gameplay component/service and re-rendered from accepted state.

C++ ownership rules

• ULambeerUIManagerSubsystem is the only layer/router owner per local player.
• ULambeerActivatableWidget centralizes CommonUI input config, back behavior, initial focus and restoration.
• Passive widgets remain UUserWidget; screens/modals derive from CommonUI activatable bases.
• Presentation structs are local read models, not new replicated gameplay databases.
• Widgets subscribe in construct/activate and unsubscribe in destruct/deactivate; no gameplay polling on Tick unless a specific visual interpolation needs it.
• Blueprint owns layout/style and calls exposed C++ commands; authoritative logic remains in C++.

Input-state policy

Target Files, Assets & Migration Map

Paths marked Proposed do not exist yet. Existing Blueprint assets must be edited by the user.

Source/Lambeer/UI/
├─ Common/                                      [Proposed]
│  ├─ LambeerUIManagerSubsystem.h/.cpp
│  ├─ LambeerUIRootWidget.h/.cpp
│  ├─ LambeerActivatableWidget.h/.cpp
│  ├─ LambeerUIActionTypes.h
│  └─ LambeerUITypes.h
├─ HUD/                                         [Proposed organization]
│  ├─ LambeerHUDWidget.*                        [move only in planned migration]
│  ├─ LambeerStatusBarsWidget.*
│  ├─ LambeerCompassWidget.*
│  ├─ LambeerInteractionPromptWidget.*
│  └─ LambeerScreenEffectsWidget.*
├─ Screens/                                     [Proposed]
│  ├─ LambeerInventoryWidget.*                  [G4 UI-CORE-001/002 owner pass 2026-09-12; G4.2 Night Ops visual pass 2026-09-14, interaction acceptance pending]
│  ├─ LambeerMapScreen.* / LambeerMapSubsystem.* / LambeerMapPresentation.*  [G4 UI-CORE-004 owner pass 2026-09-13 including zoom clip; frozen 50 m fallback while open; north-up minimap; owner north-up/frozen-death pass 2026-09-12]
│  ├─ LambeerDeathScreen.* / LambeerDeathSubsystem.*  [G4 UI-CORE-005 owner pass 2026-09-13; UI-CORE-006 owner pass 2026-09-13 Last Bed / four-town Fresh Spawn; also LambeerDeathBag.*, LambeerSpawnRegion.*, LambeerDeathTypes/Rules; owner nested-dump / loot-panel / HUD-refresh pass 2026-09-12; four sandbox spawn regions on L_Dev_Sandbox]
│  ├─ LambeerSpawnScreen.*
│  ├─ LambeerCraftingScreen.* / LambeerWorkbenchScreen.*
│  ├─ LambeerPauseScreen.* / LambeerPauseSubsystem.* / LambeerPauseRules.h  [G4 UI-CORE-007 behavior pass; G4.4 Night Ops Option B owner-accepted]
│  ├─ LambeerSettingsScreen.* / LambeerSettingsSubsystem.* / LambeerUserSettings.* / LambeerSettingsRules.h  [G4 UI-CORE-008 behavior pass; G4.4 Night Ops Option B owner-accepted; Text Scale locked 1.0]
│  └─ LambeerServerBrowserScreen.* / LambeerGroupScreen.*
└─ Legacy/                                      [optional transitional namespace, no asset move]

Content/Lambeer/UI/
├─ Common/Styles/  DA_UITheme, CommonButton/Text styles        [Proposed]
├─ Common/Icons/   T_UI_* imported from RawResource/UI/Icons/  [Proposed]
├─ Common/Input/   CommonInput controller data + action data    [Proposed]
├─ HUD/            WBP_UIRoot, WBP_HUDRoot, HUD child widgets; Textures/T_UI_HUD_* [G4.3 Night Ops revision 3 integrated and owner-accepted]
├─ Menus/          WBP_PauseMenu + WBP_Settings [G4 behavior pass; G4.4 Night Ops Option B owner-accepted]; Main/Save/Server/Character/Spawn remain later gates
├─ Inventory/      existing assets + context/transfer screens   [Mixed]
├─ Map/            WBP_WorldMap, T_WorldMap_Temporary (1024×576 temp image), WBP_DeathRespawn [G4 UI-CORE-004 2026-09-12; UI-CORE-006 WBP_DeathRespawn 2026-09-12]
├─ Crafting/, Building/, Weapons/, Social/, Settings/           [Proposed]
└─ ControllerGlyphs/                                             [Verified existing; preserve]

Config: Lambeer.uproject, Lambeer.Build.cs, DefaultEngine.ini, DefaultGame.ini
Input: Content/Lambeer/Core/Input/Actions/ and IMC_Default

Data Model, Interfaces & Events

ชื่อด้านล่างเป็น target contract จาก feature spec; implementation must first search for an existing gameplay-owned equivalent and reuse it where semantics match.

Required event surface

OnHUDSnapshotChanged(const FUIHUDSnapshot&)
OnInteractionPromptChanged(const FInteractionPromptState&)
OnObservedWeaponInfoChanged(ELambeerHeldHand, const FUIWeaponHandState&)
OnMapMarkersChanged(const TArray<FUIMapMarker>&)
OnCraftQueueChanged(FGuid QueueId)
OnAchievementUnlocked(FName AchievementId, const FRewardPayload&)
OnGroupActivityLogged(const FGroupActivityLogEntry&)
OnInputMethodChanged(ECommonInputType, FName GamepadName)

Error contract

• Every asynchronous screen has Loading, Ready, Empty, Error and Stale/Retry states where applicable.
• Rejected server action returns a localizable reason code; widgets do not parse arbitrary server strings.
• Missing optional backend displays unavailable state and logs once; it must not crash or fabricate data.
• Top modal receives errors that block the current operation; non-blocking results use toast.

Roadmap dependency split — owner confirmed 2026-09-13

PIPE-ROADMAP P00–P31 is the cross-system production schedule. Preserve the strict sequence G4 → G4.2 → G4.3 → G4.4 → G5. G4.4 was added after the owner selected the Pause/Settings Option B presentation on 2026-09-14; its early implementation does not bypass G4.3 acceptance. After G5, G6 and G7 are scheduled per system/backend dependency; squad and boss cooperation can be delivered before Skills/Vehicles. This supersedes an interpretation that every G6 task must close before any G7 task starts.

G6 weapon work maps to P11, crafting to P15, building to P16, boss to P18, progression to P21 and vehicle to P23. G7 squad/chat/voice maps to P19; remaining clan administration/territory scope maps to P22. UI-SOC-001/002 retain their IDs and full scope: a squad-only increment is partial until the clan work is accepted. G6/G7 aggregate completion still requires every task’s evidence; a backend-blocked shell is not an implemented gameplay system. G8 final acceptance follows aggregate closure.

Task statuses below remain authoritative for their recorded evidence. The roadmap separately reports concurrent source changes as unverified implementation, never as a PIE or gate pass.

Ordered Milestone Gates

ไม่มี calendar dates ตาม roadmap หลัก แต่ละ gate ต้องผ่าน exit criteria ก่อนเปิดงานที่พึ่งพา gate ถัดไป งาน screen ที่ไม่พึ่ง backend สามารถทำ visual shell ล่วงหน้าได้โดยแสดง unavailable/preview state เท่านั้น

Detailed Task Register

No tasks match the current filters.

Screen-to-Task Coverage Crosswalk

Screen IDs และหน้าที่เป็น canonical ใน FEAT-HUD-UI; ตารางนี้ชี้เฉพาะ implementation owner task และ gate เพื่อไม่ทำซ้ำ behavior specification

Replication, Persistence & Security Rules

• UI RPC requests carry stable IDs where stale-selection risk exists; never trust client index alone. Inventory stack commands in G4 UI-CORE-002 send ExpectedItemId with the index and reject when that stack is missing or a different item. There is no generation token.
• Server rejection must trigger refresh from authoritative state and show a localizable reason.
• Owner-only/private data is not replicated to unrelated players merely to simplify UI.
• Death marker lifetime follows loot-bag entity state; it is not a separate permanent client marker.
• Achievement unlock is idempotent; toast appears only after durable/authoritative acceptance.
• Crafting reserve/refund must be transaction-safe against reconnect, retry and station destruction.

Performance & Failure Handling

For capture commands, UI/inventory diagnosis, per-process multiplayer profiling and before/after evidence, follow TECH-PERFORMANCE-PROFILING. This runbook adds no approved numeric budget or new PIE result.

ไม่มี numeric performance budget ที่อนุมัติ จึงใช้ structural rules และวัดจริงโดยไม่ตั้งตัวเลขเป้าหมายเอง

Verification Strategy & Required Evidence

Automated/non-interactive checks

• Editor/Game/Server C++ compile after each C++ gate.
• Pure C++ automation tests for deterministic contracts and server validation boundaries.
• Asset path/config validation for root, screen registry, input data, fonts and icons.
• Repository search proving forbidden hit/headshot/kill marker APIs and bindings are absent.
• Localization gather/report shows no unkeyed player-facing strings in the changed scope.
• Cook/package smoke detects editor-only or missing soft references.

User-only Unreal Editor checks

• Compile/save each Widget Blueprint after C++ parent change; resolve BindWidget names.
• G3 Editor rebuild completed 2026-09-08 after owner reopen; run PIE-UI-001–005 on WBP_HUDRoot.
• Run PIE checklist from PIE-UI-001…012.
• Record resolution/aspect, language, device, SP/MP mode, result and evidence.
• Only mark a gate verified after user-reported results are captured; agent must not infer a PIE pass.

Regression matrix

Definition of Done per Screen

• Screen ID and class/asset path match FEAT-HUD-UI; proposed asset is verified after creation.
• All authoritative commands route through C++ service/component and handle rejection.
• Loading/empty/error/denied states are designed where applicable.
• Mouse, keyboard, Xbox and PlayStation navigation work; focus has a visible state and no trap.
• English and Thai copy comes from localizable text; no clipping at supported scale/aspect.
• Semantic state is conveyed by icon/shape/text as well as color.
• Delegates are removed on deactivation/destruction; latent loads/callbacks cannot update a dead screen.
• Automated checks pass where applicable; user-run PIE evidence is recorded.
• Related canonical HTML docs are updated when implementation changes the contract.
• Legacy asset/code is removed only after redirect/cook/regression gates pass.

Technical Decisions / Blocking TBDs

Dependencies & Source of Truth

Plan source of truth: เอกสารนี้กำหนด implementation order, file impacts, gates และ verification evidence ส่วนพฤติกรรม player-facing ยังคง canonical ใน FEAT-HUD-UI และ gameplay authority/value อยู่ใน feature/technical docs ของระบบนั้น