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

[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]

รูปแบบเป็นแผ่นโลหะ/อุปกรณ์เอาตัวรอดที่นำมาประกอบใหม่ แต่ตัด texture grunge ออกจากพื้นหลักเพื่อรักษาความอ่านง่าย ใช้ขอบเหลี่ยมมนเล็กน้อย, เส้นแบ่งชัด, shadow ต่ำ และสี brass เป็น accent เฉพาะ focus/selection/action

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

[CONFIRMED] แสดง Health, Stamina, Hunger, Thirst, Temperature, Energy, Sleep และ Immunity ตลอดเวลาเป็น icon + bar โดยไม่แสดงตัวเลข ค่าผิดปกติใช้รูปทรง/ไอคอน/ข้อความร่วมกับสี

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 วินาที
• ไม่มี option ลดหรือปิด blood/wet effects
• Disable Flashing เปลี่ยน white flash เป็น black-frame feedback โดยไม่ตัด critical information

Compass, Map, Combat & Interaction

Compass tape / minimap

• Compass แสดง cardinal/intercardinal, degrees และ marker projection สำหรับ squad pings, landmarks, death bag และ boss
• 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

Crosshair

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 เปลี่ยนโดยที่ผู้เล่นไม่อาจทราบ
• 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 ล่าสุด

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 รายหนึ่ง Exact local server process topology remains TBD-HUD-UI-003 ใน technical design; UI ไม่ขึ้นกับว่าจะเป็น standalone process หรือ embedded authority

Steam distribution

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

Inventory, Containers & Quick Slots

• รองรับ drag-and-drop, click-to-select, context menu และ keyboard/controller navigation
• Actions: Split Stack, Transfer All, Take All, Sort, Search, Inspect, Use, Equip, Drop Quantity; ไม่มี 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
• If station is destroyed, cancel its pending crafts and return reserved items to the authoritative station-destruction recovery path; exact overflow destination remains TBD-HUD-UI-005

Skills

Dedicated screen displays every confirmed skill with exact XP, progress bar, level and next qualitative/numeric bonus. Level caps, XP curves and formulas remain canonical TBDs in Crafting & Progression.

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

Clan, Squad, Chat & Voice

• ไม่มี 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

Pause

Single Player หยุดโลกจริง Multiplayer เปิด menu และบล็อก player input แต่โลก/server ไม่หยุด พร้อม persistent warning “WORLD CONTINUES WHILE MENU IS OPEN.”

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

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
• 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

[CONFIRMED 2026-09-06] Source: RawResource/UI/Icons/ · exactly 64 SVG files · 64×64 viewBox · white solid silhouette · transparent background · tint in UMG · approved import target /Game/Lambeer/UI/Common/Icons/T_UI_*

Platform glyphs ใช้ source ที่ตรวจพบแล้วใน Content/Lambeer/UI/ControllerGlyphs/PlayStation Series/Vector/ และ Xbox Series/Vector/ ห้ามเปลี่ยนชื่อหรือดัดแปลงโดยไม่ตรวจ license/source package

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 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 — Single Player authority process topology; UI contract ไม่ขึ้นกับคำตอบ
4. TBD-HUD-UI-004 — Steam App ID/integration metadata และ Feedback URL
5. TBD-HUD-UI-005 — destination เมื่อ station destruction refund เกิน storage capacity
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 ที่เชื่อมโยง