HUD & UI System

สถานะและขอบเขตอำนาจ

[CONFIRMED] พฤติกรรม UI และ flow ที่มาจาก owner workshop วันที่ 5–6 กันยายน 2026 เป็น requirement สำหรับทุก phase แม้ gameplay backend บางระบบยังไม่ได้สร้าง

[CONFIRMED 2026-09-06] สี, typography, spacing, icon language และ layouts ในเอกสารนี้ได้รับอนุมัติเป็น target implementation contract แล้ว ชื่อ class/widget ที่ระบุว่า proposed ยังคงเป็น target และห้ามอ้างว่าเป็น asset จริงจนกว่าจะถูกสร้างและตรวจใน Unreal [G4.3 OWNER-REPORTED FULL PIE PASS 2026-09-14] Revision 3 applies the owner's screenshot corrections: equal fixed-size hand cards, smaller hand/slot titles, square Q1–Q0 cards, four equal segments plus exact current values for all eight Stats, a themed weight node and a tighter compass. Native build, non-PIE automation 24/24 and five affected Widget Blueprint compile/save/readback checks pass. The owner confirmed the complete G4.3 checklist, including overall presentation, Hands/Quick Slots and responsive English/Thai layout. See Gate G4.3 redesign.

[CONFIRMED 2026-09-08] Gate G2 KBM/design-system PIE is recorded as passed in TECH-HUD-UI-IMPLEMENTATION: HUDScale, SafeZoneScale, TextScale and Thai Gallery culture switching. Physical Xbox/PlayStation checks remain deferred. Colorblind presets in PIE-UI-011 remain not run.

[CONFIRMED 2026-09-10] Gate G3 gameplay HUD slice is closed. Owner PIE confirmed Wood→slots 3–0, blood/wet/status injectors, markers, inventory/quick-slot correction, L_Dev_Sandbox throw/sledgehammer checks, bed sleep without standing still, a slight Sleeping screen dim, L1810 field inspection, Lambeer.Damage 10, eight GAS-colored bars, UI_G3GiveBackWeapons, ADS-hidden reticle, no HitMarker, nearby 2 m / LOS blood, low-health 30/20/10 edges, rain-lens droplets plus shelter, and prompt quantity/denied. G3 rain presentation is HUD droplets + UI_G3SetRain; rain VFX is out of G3. HOLD text waits for a real hold action. [CONFIRMED 2026-09-11] G3.2 skeletal L1810 and magazine-as-item passed owner PIE; wet-look remains deferred until materials expose WetAmount. See TECH-HUD-UI-IMPLEMENTATION. [CONFIRMED 2026-09-12] G4 UI-CORE-001 / UI-CORE-002 inventory lifecycle, Tab toggle, Worn slots and command backends passed owner PIE. [CONFIRMED 2026-09-12] G4 UI-CORE-004 north-up minimap and frozen full-map death diamond passed owner PIE. [CONFIRMED 2026-09-13] pan/zoom/center, shared ping, filter toggles, map↔inventory Tab switching, and the zoom-clip retest passed (zoomed image stays inside the map panel). [CONFIRMED 2026-09-12] G4 UI-CORE-005/UI-CORE-006 follow-through passed owner PIE: packed backpack dump, loot-panel interact, immediate-respawn HUD refresh. [CONFIRMED 2026-09-13] UI-CORE-005 passed. [CONFIRMED 2026-09-13] UI-CORE-006 Last Bed after Sleep and four-town Fresh Spawn passed. Gate G4 is closed. [CONFIRMED 2026-09-12] G4 UI-CORE-007 dedicated-server pause passed owner PIE: HUD Escape opens pause with “WORLD CONTINUES WHILE MENU IS OPEN.”, local move/look blocked, other client/server keep running, Resume/Escape/Back close; inventory Escape closes inventory first; Tab/M do not stack. [CONFIRMED 2026-09-13] standalone PAUSED/world-pause passed. [CONFIRMED 2026-09-13] UI-CORE-008 settings passed (Thai labels, HUD Scale/Safe Zone persist, Display Revert, no Text Scale control). [OWNER-REPORTED G4.2 PASS 2026-09-14] The approved UI-CORE-003 Night Ops Inventory presentation, retained interactions and Search-free header passed in G4.2. Search was removed by owner decision. G4.2 is closed and G4.3 is next.

[OWNER-REPORTED G4.2 PASS 2026-09-14] The Night Ops Inventory/transfer presentation passed its native build, Widget Blueprint compile/save/readbacks and focused non-PIE automation 3/3. The owner accepted the final PIE presentation and all retained drag/command/transfer interactions. Search was the sole failed route and was removed by explicit owner decision as unsuitable for this game; Development Game/Editor builds and the field-free WBP_Inventory compile/save/readback pass. The owner then confirmed the Search-free header and retained layout passed. G4.2 is closed.

[G4.4 OWNER-REPORTED FULL PIE PASS 2026-09-14] Pause/Settings Option B — Tactical Side Rail is implemented and accepted under G4.4; native, automation and Widget Blueprint checks pass, and the owner confirmed the complete PIE checklist. The strict closure sequence G4 → G4.2 → G4.3 → G4.4 is satisfied; this made G5 eligible, and G5 entered implementation on 2026-09-15.

[G5 SP FRONTEND OWNER-REPORTED PASS 2026-09-16] Owner reported Main Menu/Continue/Save World Select, Character Creation visual, persistence/restart/rejoin and Pause Save/Exit passed. [G5 DEDICATED FOLLOW-CAMERA OWNER-REPORTED PASS 2026-09-16] Extra dedicated first-time Character Creation restores the hip follow camera behind the pawn. [G5 DEDICATED PAUSE/EXIT/RESTORE OWNER-REPORTED PASS 2026-09-16] Dedicated Pause is MENU / ONLINE SESSION without Save; Exit to Main Menu leaves the dedicated world and client 2 running; restore skips Character Creation. [G5 DEDICATED SERVER BROWSER JOIN OWNER-REPORTED PASS 2026-09-16] After Exit to Main Menu, Refresh/Join on the Community tab returns the same character. UE 5.8 Play As Client is the dedicated topology. Steam/Feedback/production-map work remains blocked and G5 stays open.

[TBD] ห้าม implement จุดที่ระบุ TBD ด้วยการตั้งสมมติฐานเอง

Purpose & Player Value

UI ต้องทำให้ survival simulation ที่ลึกอ่านออกได้ทันทีโดยไม่เปลี่ยนเกมให้เป็น arcade HUD ผู้เล่นเห็นสภาวะร่างกายและทรัพยากรสำคัญตลอดเวลา แต่ข้อมูลอาวุธบางชนิดยังต้องได้มาจากการกระทำในโลก เช่น check chamber/check magazine ความกดดันจึงยังมาจากการสังเกต ภาพ เสียง และการเตรียมตัว

• เน้นข้อมูลเชิง survival แบบ SCUM โดยเฉพาะ metabolism, nutrition และ injury context
• รองรับ mouse/keyboard และ Xbox/PlayStation controller ตั้งแต่โครงสร้างแรก
• ใช้ flat, readable surfaces กับ visual language แบบ improvised survivor
• ไม่มี hit marker, kill confirmation หรือ directional damage indicator
• ทุก screen ต้องใช้ได้ที่ FHD, 2K, 4K และ ultrawide 16:10/21:9/32:9

Scope / Out of Scope

Visual System [CONFIRMED]

Gameplay HUD และ Inventory ใช้ Night Ops presentation จาก Inventory_UI_NEW.png: near-black blue surfaces, thin steel-blue outlines, low shadow, cool white text และ cyan interaction accent. ระบบอื่นที่ยังไม่ได้รับ Night Ops pass คง baseline improvised-survival เดิมจนมี gate ของตนเอง; ห้ามนำ brass/olive chrome เก่ากลับเข้ามาใน HUD/Inventory ที่ปิดหรือกำลังทำ gate แล้ว

Inventory/transfer and gameplay HUD share these Night Ops tokens. Reuse resource-less RoundedBox geometry for scalable chrome; reserve bitmap textures for semantic silhouettes and lens effects.

Typography

• [APPROVED] UI English, Thai และ subtitles ใช้ Google Sans จาก RawResource/Fonts/Google_Sans/; target composite/font-family asset คือ /Game/Lambeer/UI/Common/Fonts/FF_UI_Primary.
• Default face: GoogleSans-Regular.ttf; ใช้ Medium/SemiBold/Bold variants ตาม hierarchy และไม่ใช้ Italic เป็นข้อมูลสำคัญเพียงอย่างเดียว ไฟล์ที่ตรวจมี Thai-block glyph 87 codepoints รวม basic Thai set.
• TBD-HUD-UI-002 RESOLVED 2026-09-06: Font metadata and the official Google Fonts source repository identify SIL Open Font License 1.1 without Reserved Font Names; the retained license is RawResource/Fonts/Google_Sans/OFL.txt.
• Numbers, timers, compass degrees and ammunition inspection use tabular figures; verify tabular-figure behavior in the imported composite font.
• Body text minimum at 1080p: 18 px equivalent; captions 20 px equivalent before user scaling.

Scale & ultrawide

• Reference canvas: 1920×1080; layout uses anchors and DPI scaling, never fixed full-screen coordinates.
• HUD anchors follow the physical viewport edges on ultrawide as confirmed.
• HUD Scale, Safe Zone, Text Size และ Crosshair Customization are required settings beyond the owner's minimum accessibility list.
• Critical prompt/reticle content stays near the view center; edge HUD observes user safe-zone inset.

UI Architecture & Layer Contract

[CONFIRMED] ใช้ Hybrid CommonUI + UMG: CommonUI สำหรับ navigable screens และ modal stack; UMG ปกติสำหรับ passive gameplay overlays และ world-space prompts

WBP_UIRoot : UCommonUserWidget                         [PROPOSED]
├─ Layer_GameHUD : Overlay
│  ├─ WBP_HUDRoot : ULambeerHUDWidget
│  ├─ WBP_ContextStatusList
│  ├─ WBP_NotificationFeed
│  └─ WBP_InteractionPromptHost / world prompt projection
├─ Layer_Screens : UCommonActivatableWidgetStack
│  ├─ WBP_MainMenu / SaveWorldSelect / ServerBrowser
│  ├─ WBP_CharacterCreation / SpawnMap
│  ├─ WBP_Inventory / WorldMap / Crafting / Skills
│  ├─ WBP_Achievements / ClanSquad / WeaponWorkbench
│  └─ WBP_Settings / PauseMenu / DeathRespawn
├─ Layer_Modals : UCommonActivatableWidgetStack
│  ├─ WBP_ContextMenu / WBP_ItemSplit
│  ├─ WBP_MagazineLoadPlanner / WBP_InviteInbox
│  └─ WBP_ErrorDialog / WBP_ExternalLinkConfirm
└─ Layer_Toast : WBP_ToastQueue

Input modes

CommonUI, CommonInput, CommonGameViewportClient และ controller data assets เป็น target dependency; ยังไม่พบว่าเปิดใช้ใน Lambeer.uproject ณ วันที่เอกสารนี้จัดทำ

Screen Catalog

Gameplay HUD Reference

W 270NWN 000NEE 090

THE BUTCHER

LEFT HAND · KNIFE
Durability state only

RIGHT HAND · PISTOL
Chamber: UNKNOWN

[E] HOLD · SEARCH
Field Cabinet · 1.4 s

1

2

3

4

5

6

7

8

9

0

Always-visible survival cluster

[OWNER-CORRECTED 2026-09-14] แสดง Health, Stamina, Hunger, Thirst, Temperature, Energy, Sleep และ Immunity ตลอดเวลาเป็น icon-node + segmented gauge แต่ละ rail มี 4 shaped segments ขนาดเท่ากัน, threshold ticks, angular current-level marker และค่าปัจจุบันจริงทางขวา; filled-segment count, icon, รูปทรงและตัวเลขต้องทำให้สถานะอ่านได้โดยไม่พึ่งสีอย่างเดียว

Contextual statuses

Bleeding, infection, fracture, poison, cold, overheated, wetness, encumbrance และ buffs ปรากฏในรายการ contextual เรียงตาม severity แล้วตามเวลาที่เกิด ห้ามซ่อน critical status ด้วย overflow; แถวที่ล้นย้ายเป็น expandable stack

Low-health visual

Blood & water on lens

• Blood splash เกิดเมื่อเลือดจาก melee, gunshot หรือ explosion ระยะใกล้กระเด็นถึงกล้อง; hold 2 วินาที แล้ว fade 5 วินาที
• Wet droplets เริ่มทันทีเมื่อโดนฝนหรือจาก swimming/emerge; เมื่อไม่มี source แล้ว fade 5 วินาที
• ขณะ Sleeping หน้าจอมืดลงเล็กน้อย (alpha 0.22) เพื่อให้เห็น rest state ใน G3; ไม่ใช่ซีนนอนสมบูรณ์ และไม่ได้แทนที่ blood/wet
• ไม่มี option ลดหรือปิด blood/wet effects
• Disable Flashing เปลี่ยน white flash เป็น black-frame feedback โดยไม่ตัด critical information

Night Ops HUD presentation sources — Gate G4.3

A — Peripheral Grid / Stats V2

Owner-approved and owner-accepted direction and revision-3 alignment target together with RawResource/ConceptReference/HUD_UI.png.

B — Lower Command Rail

Unselected reference retained for provenance.

C — Split Wings

Unselected reference retained for provenance.

Hip / Shoulder / Interaction corners

T_UI_HUD_NightOps_Focus
Reused from G4.2; Interaction adds a live cyan center diamond.

Melee

T_UI_HUD_NightOps_Reticle_Melee
Distinct silhouette; runtime-tinted.

Throw

T_UI_HUD_NightOps_Reticle_Throw
Readiness only; not trajectory prediction.

Low-health edge

T_UI_HUD_NightOps_FX_LowHealth
Live 30/20/10 tiers.

Blood on lens

T_UI_HUD_NightOps_FX_BloodLens
Existing 2 s hold / 5 s fade.

Wet lens

T_UI_HUD_NightOps_FX_WetLens
Existing 5 s fade.

The two ImageGen interaction-mask attempts were rejected because they baked a checkerboard background; neither was copied or imported. Interaction therefore reuses the approved G4.2 focus-corner mask and adds a crisp Slate diamond. ADS still collapses the reticle entirely; there is no HitMarker, headshot marker, kill confirmation, damage-direction indicator or baked copy.

Compass, Map, Combat & Interaction

Compass tape / minimap

• Compass แสดง cardinal/intercardinal, degrees และ marker projection สำหรับ squad pings, landmarks, death bag และ boss
• [OWNER CORRECTION 2026-09-14] Tape and north-up heading chevrons are look-relative: when the center caret is N, W/NW are screen-left and E/NE are screen-right. Looking right from N must bring E to the caret and rotate map/minimap symbols toward E, not W. WorldYawToHudYaw maps Unreal look-right (yaw+ toward world −X) onto HUD east; compass markers, minimap disc X and full-map UV X use the same east-is-right convention. Owner PIE of this correction is pending.
• Minimap มี player heading, squad members/markers, pings, bed, base, vehicle, death bag, boss และ POI ตาม visibility filters
• World map เปิดเผยทั้งหมดตั้งแต่เริ่ม ไม่มี fog of war; ผู้เล่นเปิด/ปิด marker category แต่ละประเภทได้
• World map รองรับ pan, zoom, center player, place/remove ping และ marker legend ทั้ง mouse/controller

Throw input — confirmed 2026-09-09

For now every item may be thrown. Hold IA_Throw to wind up and release after full windup to throw. Releasing early or pressing either mouse button during windup cancels; releasing after cancellation must not throw. Use the occupied hand, with right-hand priority when both hands hold items. Holding longer does not increase force or speed. Windup duration and fixed launch speed belong to each item definition. Confirmed defaults: 0.6 seconds and 900 cm/s. Throw exactly one unit from a held stack and leave the remainder in that hand. [CONFIRMED 2026-09-20] P10 keeps this throw for any held DA_Item_*. It is not a damaging thrown attack. Melee attack is a separate occupancy action and requires bMeleeWeapon.

Crosshair

[CONFIRMED 2026-09-08] Melee reticle เริ่มจากการถืออาวุธ melee โดยยังคง ADS-hidden และ Interaction priority เดิม การตรวจ chamber/magazine ใช้ input และ timed-action contract ใน Weapon Customization

Hand and ammunition truth

• แสดง Left/Right hand แยกกัน อาวุธสองมือรวมเป็น card กลางหนึ่งใบและล็อกอีกมือ
• Handedness มาจาก weapon/item Data Asset ไม่สรุปจาก category
• Magazine/chamber count เป็น UNKNOWN จนผู้เล่นทำ check action; UI เก็บ observed value แยกจาก authoritative hidden truth และ invalidate เมื่อ state เปลี่ยนโดยที่ผู้เล่นไม่อาจทราบ [CONFIRMED 2026-09-14] ความรู้นี้เป็น client-only และไม่ persist. ทุกครั้งที่ยิงกระสุนออกไป Chamber และ Mag กลับเป็น UNKNOWN ทั้งคู่
• World impact, blood, animation reaction และ audio เป็น natural combat feedback ที่อนุญาต

Interaction prompt

Prompt ถูก project ใกล้วัตถุแต่ clamp ไม่ให้หลุด safe zone แสดง input glyph, action, item/target, quantity, hold progress/duration, disabled/access-denied reason และ alternate actions ถ้ามี การใช้ controller เปลี่ยน glyph ตาม input device ล่าสุด

P13 map-specific spawn option — confirmed and implemented 2026-09-23: the owner approved Kit Proof Town only in /Game/Lambeer/World/Maps/KitProofTown/L_KitProofTown. The UI and server share the exact-package whitelist, normalizing PIE prefixes; other maps retain the existing four-town choices. The option still requires an authored spawn region. Non-PIE regression passed; owner runtime entry/respawn acceptance remains pending. Canonical P13 integration and acceptance checklist.

World Map & Spawn Reference

Spawn flow uses the same full-map component with selectable starter-town regions or the last selected bed.

• Initial spawn: หลัง character creation เลือกหนึ่งในสี่ starter towns ได้อิสระ แล้ว server เลือก valid point ภายใน perimeter ที่เลือก
• Respawn: เลือกเฉพาะ bed ที่เลือกไว้ล่าสุด หรือ Fresh Spawn; ไม่มี sleeping bag
• Fresh Spawn หลังตายเลือกหนึ่งในสี่ starter towns ได้อิสระอีกครั้ง
• Death marker หายเมื่อ loot bag despawn หรือถูกเก็บหมด

Frontend, Saves & Server Flow

Main Menu

• Continue (Single Player): เข้า world ล่าสุดที่จำไว้; disabled พร้อมเหตุผลเมื่อไม่มี local world
• Start Single Player: เปิด Save World Select เสมอ ไม่เขียนทับอัตโนมัติ
• Server Browser: Official/Community tabs, favorite, ping, population, name search, hide full/empty, compatible version และ friendly-fire filter เมื่อ server metadata มีค่า
• Settings, Feedback (external URL), Exit

Single Player

ใช้ gameplay rules และ persistence เหมือน multiplayer แต่ไม่มีผู้เล่นอื่นและ pause ได้จริง แต่ละ local world แยก save/persistence เหมือน server world รายหนึ่ง [CONFIRMED 2026-09-14] TBD-HUD-UI-003: shipping SP ใช้ embedded authority เป็น NM_Standalone ในโปรเซสเดียวกัน เพื่อให้ pause โลกได้ตามสัญญา G4. UI ของ save list ยังไม่ขึ้นกับ topology. รายละเอียด persistence อยู่ที่ TECH-NETWORK-ARCH.

Steam distribution

ไม่มี custom launcher/patcher ใน scope Steam Client เป็น launch/update surface หลัก Steam App ID, branch UX และ exact Feedback URL remain TBD-HUD-UI-004.

P08 implementation evidence — 2026-09-16: Native ULambeerMainMenuScreen, ULambeerSaveWorldScreen, ULambeerServerBrowserScreen, frontend/session subsystems and character-entry state are implemented. Unreal MCP created, compiled, saved and read back WBP_MainMenu, WBP_SaveWorldSelect, WBP_ServerBrowser and WBP_CharacterCreation. Owner reported the original Single Player frontend, Character Creation visual, persistence/restart and Pause Save/Exit checks passed. The later owner-supplied Save Worlds/Server Browser reference refresh is implemented in the native parent classes with shared opaque-id row buttons; closed-Editor LambeerEditor Win64 Development, focused Lambeer.Frontend automation 4/4 and both Widget Blueprint compile/save/readbacks pass. The refreshed presentation still requires owner PIE visual acceptance. Dedicated/listen persistable worlds advertise a Null/LAN session; one-process PIE lists those hosts by listen port because Null FindSessions cannot see the same-process beacon. Owner reported dedicated Pause/Exit/restore and Server Browser Refresh/Join. UE 5.8 Play As Client starts the dedicated world automatically. Feedback remains disabled while its URL is empty; Steam metadata and the production gameplay destination remain unresolved. Editor validation may use L_Dev_Sandbox only as a stand-in, never as approved production geography.

Inventory, Containers & Quick Slots

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.

Loot/container variant: เมื่อเชื่อมกับ corpse, death bag, crate หรือ storage ให้ซ่อน character preview ชั่วคราวและใช้พื้นที่กลางเป็น Player Inventory / Target Inventory แบบ side-by-side. Player container แต่ละใบแสดง Transfer All; target header แสดง Take All. Q1–Q0 และ action hints ต้องคงตำแหน่งเดิมเพื่อไม่ให้ muscle memory เปลี่ยน.

[G4 IMPLEMENTATION 2026-09-12; G4.2 CLOSED 2026-09-14] Interact กับ death bag/crate เปิด inventory และใช้ side-by-side Player | Target ผ่าน WBP_ContainerTransfer ที่ bind เป็น Transfer_Target; Scroll_Loot เป็น collapsed fallback. การแก้ child-button drag interception และ BackWeapon↔BackWeapon / directional HeldHand↔BackWeapon ผ่าน build, focused automation และ owner PIE แล้ว. Search ถูกถอดออกตามคำตัดสินของเจ้าของ. ไม่ vacuum-loot และไม่ฝากของกลับเข้า death bag.

Resolution behavior: FHD เป็น reference density; 2K/4K ใช้ DPI scaling ไม่เพิ่มจำนวนช่อง. 16:10 เพิ่มพื้นที่แนวตั้งให้ container list. 21:9/32:9 เพิ่ม outer gutters และรักษาความกว้าง content กลางแทนการยืด slot จนเสียสัดส่วน. ทุก region อยู่ภายใน Safe Zone.

• รองรับ drag-and-drop, click-to-select, context menu และ keyboard/controller navigation
• Actions: Split Stack, Transfer All, Take All, Sort, Inspect, Use, Equip, Drop Quantity; ไม่มี Search, Compare และไม่ต้อง confirmation
• Loot/container/corpse/death bag ใช้ player และ target container แบบ side-by-side
• Quick slots 10 ช่อง ปุ่ม 1–0; กดเพื่อถือ item แล้วใช้ด้วย left/right input ตาม item in hand
• [CONFIRMED] Slot 1–2 สงวนให้ Back Weapon 1–2 เท่านั้น ห้าม bind item อื่นลงสองช่องนี้ เมื่อไม่มี Back Weapon ช่องนั้นต้องว่างและไม่มี manual binding ที่ถูกซ่อนหรือ restore ภายหลัง
• Item ที่ผ่าน use/hold contract สามารถ bind ได้เฉพาะ Quick Slot 3–0; server ต้อง reject การ assign item อื่นเข้า display slots 1–2 (internal array indices 0–1).

Crafting, Queue, Skills & Achievements

Queue contract [CONFIRMED]

• Reserve/deduct materials immediately when adding; availability calculation subtracts every earlier queue reservation
• Cancel returns all reserved materials
• Queue continues after leaving station and after logout
• Station queue and player queue are separate per player and per station; order cannot be changed
• Station craft consumes only that station's storage; general personal craft consumes only player's carried inventory
• [CONFIRMED 2026-09-22] TBD-HUD-UI-005: if a station is destroyed, cancel that station's pending station-queue crafts. Put the station storage contents that still remain and the full reserved-material refund from those crafts into one recovery container at the wreck. The container accepts that refund in the destruction transaction, so the old storage capacity does not clip or delete items. Loot it through the existing crate/death-bag container transfer. It uses the same 24-hour world-up remaining despawn as death bags and runtime drops. Personal crafting queues stay with the player. Ordinary cancel still refunds into the living station's storage. Active queue rows and this container are saved on schema 1 outside the player record. See the implementation note below.

[IMPLEMENTED 2026-09-22] ULambeerCraftingSubsystem reserves top-level stacks immediately, keeps personal and station queues separate, and refuses reordering. Cancel returns every reserved slice to the living source. When that source has no free slot for a slice that cannot merge, cancel is refused and the row stays. Nested contents are not a crafting source. Station destruction cancels only that station's queues and spawns ALambeerStationRecoveryContainer with the remaining storage plus the full reserved slices. The container reuses crate/death-bag loot transfer, the death-bag full-loot slot/weight caps, the death-bag empty cleanup, and the 24-hour world-up despawn. It does not create a death marker. Queue rows are the optional CraftingQueues array on the schema-1 world-state payload. The wreck is world-drop kind StationRecovery. Schema version stays 1. StartSeconds, EndSeconds and RecoveryDropId are stored and remain unset. No recipe DataAsset, craft completion, output grant, or missing-output rule is in this slice. UI-SYS-002 is not started.

Skills

Dedicated screen displays every confirmed skill with exact XP, progress bar, Level 1–10 and next qualitative/numeric bonus. [CONFIRMED 2026-09-22] FEAT-CRAFTING-PROGRESSION defines the 100-XP starting threshold, 20%-per-level curve, 2,080-XP cap and numeric bonuses. The UI reads authoritative progress and does not calculate or award XP locally.

Achievements

Catalog/progress screen is scoped per character on each server. Unlocks grant rewards. Achievement IDs, names, thresholds, icons, reward payload and platform-service integration remain TBD-E2F4910C; UI supports optional hidden criteria and claim/non-claim reward presentation without selecting one until the catalog is approved.

Weapon Workbench & Magazine Planner

[PROPOSED LAYOUT] ซ้ายเป็น slot rail, กลางเป็น 3D inspect ที่หมุน/zoom ได้, ขวาเป็น action/context panel การเลือก hotspot ใน 3D และ slot list ต้อง sync กัน Controller ใช้ shoulder buttons สลับ slot และ right stick หมุนโมเดล

Magazine planner [CONFIRMED]

FMagazineLoadPlan
├─ HeadRounds[]       // ยิงก่อน เช่น AP ×3
├─ LoopPattern[]      // AP ×1, FMJ ×2 แล้ววนจนพื้นที่กลางเต็ม
└─ TailRounds[]       // ยิงท้าย เช่น FMJ ×10

BuildFireOrder(capacity):
  append HeadRounds
  repeat LoopPattern until remaining middle capacity is full
  if capacity ends mid-pattern, stop at that round
  append TailRounds in their specified fire order

Default load behavior ยังคงใช้ลำดับที่ผู้เล่น drag ammunition ใส่ magazine ผู้เล่นเปิด context menu ของ magazine เพื่อใช้ advanced planner สามส่วน Fire-order preview ต้องแสดงจากนัดแรกที่จะยิงไปนัดสุดท้ายอย่างชัดเจน

Building, Vehicle & Boss UI

[OWNER SELECTED 2026-10-14 — BUILD CATALOG] Tap R while holding WoodenMallet / another usable Hammer to toggle a centered Night Ops catalog. Choose category/piece, Resource and named Appearance, then Select & Place to restore the HUD and enter existing hologram placement. No selection click places a world site. Cursor and keyboard navigation are available; movement/look are blocked during selection. R release does nothing; R/Esc closes without creating a preview. Owner revision 2026-10-14 removes the separate lower selected-piece preview and gives its height to the grid; piece/Appearance thumbnails remain. Selection refresh retains the header, sidebar, Esc Close and scroll hosts; owner flicker report and correction. The held-Hammer HUD guide is localized EN/TH. The separate aimed-player Squad invitation ring remains. Canonical window, input, data, persistence and owner checklist.

Owner correction — repeated placement, 2026-09-30: Successful LMB placement keeps the preview and selected piece/material tier/rotation available for the next placement. Only one commit is in flight at a time; success/rejection releases that gate without exiting placement. RMB or ESC ends the mode, and ESC does not open Pause on the cancelling press. Late results cannot restore a cancelled mode or affect a replacement. See canonical behavior and validation. Owner PIE acceptance is pending.

Completed-name positioning correction — 2026-09-30: The owner reported a name card visibly detached from its item. Projection now converts viewport pixels into the actual UMG parent geometry rather than assigning pixels directly to a logical canvas. Completed building names use the mesh top-center with a small screen-space gap and bottom-center card alignment; per-frame tracking uses that same bounds anchor. The standalone fallback uses DPI-aware viewport placement. Existing interaction copy is retained. See owner evidence, correction and validation status. Owner camera/DPI/HUD-scale retest is pending.

Completed-piece focus correction — 2026-09-30; owner PIE pending: A completed building changes from construction interaction to an inspect-only piece name, including completion while focused and the completed garage child assembly. Both the material card and the generic E/Add available materials/Cannot interact prompt disappear. Inspect-only focus does not advertise an interaction reticle or dispatch E. No actual building HP currently exists, so the UI does not synthesize health. The prompt host suppresses the entire key badge and uses the native name card even if a legacy custom prompt visual is present. Continuous can-place feedback and placement rejection/retry now follow the building preview and result contract; the owner-only multiplayer checklist remains pending.

Historical Command Ring confirmation — 2026-09-30; superseded by Build Catalog 2026-10-14: Confirming the final piece/material-tier choice immediately closes the Command Ring, restores the HUD and enters placement preview while R may still be held. Releasing R afterward is a no-op because the radial is already closed; it must not duplicate or reset the preview. The confirming LMB press remains consumed for its input frame, so placing the selected piece requires a subsequent press. Category/piece navigation and material-tier selection remain the existing flow. Source: ALambeerPlayerController::SelectBuildingPiece commits via EndBuildingRadial, and the detached radial returns without refreshing choices. The closed-Editor LambeerEditor Win64 Development build passes, and 45 canonical HTML documents validate with zero errors/warnings. Owner-only PIE acceptance remains pending: hold R through final confirmation, check that the ring disappears and one preview appears, then release R and confirm that the preview remains through successive placements until RMB or ESC cancels the mode.

Building placement input follow-up — 2026-09-30: LMB while placing a preview is consumed for the entire input frame, including the duplicate raw-mouse/Enhanced Input callback after preview removal; it must not trigger melee or focus aim. The surface-placement correction and owner-approved reach are recorded in Building placement follow-up. Owner PIE retest remains pending.

Placement refinement — 2026-09-30: Free placement follows the footprint center under the crosshair and wheel rotation is fine-grained. Attraction uses completed construction's authored snap points; the world grid and unfinished holograms do not attract the preview. An invalid steep-ground Slab preview turns red and remains open when LMB is rejected. See free placement, snap rules, wheel rotation and center-ground validation for authoritative values. Owner-only PIE acceptance remains pending.

[OWNER CONFIRMED 2026-09-29] Tapping R while holding a usable item with Tool.Role.Hammer toggles the Build Catalog window. Selection leads to a local placement preview; valid placement creates a Squad-owned unfinished hologram that outsiders cannot see. A player without current Squad membership cannot place and receives a clear create-or-join-Squad placement failure reason. Current Squad members can contribute or remove it without holding a Hammer. A nearby member sees material progress as world-anchored UI at the hologram rather than a persistent global HUD element; completion occurs immediately when the bill is full. The catalog must remain distinct from the placed site and must not replace firearm Reload on R. The exact interaction range follows the existing interaction contract.

[HISTORICAL 2026-09-29/30 — SUPERSEDED BY BUILD CATALOG 2026-10-14] The former building radial presentation uses Night Ops concept 1, Command Ring (RawResource/UI/Building/Concepts_20260929/01_command_ring.png) as its starting reference. The owner confirmed the new wheel is visible and requested cursor-free relative mouse selection. The current implementation shows only the wheel and bottom R/mouse/LMB/RMB guide, with no separate outer border or other overlay panels; it temporarily collapses the normal gameplay HUD. Mouse movement highlights a wedge without moving the camera; LMB confirms it. Following the owner's PIE report that up/down selection was inverted, the mouse Y delta is reversed for the wheel. Owner PIE confirmation of the corrected mapping remains pending.

Clan, Squad, Chat & Voice

[OWNER CONFIRMED 2026-10-01] Aim at another player and press IA_Interact to open the building-style Night Ops Command Ring with only Invite to join squad. The recipient immediately gets a CommonUI modal with the inviter/Squad name and Yes / No; no Inbox navigation is required. No is initial focus, ESC declines, and controls wait for the server response. The Squad Invite action provides guidance instead of an online-player picker. Canonical flow, authority/persistence rules and owner PIE checklist.

[OWNER CONFIRMED 2026-09-30] The Squad screen keeps a compact optional logo beside its required display name. Upload Logo and Edit Name are Leader-only actions enforced by the server; exact limits and persistence are in the resolved Squad identity decision. [OWNER SELECTED 2026-09-29] Option 1 — Simple Full Roster with Logo is the selected Night Ops visual layout: centered Inventory / Squad tabs at the top edge above the content panel, a separate upper-right Close action, compact identity/actions header, aligned selectable roster rows and a separate activity panel below, without character portraits. Switching Inventory / Squad tabs preserves the clicked mouse position. Squad keeps gameplay visible through translucent panels using the Inventory shell color at alpha 0.80; roster/activity rows do not add opaque fills. Edit Name and contextual member actions open transient dialogs. The example content is illustrative. The native Squad runtime screen and Widget Blueprint now exist; owner PIE visual and multiplayer acceptance remain pending. Canonical selection.

• ไม่มี Squad roster HUD แต่ยังมี squad world marker, minimap/world-map marker, compass ping และ voice speaking indicator ใกล้ตัวละคร
• Group screen: Create, Invite, Invite Inbox, roster, Leader/Officer/Member, Promote, Kick, Leave; ไม่มี Search/Join
• Leader และ Officer เชิญสมาชิกได้; build/door/storage access ไม่แยกตาม role
• Activity log แสดง actor/action/target สำหรับ invite, kick, leave รวมถึง member death, online และ offline
• Text chat channels: Server, Proximity, Squad
• Voice: proximity/squad channel selector, push-to-talk, speaking indicator, per-player volume, mute และ block

TBD-HUD-UI-007: Clan creation naming/tag rules, role authority สำหรับ promote/kick และ log retention/persistence ยังไม่ถูกกำหนด

Death, Pause, Settings & Accessibility

Death/respawn

แสดง killer/cause, death location และ full map ผู้เล่นเลือก bed ที่เลือกไว้ล่าสุดหรือ Fresh Spawn เท่านั้น Fresh Spawn เปิดการเลือกสี่ starter towns ไม่มี sleeping bag marker

[G4 IMPLEMENTATION 2026-09-12] สำหรับ Gate G4, last selected bed คือเตียงที่เริ่ม Sleep ล่าสุด ไม่มี sleeping bag และยังไม่มี action แยกสำหรับเลือก spawn bed. G4 ไม่มี despawn timer ใน runtime; [CONFIRMED 2026-09-14] P07 กำหนด death bag และ runtime world drop ให้ persist และ despawn หลัง 24 ชั่วโมงเวลาจริงที่ world เปิดอยู่ โดยทดเวลาที่เหลือหลังเปิดใหม่ — ดู TECH-NETWORK-ARCH. Loading a saved dead character reopens this spawn-select screen; it must not restore a locked corpse that can no longer die. Death marker ตาม bag ที่ยังมีของ หรือถูก debug-destroy. ของที่อยู่ใน worn backpack/pants/vest ถูก pack เข้า NestedContents ของใบนั้นตอน dump ไม่ถูกเทเป็นกองหลวมใน bag. กด interact ที่ death bag เปิด inventory loot panels (เลือกเก็บทีละชิ้น หรือ Take All) ไม่ดูดทั้งกองทันที. หลัง respawn ต้องล้าง blood overlay และ low-HP edges ที่ค้าง. WBP_DeathRespawn exists under /Game/Lambeer/UI/Map/. สี่ starter towns บน L_Dev_Sandbox เป็น labeled stand-in ในโฟลเดอร์ Outliner G4/SpawnRegions ไม่ใช่พิกัด production (TBD-WORLD-001 ไม่เปลี่ยน). Owner-reported pass 2026-09-12 สำหรับ packed backpack dump, loot-panel interact และ immediate-respawn HUD refresh. Owner-reported pass 2026-09-13 สำหรับ UI-CORE-005. Last Bed และ four-town Fresh Spawn ยังเป็น UI-CORE-006 และยังไม่ถูกตั้งชื่อใหม่. รายละเอียดเทคนิค: UI-CORE-005 / UI-CORE-006.

Pause

Single Player หยุดโลกจริง Multiplayer เปิด menu และบล็อก player input แต่โลก/server ไม่หยุด Owner correction 2026-09-14: ไม่แสดงข้อความ world-continues warning บน Pause UI. Owner decision 2026-09-15: เฉพาะ Single Player แสดง Save. [P08 DEDICATED DISCONNECT 2026-09-16] Exit to Main Menu แสดงทั้ง Single Player และ dedicated/listen clients: SP ยังบังคับ required-player save เมื่อ snapshot เก่ากว่า 30 วินาที; dedicated client disconnect โดยไม่ save ฝั่ง client เพราะ server Logout ยัง flush ตัวละครอยู่.

[G4 IMPLEMENTATION 2026-09-12] UI-CORE-007 ใช้ NetMode ของ session ไม่ใช่การเดาฝั่ง client: เฉพาะ NM_Standalone ที่ pause ได้. Owner-reported pass 2026-09-12 เดิมครอบคลุม dedicated-server warning, local input block, world continuity และ Resume/Escape/Back; owner-reported pass 2026-09-13 ครอบคลุม standalone PAUSED/world-pause. Owner correction 2026-09-14 supersedes warning presentation only: ถอดข้อความ warning ออกจาก current Pause UI แต่ไม่เปลี่ยน multiplayer world-continuity หรือ input behavior. [G5 PAUSE SAVE/EXIT OWNER-REPORTED PASS 2026-09-16] Save เรียก required-player snapshot ผ่าน ULambeerWorldPersistenceSubsystem และยังเป็น standalone-only. Exit ตรวจเวลาจริงตั้งแต่ durable snapshot ล่าสุดเฉพาะ SP; ถ้าเกิน 30 วินาทีต้อง save สำเร็จก่อนจึง travel ไป /Game/Lambeer/World/Maps/L_MainMenu/L_MainMenu และถ้า save ล้มเหลวให้ยกเลิก exit พร้อมแสดงสถานะ. Dedicated Exit to Main Menu ไม่ save ฝั่ง client. WBP_PauseMenu ใช้ native ULambeerPauseScreen::EnsureLayout. รายละเอียด: UI-CORE-007 และ G5 dedicated checklist.

Settings taxonomy

Graphics, Display, Audio, Voice, Controller, Mouse + Keyboard, Gameplay, HUD และ Accessibility รองรับ full key rebinding, hold/toggle aim-crouch-sprint, sensitivity แยก hip/shoulder/ADS และ invert axes

[G4 IMPLEMENTATION 2026-09-12] UI-CORE-008 เพิ่ม staged draft/apply/revert. G4 persist ได้เฉพาะ HUD Scale, Safe Zone Scale, language en/th และ Display resolution/window mode จาก engine GameUserSettings. Owner decision 2026-09-13: Text Scale ไม่ปรับใน G4 Settings (ล็อก 1.0); Text Size ยังอยู่ใน accessibility list สำหรับรอบ settings ถัดไป. Display ที่เสี่ยงต้อง Confirm ไม่เช่นนั้น revert ใน 15 วินาที (implementation clamp). หมวดอื่นแสดงเหตุผลและห้าม persist. Crosshair Customization, colorblind, subtitles, rebind, camera shake และ Disable Flashing ยังเป็น G8 หรือรอค่าที่อนุมัติ. Unreal MCP created, compiled and saved /Game/Lambeer/UI/Menus/WBP_Settings. Parent is ULambeerSettingsScreen. Designer tree is empty; runtime layout comes from C++ EnsureLayout. Owner reported Apply th left settings labels in English 2026-09-12; that screen had hardcoded English / ungathered NSLOCTEXT. Follow-through binds settings labels to ST_UI_Common_EN/ST_UI_Common_TH, applies FF_UI_Primary, and refreshes after Apply. Owner-reported pass 2026-09-13 สำหรับ Thai settings labels (no tofu), HUD Scale/Safe Zone persist, Display Revert และ stacking. Text Scale ถูกถอดจาก G4 Settings. Owner-reported pass 2026-09-13 หลัง rebuild: HUD ไม่มีตัวปรับ Text Scale. รายละเอียด: UI-CORE-008.

[CROSSHAIR SETTINGS EXTENSION — OWNER RETEST PENDING 2026-09-20] Crosshair Customization is no longer deferred: CrosshairStyleIndex accepts and persists values 0–9 in ULambeerUserSettings. The runtime-built WBP_Settings HUD panel exposes the selector with localized English/Thai field copy and a live 72×72 preview; the ten style names remain fixed English product names. Preview and gameplay share LambeerCrosshairDrawing::DrawStyle, so they cannot drift into different shapes. Unsupported values are rejected at Apply and sanitized to Precision Dot when loading old or invalid config.

Pause & Settings Night Ops — Gate G4.4

Option A

Centered Command — unselected reference.

Option B

Owner-selected implementation reference.

Option C

Minimal Operator Overlay — unselected reference.

Accessibility

• Semantic colorblind palette presets; สถานะไม่ใช้สีอย่างเดียว
• Subtitles สำหรับ dialogue/spoken narrative; ไม่มี environmental closed captions
• Reduce Camera Shake
• Disable Flashing: ใช้ black-frame feedback แทน white flash
• HUD Scale, Safe Zone, Text Size และ Crosshair Customization. Owner decision 2026-09-13: G4 Settings ไม่มี Text Scale (ล็อก 1.0); Text Size ยังเป็น required setting สำหรับรอบถัดไป
• English/Thai localization; layout รองรับ text expansion และ Thai line breaking
• ทุก CommonUI screen ใช้ mouse, keyboard และ controller ได้โดยไม่เกิด focus trap

Implementation Contract: Classes, Data & Events

รายการต่อไปนี้เป็นชื่อ target เพื่อให้ implementation สม่ำเสมอ ไม่ได้อ้างว่า source/asset มีอยู่แล้ว

Event surface [PROPOSED]

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

Gameplay Tags [PROPOSED]

UI.Layer.HUD | UI.Layer.Screen | UI.Layer.Modal | UI.Layer.Toast
UI.Screen.Inventory | Map | Crafting | Skills | Achievements | Group | Settings
UI.Status.Bleeding | Infection | Fracture | Poison | Cold | Hot | Wet | Encumbered
UI.Marker.Squad | Ping | Landmark | Death | Boss | Bed | Base | Vehicle | POI
UI.Input.Game | Menu | All
UI.Notification.Info | Warning | Critical | Reward

Input Actions

SVG Icon Asset Kit

[IMPLEMENTED 2026-09-07] Source: RawResource/UI/Icons/ · exactly 64 SVG files · 64×64 viewBox · white solid silhouette · transparent background. Unreal MCP imported 64 tintable 256×256 textures at /Game/Lambeer/UI/Common/Icons/T_UI_*; asset metadata preserves each source SVG because UE Texture Factory does not import SVG directly.

Platform glyphs remain at their verified paths under /Game/Lambeer/UI/ControllerGlyphs/PlayStation_Series/ and Xbox_Series/. G2 controller-data classes reference them without rename/modification; runtime device switching remains pending owner PIE evidence.

ui_stat_health.svg

ui_stat_stamina.svg

ui_stat_hunger.svg

ui_stat_thirst.svg

ui_stat_temperature.svg

ui_stat_energy.svg

ui_stat_sleep.svg

ui_stat_immunity.svg

ui_status_bleeding.svg

ui_status_infection.svg

ui_status_fracture.svg

ui_status_poison.svg

ui_nav_compass.svg

ui_nav_minimap.svg

ui_nav_map.svg

ui_marker_boss.svg

ui_combat_left_hand.svg

ui_combat_right_hand.svg

ui_combat_magazine.svg

ui_combat_chamber.svg

ui_system_crafting.svg

ui_system_building.svg

ui_system_vehicle.svg

ui_system_achievement.svg

Acceptance Criteria

Manual PIE Checklist

Decisions / Blocking TBDs

1. TBD-HUD-UI-001 — Resolved 2026-09-06: Back Weapon 1–2 exclusively own slots 1–2; other bindings are rejected and no manual-binding restore state exists.
2. TBD-HUD-UI-002 — Resolved 2026-09-06: Google Sans is approved; Thai coverage, repository/UE target paths, embedded OFL metadata, official source, and retained OFL.txt are verified.
3. TBD-HUD-UI-003 — Resolved 2026-09-14: shipping Single Player uses embedded NM_Standalone authority; UI save-list contract remains session-agnostic. Canonical persistence: TECH-NETWORK-ARCH.
4. TBD-HUD-UI-004 — Steam App ID/integration metadata และ Feedback URL
5. TBD-HUD-UI-005 — Resolved 2026-09-22: station destruction puts remaining storage and the full station-queue refund into one wreck recovery container. The container accepts that refund in the transaction, is looted like a crate or death bag, and uses the 24-hour world-up despawn. Persistence is P15, outside the current P07 record set.
6. TBD-E2F4910C — achievement catalog, thresholds และ reward payloads (preserved canonical ID)
7. TBD-HUD-UI-007 — clan naming/tag rules, promote/kick permissions และ log retention
8. TBD-HUD-UI-008 — Resolved 2026-09-06: visual tokens, layouts และ 64-icon solid/silhouette kit approved as documented.

Relationships & Source of Truth

เอกสารนี้เป็น source of truth สำหรับ presentation, navigation, widget hierarchy และ player-facing state เท่านั้น Gameplay values, authority และ persistence ยังคงอยู่ใน feature/technical document ที่เชื่อมโยง