40 — UI/UX & HUD (giao diện, điều hướng, HUD trong bầy)

Mục đích: đặc tả TOÀN BỘ giao diện Bladewake cho PC Steam (tay cầm trước, bàn phím/chuột đủ) + Steam Deck: hệ toạ độ UI, bộ UI kit (font có dấu tiếng Việt, token màu, 9-slice, icon, glyph nút), danh mục màn có id, bố cục từng màn ở 1920×1080 và 1280×800, phần tử + trạng thái, đồ thị điều hướng (thứ tự focus tay cầm, KB/M), chuyển động, âm SFX_UI_*, giới hạn chữ cho loc, HUD đọc được giữa 150–250 quái, thanh boss có glyph thích nghi, móc trợ năng, luồng onboarding. Phụ thuộc: 00-Design-Bible.md + data/_bible.json (INV-01/02/08/09/15/16, §1.1 bản đồ nút, §2 run, §3 hub, §4 Khăn Tang/mode/Thương Xót, §6 draft/rarity/icon, §8.4 Tro Nhớ UI, §10.3 loc/font, §10.4 camera) · 10-Combat-Core §6.5 (số sát thương, callout), §4.1 (Thế), §8 (HP, khiên, bình) · 11-Defense-Tells §4 (trợ năng tell) · 12-Hero-Framework §1 (input, glyph), §2.2 (hud.element tài nguyên) · 13-Upgrades-Builds §2–§4, §8–§12 (draft, Đổi/Xoá/Giữ, Cộng Hưởng, Tiến Hoá, Relic, Sạp Rong) · 14-Adaptive-AI §14 (Mắt Tro, ◆, callout) · 16-Run-Structure-Map (luồng, bản đồ, thưởng, cổng boss, tổng kết, lưu) · 18-Meta-Hub-Progression (trạm, menu trạm, codex, onboarding 3 run) · 30-Art-Direction §2.2, §3.6, §5.3 (zoom, token hệ thống, portrait) · 31-VFX-Bible §1, §2.4 (thứ bậc hiển thị, lớp screen) · 32-Audio-Bible §3.7, §7.1 (cue nhạc, 37 SFX_UI_*) · 43-Steam-Platform §8, §12 (Deck, glyph, loc) · data/av/UI.json (27 VFX_UI_*, 37 SFX_UI_*) · demo GDD/08-Arena-HUD.md (lịch sử). Được dùng bởi: dev Unity (UI prefab, UIManager + UiScreen, HudController, BossBar, DraftScreen, MapScreen, HubMenu*, InputGlyphs, TextCanvas), agent UI/mockup (/new-ui, /refactor-ui), artist UI kit (9-slice, icon, font), agent loc (giới hạn chữ, ngữ cảnh), QA (checklist Deck, test 5 s HUD), hub .claude/docs/ArtStyle.md §8 (bản tóm tắt token/kit).

• Thứ bậc: Bible + _bible.json > doc nền (10–17, 20, 30–32, 51) > doc này. Doc này KHÔNG đặt số gameplay (thời gian draft, giá, %): chỉ trích lại và trình bày. Số UI mới (px, thời lượng tween, α) do doc này sở hữu; số [ASSUMED] chỉnh ở tuning.json section platform/vfx (khoá ui_*).
• Tên hiển thị chốt (Bible §11): Khăn Tang / Độ Tang (MRN01–MRN15) · Act Mutator (MUT01–MUT12) · Dạng Rèn (Song Liềm Tro H01_AS1…) · Dư Âm (ULT_GAUGE) · ĐÁP (chạm RB/RMB) + verb giữ riêng hero · Then Chốt (Gió Gạt H01_E37–E40) · Tro Nhớ / Mắt Tro / ◆ · Vàng Mã, Tro Hồn, Mảnh Vọng, Nến Canh. UI không bao giờ hiện id loại (ASPECT, LINCHPIN, CV).
• Id màn = enum code UiScreen.<Name> (không phải id dữ liệu, không vào JSON). Prefab: UI_<Name>.prefab trong Assets/_Project/UI/Screens/.

0.1 Đơn vị & canvas

0.2 Lớp render UI (Unity, trên mọi sorting layer world — 30 §8.3, 31 §2.4)

1.1 Font (pixel, có đủ dấu tiếng Việt)

• Quyết định: studio tự vẽ bộ font bitmap FNT_BW_* (Latin + Latin Extended-A + 134 ký tự tiếng Việt dựng sẵn + Cyrillic + ký hiệu game) trên lưới pixel cố định; không dùng font thư viện pixelfx (không giấy phép, 30 §1). CJK (zh-CN, JA, KO) = 1 font bitmap 12 px giấy phép mở cho thương mại, chọn ở M10, ghi tên + giấy phép vào hub ArtStyle §8d; tên font không ghi trong GDD.
• Dấu chồng tiếng Việt (ể, ặ, ỗ, Ữ) = 2 tầng trong vùng dấu, không đè dòng trên; không tầng dấu nào được cắt khi line_height như bảng.

• Sàn đọc Deck (43 §8.2): chữ nhỏ nhất ≥ 12 px cao trên màn → FNT_BW_S 15 px ✓; thân ≥ 16 px → FNT_BW_M 21 px ✓; CJK 24 px ✓.
• Màu chữ chỉ từ token §1.3; viền chữ trên nền world (HUD, callout, nameplate) = 1 px ui-ink 8 hướng; trên panel: không viền.
• Số: chữ số đều bề rộng (tabular) ở mọi font; dấu nghìn theo locale (VI "1.234", EN "1,234").

1.2 Bậc chữ (Trợ năng "Cỡ chữ" 100 / 125 / 150%; ui_text_scale_min Deck 1.25)

• Font pixel không co giãn lẻ: "125%" = đổi font theo bảng, không scale. Mọi hộp chữ body phải chứa 125% không tràn (Deck mặc định); 150% được phép cuộn (thanh cuộn 2 px, cuộn bằng RS / con lăn).
• Đổi cỡ chữ sống, không cần khởi động lại; màn đang mở dựng lại bố cục trong ≤ 1 frame.

1.3 Token màu UI (screen-space; nguồn duy nhất cho mọi màn — đồng bộ sang hub ArtStyle §8b)

Luật: UI không áp slot hero INV-01b (INV-01g) nhưng áp INV-01a — không pixel UI nào có S ≥ 45% ở hue 32–62° hoặc 260–290° (để không lẫn tell vàng/tím); ngoại lệ (chỉ phần tử ĐANG biểu diễn tell, dùng đúng #ffd84a/#b14cff + hình ◇/▲/chấm): mũi tên tell ngoài màn, glyph Y/P/N trong recap INV-16 và phụ đề tell, ảnh minh hoạ tell ở Sân Tập/codex/Cài đặt (§4.6 H9). Mọi token dưới đã kiểm: cột "Hue / S".

• Thêm màu = thêm token ở bảng này (lý do + màn dùng) trước khi dùng (rule art-style). Màu slot hero chỉ dùng ở: Dư Âm đầy, khung chân dung HUD 1 px, lửa chọn hero (HeroSelected ở Lửa Canh (chọn hero / ult / Dạng Rèn / kỹ năng khởi đầ… VFX_UI_hero_select), icon ghép Edge hero (dấu hero).
• Mù màu: mọi phân biệt bằng màu ở UI có thêm hình: rarity = số chấm góc thẻ (§1.6), nút bản đồ = icon, tiền = icon riêng, trạng thái = glyph.

1.4 9-slice (UI_Kit atlas, 1 trang 1024², PPU 25, Point, pixelsPerUnitMultiplier 1)

Phong cách: bevel bậc (hàng sáng trên-trái ui-bevel-lit, hàng tối dưới-phải ui-bevel-dark), viền ngoài 1 px ui-ink, ramp 3–4 bậc, chất liệu giấy tang/gỗ cháy/đồng xỉn (ArtStyle §6), không gradient mịn.

• Đổi skin theo bối cảnh: hub dùng biến thể _wood (gỗ ấm), run dùng _paper (giấy tang lạnh); cùng border, cùng kích thước → 1 prefab.

1.5 Icon & glyph

1.6 Thành phần chuẩn (prefab UI_C_*)

Cột World: RUN = World chạy · ×0.15 = World chậm + hero bất tử (draft phòng thường) · 0 = World dừng · HUB = hub chạy. Nhạc = cue doc 32 §3.7 đang phát (màn không đổi cue thì ghi "giữ").

3.1 Lệnh UI chung (action map UI trong InputActions, remap được, tách khỏi map Gameplay)

• Thanh nhắc nút UI_C_PromptBar: dòng đáy mỗi màn (y = 251, cao 12): tối đa 5 cặp glyph + nhãn ≤ 12 ký tự, căn phải; đổi bộ glyph sống.
• Focus đầu vào mỗi màn ghi ở cột "Focus đầu" của §5–§6; quay lại màn đã mở trong cùng phiên → khôi phục focus cũ.
• Lưới: không vòng ngang; danh sách dọc: vòng. Điều hướng khai báo tường minh (Selectable.navigation = Explicit), không tự động theo khoảng cách.
• Chuột: hover đặt focus + tooltip; bấm ngoài panel không đóng màn (tránh mất thẻ draft); con lăn cuộn danh sách dưới con trỏ.
• Chống bấm nhầm: màn mở do sự kiện (draft, thưởng, cổng boss, chết) khoá xác nhận 0.30 s đầu (input vẫn di chuyển focus) — tránh nút Đánh/ĐÁP đang bấm dở chọn thẻ.
• Tự tạm dừng theo game.auto_pause_focus (42 §8; bật mặc định, khoá BẬT trên Deck): khi bật, mất focus cửa sổ / overlay Steam → mở Pause (run) ngay trong frame (43 §8.3), trừ màn đã World 0; khi tắt (chỉ PC) cửa sổ mất focus vẫn chạy. Deck suspend và tay cầm rời luôn tạm dừng, không phụ thuộc option (tay cầm rời → Pause/HubPause + lớp phủ PadLost).

3.2 Đồ thị màn

boot → [CrashPrompt nếu crash lần trước + "Hỏi mỗi lần"] → [SaveConflict | SaveNotice nếu có] → (lần đầu) PhotoWarning → Language → Consent → QuickSetup → Title
boot → (không phải lần đầu) Title
Title → Chơi lần đầu (FLAG_FIRST_WAKE) → cảnh mở đầu 20 s → ChoosePath → Loading → Hub(ST_HEARTH)
Title → Chơi → (có run dở? Confirm "Tiếp tục run / Bỏ run") → Loading → Hub | Map(điểm lưu)
Title → Settings | Credits | Thoát ; bản EA: Title → EaProgress ; bản demo: Title → Wishlist (overlay cửa hàng) | Góp ý (form web)
Hub(HubHud) ⇄ HubTravel ; Hub → INTERACT trạm → Hearth | Forge | DockDepart | Ledger | TestBell | Market | Yard | Wardrobe (B → Hub)
Hub → beat chờ → Dialogue → Hub
Hub → Menu → HubPause → Tiếp tục | Settings | BugReport | Thoát về tiêu đề (Confirm) → Title | Thoát game (Confirm)
DockDepart → [RankedNotice lần đầu DAILY/ENDLESS/BOSS_RUSH] → Xuất phát → [RushBuild nếu BOSS_RUSH] → Loading → ActIntro(I) → Map
Map → chọn nút → CombatHud | Shop | Rest | Secret | Event | BossGate
CombatHud → (lên cấp) Draft → CombatHud ; (phòng xong) Reward/Draft/SkillPick → Map
BossGate → CombatHud(boss) → BossVictory → Draft(boss) → [LinchpinPick] → [EvoFuse] → Dock → Loading → ActIntro(n+1) → Map
bản demo: BossVictory(BS_B1) → DemoEnd → Wishlist | Góp ý | Chơi lại → RunSummary → Hub
Hồi IV → Dock → CombatHud(FINALE_TRIAL) → CombatHud(BS_FINAL) → [FinalChoice] → Ending → Credits(lần đầu) → RunSummary
CombatHud → HP 0 → Revive (còn Lửa Gửi) → CombatHud | DeathRecap → RunSummary → Hub | "Thức Lại" → ActIntro(I)
mọi màn run → Menu → Pause → Settings | BugReport | Thoát về tiêu đề | Bỏ run (Hold 1.0 s) → RunSummary
tay cầm rời (mọi nơi) → Pause | HubPause + PadLost → (cắm lại) đóng PadLost, giữ tạm dừng

4.1 Vùng (UI px trong SAFE 427×267; giống hệt ở 1920×1080 và 1280×800)

y0 ┌XP══════════════════════════════════════════════════════════════════════┐
   │Lv12 ●●(+2)        ◆◆ NGƯỜI GÁC CHUÔNG                  12:34  ☠ 1.204 │
   │                   [██████████████░░░░|░░░░░] −1.234       ▤ 340        │
   │                   [▓▓▓▓▓▓▓▓░░ Thế]                        Chuỗi 86     │
   │                                                   ┌mục tiêu──────────┐│
   │                                                   │Chuông 2/3  ▬▬▬░  ││
   │                     (vùng giữa 160×100 KHÔNG HUD)  └──────────────────┘│
   │ ▣▣▣ Cộng Hưởng            NÓ ĐÃ ĐỌC BẠN: GẠT          [toast]           │
   │ ◫◫ trạng thái            [tinh · trái]                                 │
   │┌──┐ HP [████████░░] 96/120  ◉◉○          [LB][LT][RT]  ┌──┐           │
   ││☺ │ Dòng [██████░░░]                     [ 3 ][ ✓][ 5 ]  │ULT│          │
   │└──┘ ◇◇ ✚2 ✹                                            └──┘           │
y267└───────────────────────────────────────────────────────────────────────┘

• Vùng cấm HUD: rect 160×100 quanh tâm SAFE (133, 83, 160, 100) — không phần tử HUD nào, kể cả toast/callout, chạm vùng này. Cột phải (RUN, MODE, MODS, OBJECTIVE, TOAST) bắt đầu từ x ≥ 295 > 293 = mép phải vùng cấm.

Khối MODE theo mode (19 §5, 43 §6.2; mẫu loc {param}):

• Deck: không khác bố cục. Ở 125% chữ (mặc định Deck) chỉ khối có vai caption đổi FNT_BW_S → FNT_BW_M: LEVEL (h 12), số HP dời xuống (140, 229) — mọi rect trên đã chừa đủ 12 px.

4.2 Ô kỹ năng & Ult

4.3 Widget tài nguyên (hud.element, 12 §2.2; rect RES 96×8)

• Đầy tài nguyên (full_event): viền thanh loé 0.2 s, không âm UI riêng (âm do hero). Tài nguyên = 0 không nhấp nháy (INV-11: 0 vẫn ĐÁP).

4.4 Theo dõi mục tiêu (OBJECTIVE, 112×30)

Dòng 1 FNT_BW_S tên mục tiêu ≤ 18 ký tự · dòng 2 tiến độ chữ + thanh 104×3 ui-text-2. Đổi số → nảy ×1.2 0.1 s. Xong → dòng gạch ngang 0.4 s rồi khối mờ 0.3 s.

• CHL: thêm dòng "Thử Lửa ×2" + glyph mutator cục bộ / ◆ thế đáp bật sẵn. Phòng có MESO dịch spawn: ◆ nhỏ cạnh tên mục tiêu suốt phòng.

4.5 Thanh boss, nameplate, Mắt Tro

4.5.1 BOSSBAR (prefab UI_BossBar, 3 cỡ)

• HP: đoạn mất chuyển ui-hp-lag trễ 0.40 s rồi lùi 0.25 s; khấc 1×8 ui-ink ở mỗi ngưỡng pha (bosses/<id>.json pha theo % HP); số tích luỹ "−1.234" FNT_BW_S ui-text-2 bên phải thanh = tổng sát thương trong cửa sổ 1.0 s trượt, biến mất 1.0 s sau cú cuối. Màu HP boss = ui-text ngà trên nền ui-panel (không đỏ — đỏ là HP hero).
• Thế (bạc): chỉ hiện khi < 100% hoặc trong Vỡ Thế; Vỡ Thế → thanh nháy ui-poise/ui-text 4 Hz suốt 3.0–4.0 s (Giảm chớp → đặc liền + chữ "VỠ THẾ" FNT_BW_S) + callout "VỠ THẾ" (ưu tiên thấp nhất) (10 §4.1).
• Bất tử chuyển pha: khung đổi locked (2 xích 8×8 hai đầu), HP không giảm, boss_phase_change t = 0 VFX_SHARED_screen_phase; mở lại khi pha mới nhận đòn.
• Glyph thích nghi (doc 14 §14): 2 khe ◆ 9×9 bên trái tên (cỡ L: (75, 11) và (84, 11); cỡ M: dịch theo tên). Trạng thái mỗi khe: rỗng (viền 1 px ui-ash-eye) = thế đáp đã biết (codex) chưa bật · đặc ui-ash-eye = đang bật · nứt (đặc + vết nứt 1 px ui-ink) = Sẹo. Khe chưa gặp: không vẽ. Bật/đổi thế: khe loé 0.4 s đồng bộ khựng 0.6 s của boss. Tooltip của khe chỉ đọc được trong AshInspect. Khi chơi H02: ◆ thêm viền 1 px #2a2420 (DEC-2026-11-07-11).
• Thẻ MACRO đầu trận: (113, 44, 200, 24) NS_TOOLTIP "{boss} nhớ: bạn {habit} {pct}%" 2.5 s trong lúc khoá cổng (14 §9.3); cài đặt "Hiện số %" TẮT → "{boss} nhớ: bạn {habit} nhiều".
• Thanh vào: trượt từ y −20 trong 0.25 s sau thoại mở màn; boss chết: thanh vỡ thành tro 0.4 s đồng bộ hitstop kết.

4.5.2 Nameplate world (NS_NAMEPLATE, canvas WorldUI)

• Nameplate ở lớp dưới tell (Prioritize); khi glint Y/vùng P của chính Tinh Anh đó đang chạy, nameplate α 0.35.

4.5.3 Mắt Tro & AshInspect

• EYE: 0–3 con ngươi = số thế đáp đang bật ảnh hưởng hero (gồm MICRO ASH) (14 §14); loé 0.4 s khi bật/đổi; ngủ → mờ α 0.4; cấp hiệu dụng 0 (60 s đầu run, 3 run đầu đời, Thương Xót "Tro Nhớ 0", CUSTOM 0, HP < 25%) → mắt nhắm.
• Giữ View/Tab → AshInspect (World KHÔNG dừng): panel (93, 60, 240, 120) α 0.70, không che vùng cấm HUD quá 50% chiều cao; nội dung: tiêu đề "Tro đang nhớ" · ≤ 3 trục cờ bật "Gạt 72% · Lướt trái 64%" + lệch baseline "▲+30"/"▼−22" · danh sách thế đáp bật: tên kẻ địch · thói quen · mẹo (hint_key) · 2 khe ◆ của boss có tooltip. Nhả nút → đóng 0.1 s. Relic "Sổ Trắng": trục A01 hiện "—".
• Callout đổi thế: "NÓ ĐÃ ĐỌC BẠN: {habit}" 2.5 s ở CALLOUT + AshVariantOn (Tro Nhớ đổi thế: khựng 0.6 s + ◆ Mắt Tro, ≥ 1.0 s trước… SFX_SHARED_ash_read; MESO đầu phòng: "TRO DỒN BẦY: {name} · +{pct}% Tro Hồn" 2.5 s + AshMesoShift (callout MESO đầu phòng) + stinger surge SFX_SHARED_ash_meso. Phụ đề âm "[Tro đọc]" luôn kèm khi bật phụ đề.

4.6 Đọc được giữa bầy (150–250 quái)

Thứ bậc (cao → thấp, 31 §1): tell Y/P/N → thân hero + vòng chân + x-ray → FX hero → số sát thương → thân địch → FX địch → hazard trang trí → môi trường. HUD nằm trên tất cả về lớp vẽ nên phải nhường bằng độ mờ:

4.7 Sự kiện HUD (World)

Mọi màn 0/×0.15 dưới đây: lớp ui-dim phủ World, HUD ẩn trừ HP + RUN (để người chơi biết máu/tiền khi chọn). Rect theo SAFE; "Focus đầu" = phần tử nhận focus khi mở.

5.1 ActIntro (3.5 s, bỏ qua sau 1 s bằng A/Enter — 16 §7.3)

• Âm: MapOpen (sau phòng xong / nút bản đồ) SFX_UI_map_open khi lật thẻ. Nhạc cue biome vào ở giây 0.

5.2 Map (bản đồ Hồi; mở bằng d-pad lên / M ở bất kỳ lúc nào trong run để XEM — chọn nút chỉ khi ở trạng thái MAP)

• Focus đầu: nút có thể đi bên trái nhất của hàng kế. D-pad trái/phải: giữa các nút có thể đi của hàng kế; lên/xuống: xem các hàng khác (focus "xem", xác nhận bị khoá → UiError (hành động không được phép: thiếu tiền, khoá, ô đầy) SFX_UI_nav_error). Chuột: bấm nút có thể đi.
• Chọn nút: mực chấm vào nút 0.25 s (MapNodeChosen (chọn nút CMB/ELT/CHL/EVT/SHP/RST/SEC/RSC/MBS/BOS/DOCK) SFX_UI_map_node) → mờ 0.25 s → tải phòng. Mở map: MapOpen (sau phòng xong / nút bản đồ) SFX_UI_map_open, cuộn giấy trải từ dưới 0.3 s.
• 3 Hồi đầu tiên đời: tooltip 1 lần trên nút ELT "Cổng: phải qua 1 Cổng mỗi Hồi" (§10).

5.3 Draft (lên cấp / EDGE+; luật 13 §2–§4)

• Focus đầu: thẻ ô 1 (ô bảo đảm tag, = thẻ tự chọn). Trái/phải giữa thẻ, không vòng. Chuột: rê = focus, LMB chọn, RMB = Xoá (giữ 0.5 s).
• Khoá xác nhận 0.30 s đầu (§3.1). Hero bất tử suốt màn + 0.5 s sau chọn (World ×0.15) — màn không hiện gì thêm.
• Xoá Edge là nửa công thức Tiến Hoá → popup UI_C_Confirm "Khoá Tiến Hoá: {name}" (ui-warn), focus mặc định Huỷ (13 §4.2).
• Hàng đợi nhiều draft: mở liên tiếp, giữa 2 draft 0.2 s, tiêu đề "LÊN CẤP {n} · còn {count}".

5.3.1 Thẻ (UI_Card, 128×176; nội dung sinh từ mẫu câu params)

• Focus: thẻ nâng 2 px + con trỏ focus; thẻ khác α 0.85. DraftOpen: 3 thẻ rút ra lệch 0.06 s (cả màn chọn Relic/Edge hero đầu … VFX_UI_card_reveal (thẻ 2 trễ 0.06 s, thẻ 3 trễ 0.12 s, trượt lên 24 px 0.18 s) + DraftOpen (sau LevelUp; 3 thẻ rút ra lệch 60 ms; snapshot SN_DRAFT) SFX_UI_draft_open; rê UiCardHover (focus/rê sang thẻ trong draft, shop, chọn Relic) SFX_UI_card_hover; chọn DraftPick (thẻ được chọn; các thẻ khác rơi xuống α → 0) VFX_UI_card_pick_burst + DraftPick rarity=COMMON|RARE|EPIC (biến thể 01 COMMON, 02 RARE, 03 EP… SFX_UI_card_pick (Then Chốt/LEGENDARY DraftPick rarity=LEGENDARY (Then Chốt) hoặc chọn thẻ Tiến Hoá SFX_UI_card_pick_legend, Lời Nguyền DraftPick/hiện thẻ Relic Lời Nguyền RL049–RL060 SFX_UI_card_cursed), 2 thẻ còn lại rơi xuống 0.12 s; Đổi/Xoá/Giữ DraftReroll (Đổi, biến thể 01) · DraftBanish (Xoá, 02) · DraftHold (G… SFX_UI_card_edit (3 biến thể).
• Thẻ kỹ năng trong draft: khung SKILL, chân phải "Học mới" / "Đổi" / "Hạng I → II".

5.4 SkillPick · LinchpinPick · Tiến Hoá

5.5 Reward · Rest · Secret · Event · Shop · Dock · BossGate

5.6 Pause (Menu / Esc; World + Hero dừng; nhạc snapshot pause; UiPause open/close (snapshot SN_DRAFT; World + Hero dừng) VFX_UI_pause_dim, UiPause open/close (Start / Esc; snapshot SN_DRAFT; UI ignoreListener… SFX_UI_pause)

• Focus đầu: Tiếp tục. B/Menu = Tiếp tục. Mở/đóng: panel trượt 8 px + mờ 0.12 s.

5.7 Chết, hồi sinh, thắng, tổng kết, kết

5.7.1 Nguồn nội dung Credits (Assets/_Project/Data/credits.json, sinh lúc build)

6.1 Khởi động & tiêu đề

• "Chơi" khi có run dở → UI_C_Confirm "Tiếp tục run · Bỏ run" (Bỏ = UI_C_Hold 1.0 s, 16 §11). Lệch content_version không migration → chỉ còn "Bỏ run".

6.2 Hub (HubHud, HubTravel, Dialogue)

• Mở menu trạm: hero dừng, camera giữ; panel trượt từ phải 0.15 s; UiPopupOpen / UiPopupClose (biến thể 01 open, 02 close) SFX_UI_popup. Đóng: B → về hub ở đúng vị trí.
• Menu / Esc ở hub (không màn nào mở) → HubPause (§6.13): đường duy nhất từ hub về Title hoặc thoát game.

6.3 Settings (7 tab; mọi thay đổi áp ngay, "Mặc định" theo tab: UI_C_Confirm)

42 sở hữu mọi option, khoá, giá trị và mặc định; bảng dưới chỉ xếp chỗ: mỗi ô = khoá tên · giá trị · mặc định PC / Deck (1 giá trị = cả hai), đúng thứ tự 42. Lệch 42 → 42 thắng, sửa bảng này.

• Bố cục: tab (14, 8, 400, 14) · danh sách mục (14, 26, 250, 218), dòng 16 · mô tả mục focus (270, 26, 143, 218) body + ảnh minh hoạ 128×72 (Trợ năng: ảnh tell trước/sau). Focus đầu: mục 1 của tab. Trái/phải đổi giá trị (UiSliderStep (mỗi bước thanh trượt; pitch = −6..+6 bán cung theo giá … SFX_UI_slider_tick); A bật/tắt; tab UiTabSwitch (LB/RB, Q/E, click tab) SFX_UI_tab_switch.
• Đổi độ phân giải/chế độ cửa sổ → popup "Giữ thiết lập này?" tự quay lại sau 10 s.

6.4 Khuôn menu trạm (UI_StationMenu, dùng cho §6.5–§6.12)

• Luật mua (18 §2): A mua; giá ≥ 500 Tro Hồn hoặc ≥ 10 Mảnh Vọng → UI_C_Hold 0.5 s. Thiếu tiền: dòng + nút xám, giá ui-warn + "thiếu {value}", A → UiError (hành động không được phép: thiếu tiền, khoá, ô đầy) SFX_UI_nav_error. Mua xong: CurrencyChanged delta<0 (mọi tiền meta; Phục Dựng, nâng trạm, mở hero… SFX_UI_currency_spend + UnlockGranted (hero/Dạng Rèn/ult/mode/trang codex) và MasteryRankUp VFX_UI_unlock_seal (mở khoá) + UnlockGranted (hero 01 · Dạng Rèn 02 · ult 03 · mode 04 · trang codex… SFX_UI_unlock; dòng chuyển "ĐÃ MỞ".
• Focus đầu: dòng mua được rẻ nhất; không có → dòng 1. Danh sách dọc vòng; phải → nhảy sang chi tiết (khi chi tiết có nút).

6.5 Hearth — Lửa Canh (Lửa Canh ST_HEARTH)

Tab Kẻ Thức (bố cục riêng, không khuôn §6.4):

• A trên hero đã mở → focus sang "Hành trang"; A trên ô → Loadout (popup (63, 30, 300, 210)): Ult 3 thẻ thu gọn 96×120 · Dạng Rèn 3 · Kỹ năng lưới 4 × 2 icon 32 + tên (chọn đúng 2, ô đã chọn đánh số 1/2 = ô LB/Q và LT/E); mục chưa mua: ui-locked + "Lò Rèn: {value} Mảnh Vọng". UP_WARDROBE_2 → chân dung chạy anim Dạng Rèn đang focus.
• Âm: đổi hero HeroSelected (Lửa Canh: xác nhận hero / ult / Dạng Rèn / 2 kỹ năng kh… SFX_UI_hero_select; chọn kỹ năng SkillLearned / SkillSwapped / SkillRankUp (draft SKILL, hub chọn 2 kỹ… SFX_UI_skill_learn.

Tab Phục Dựng: GD1–GD5 dòng (giá, mở gì, cảnh truyện) — mua = UI_C_Hold 0.5 s (giá ≥ 500) → cảnh 4 s RestoreStageBought GD1–GD5 (t=0 cảnh) SFX_HUB_restore_stage. Tab Nâng trạm: UP_HEARTH_1–4 (khuôn §6.4).

6.6 Forge — Lò Rèn Vọng: tab Rèn Kẻ Thức (12 dòng: điều kiện chiến công + giá 0–16 Mảnh Vọng; rèn → cảnh 4 s ForgeUnlock (rèn mở hero): 3 nhát cách 0.3 s + tôi nước t=0.9 s SFX_HUB_forge_unlock) · Dạng Rèn (12 hero × AS2/AS3 8/15) · Ult (UL2/UL3 6/10) · Tiến Hoá (công thức EVO1–EVO4 mỗi hero: đã lộ = 2 icon + điều kiện; chưa = bóng "?"; EVO4 hiện ở MR12) · Nâng trạm (UP_FORGE_1–5).

6.7 DockDepart — Bến Đò

• "Xuất phát" (A) → cảnh đò 6 s (DepartConfirmed ở ST_DOCK (t=0 cảnh 6 s) SFX_HUB_dock_depart) → ActIntro. Có run dở → UI_C_Confirm "Bỏ run đang dở?". Lần đầu (Hub chỉ hiện ST_HEARTH + ST_DOCK; bật hàng đợi onboarding run 1. FLAG_FIRST_WAKE): chỉ hiện Hành Trình.
• DAILY / Truy Tuần / ENDLESS / BOSS_RUSH: lần đầu chọn → RankedNotice (§6.13); dòng "Xếp hạng: Bật / Chơi không xếp hạng" (X đổi) trong Chi tiết; "Chơi không xếp hạng" hoặc lượt DAILY đã dùng → run gắn thẻ "TẬP" (khối MODE §4.1).

6.8 Ledger — Sổ Tang (tab: Codex · Lịch Sử Run · Bia Mộ · Sổ Thù · Bàn Thờ Ký Ức · Sưu Tập · Bảng Xếp Hạng)

• Codex: cây mục trái (Kẻ Thức, Kẻ địch, Tinh Anh, Boss, Nơi chốn, NPC, Relic, Tro Nhớ, Truyện); trang CDX_*: mục "bóng" = tên + hình đen; trang đã viết: tranh 160×90 (nếu mua ART_*) + chữ body cuộn + tab con "Frame data" (UP_LEDGER_1) + "Thế đáp" (trục, thói quen, mẹo, đòn bị đổi; 14 §14). Trang mới "!"; đọc ≥ 2 s = đã đọc (18 §9). Lật trang LedgerPageTurn (Hol idle 8–12 s; đổi tab/trang Sổ Tang) SFX_HUB_ledger_page.
• Lịch Sử Run: bảng 100 dòng (hero, mode, Độ Tang, kết quả, phút) → A mở build (như RunSummary tab Build, chỉ đọc).
• Bia Mộ: 12 bia (TMB_Hxx từ MR18); "Thắp Nến Bia" 25 Nến Canh/nến.
• Sổ Thù: boss Hồi × hero: 5 bản ghi (ngày, kết quả, Độ Tang, thói quen nổi bật), thế mở màn dự kiến, Sẹo; "Xoá Sổ Thù" UI_C_Hold 1.0 s.
• Bàn Thờ Ký Ức: danh sách Sẹo đang khắc → "Gột" 200 Tro Hồn (UP_TEST_BELL_4: 150), UI_C_Hold 1.0 s.
• Sưu Tập: thanh % 12 nhóm (18 §9) + "Hoàn tất tài khoản". Bảng Xếp Hạng: Leaderboard — tab DAILY/Truy Tuần/ENDLESS/BOSS_RUSH × Toàn cầu/Bạn bè/Quanh tôi; 10 dòng/trang (hạng, tên Steam ≤ 16 ký tự + "…", điểm, hero glyph).

6.9 TestBell — Chuông Thử

• Khăn Tang (sau END_BELL_TOLL): 15 dòng MRN (glyph 8×8 + tên + bậc ô vuông 0–max + điểm/bậc); trái/phải tăng/giảm bậc; khoá: MRN11–MRN15 trước GD3 (ui-locked + "Phục Dựng GĐ3"); số "Độ Tang {do_tang}" FNT_BW_XL góc trên-phải + vải khăn MourningBandChanged (buộc/cởi MRN01–MRN15 ở Chuông Thử) VFX_UI_mourning_knot; mỗi đổi MourningBandChanged (buộc/cởi MRN01–MRN15: lớp vải; tổng Độ Tang đổi:… SFX_UI_mourning_band. Chi tiết: hiệu ứng đầy đủ + thưởng (Nến Canh = Độ Tang, mốc 4/8/16/24/32).
• Mắt Tro: UP_TEST_BELL_1/2 → 1/3 trục PSP cao nhất (chữ + thanh); không đổi Tro Nhớ. Đổi Nến Canh: thanh trượt bội 100 Tro Hồn → "= {n} Nến Canh"; UI_C_Hold 1.0 s (1 chiều). Nâng trạm.

6.10 Market — Chợ Đò: tab Pool (Edge chung + Relic chưa mở; lọc LB/RB phụ theo loại, X đổi lọc tag/rarity; thứ tự rẻ trước, nhóm theo tag — 18 §6.5; sau GD2 +12 mục) · Lễ Vật (LV01–LV06, chọn ≤ 1 (UP_MARKET_3: 2), tắt khi mode đã chọn là DAILY/BOSS_RUSH: "Không dùng ở chế độ này") · Nâng trạm (UP_MARKET_1–5).

6.11 Yard — Sân Tập (menu nổi trên sân, World chạy)

• Panel thu gọn (283, 30, 140, 200) mở bằng INTERACT tại Răm: Dummy (tell Y/P/N, hạng S/M/L/XL, hệ số windup ×1.0–×2.0, tốc, nhịp lừa bật/tắt, mẫu boss — UP_YARD_1) · Bài tập ĐÁP (10/30 lần, đếm hoàn hảo) · Frame data (overlay hitbox + số tick trên dummy) · Replay 10 s (UP_YARD_2: 30 s) · Đo DPS (cửa sổ 10 s) · Thử Thách TT1–TT5 của hero (tiến độ chỉ đọc) · Xem trước Trợ năng.
• Panel không che hero: tự lật sang trái khi hero ở nửa phải màn. 0 thưởng (18 §2).

6.12 Wardrobe — Tủ Áo Tang (GD4): tab Skin (hero → 4 skin, xem trước LUT trên _select) · Trang trí (6 tượng, 18 hộp nhạc — A nghe thử 10 s, 30 tranh) · Hành trang lưu (UP_WARDROBE_1: 3 ô) · Màu phụ (UP_WARDROBE_3, trong slot INV-01).

6.13 Màn hệ thống & thông báo (#44–#53, trạng thái Leaderboard)

7.1 Luật chuyển động (ArtStyle §8e)

• Mọi vị trí bắt vào lưới UI px; không co giãn lẻ (chữ/khung pixel không scale 1.25 — "nảy" = dời 1–2 px hoặc đổi sprite); không blur; easing outQuart lấy mẫu rồi làm tròn về UI px.
• Đồng hồ: UI chạy đồng hồ Real (không theo World ×0.15/×0.3, không theo slow-mo); tạm dừng dừng mọi tween HUD trừ con trỏ focus.
• "Giảm chuyển động": bỏ hạt UI, bỏ trượt (chỉ mờ α), con trỏ focus đứng yên, DraftOpen: 3 thẻ rút ra lệch 0.06 s (cả màn chọn Relic/Edge hero đầu … VFX_UI_card_reveal = hiện cùng lúc; thời lượng mờ giữ nguyên.

7.2 Bản đồ âm UI (37 SFX_UI_*, bus UI, đồng hồ UI — 32 §7.1)

• Âm hệ thống dùng lại từ SHARED/HUB (không phải UI): AshVariantOn (Tro Nhớ đổi thế: khựng 0.6 s + ◆ Mắt Tro, ≥ 1.0 s trước… SFX_SHARED_ash_read, AshMesoShift (callout MESO đầu phòng) + stinger surge SFX_SHARED_ash_meso, UltGaugeFull (Dư Âm ULT_GAUGE = 100), 1 lần, không lặp SFX_SHARED_ult_ready, LevelUp (trước DraftOpen; nhạc stinger level_up của MusicDirector) SFX_SHARED_level_up, HeroLowHp (HP < 25%) bật loop; tắt khi HP ≥ 30% hoặc chết SFX_SHARED_hero_low_hp, RoomCleared (+ stinger nhạc room_clear) SFX_SHARED_room_clear, RelicChestOpen (rương Relic/thưởng phòng mở) SFX_SHARED_relic_chest, HeroRevive (Lửa Gửi hồi sinh + sóng đẩy r120) SFX_SHARED_revive_ember, SFX_HUB_* (§6). Không âm UI nào > 300 ms trừ unlock/mastery_rank/achievement/card_pick_legend (≤ 2.0 s).

• Nguồn VI → EN trục → 8 ngôn ngữ (43 §12.2). Giới hạn đo bằng UI px ở cỡ 125% (bề rộng thật), không bằng ký tự; cột "≈ ký tự" chỉ để người viết ước lượng (VI/EN, bước TB FNT_BW_M 6 px, FNT_BW_S 4 px). Mọi chuỗi phải vừa ở 140% độ dài EN (DE/RU/PT-BR); CI chạy pseudo-loc (+40% + dấu chồng) chụp mọi màn, lỗi khi tràn hộp.
• Cấm cắt "…" trên chữ gameplay; chỉ tên người chơi (bảng xếp hạng) được cắt. Tràn → rút gọn bản dịch, không thu font.
• Chuỗi UI không thuộc file dữ liệu: Assets/_Project/Localization/ui_strings.csv khoá ui.<screen>.<slug>; chuỗi dữ liệu: khoá <file>.<id>.<field> do build sinh (51 §3). Mọi {param} thuộc danh sách placeholder 51 §3.

• CJK: hộp như trên; tính theo trường hợp chật nhất (Deck: ô 8 UI px, dòng 10 UI px) → giới hạn ký tự CJK = ⌊rộng / 8⌋ × ⌊cao / 10⌋ (vd hiệu ứng thẻ 112 × 62 → 14 × 6 = 84 ký tự).

Mọi tuỳ chọn đọc qua 1 dịch vụ AccessibilitySettings phát sự kiện AccessibilityChanged(key); mọi prefab UI lắng nghe và dựng lại trong ≤ 1 frame; không màn nào đọc PlayerPrefs trực tiếp.

10.1 Lần chạy đầu (khớp 18 §12)

PhotoWarning (4 s, bỏ qua sau 1.5 s) → Language → Consent (2 câu hỏi) → QuickSetup (6 dòng, bỏ qua được) → Title ("Chơi" duy nhất nổi bật) → cảnh mở 20 s (bỏ qua sau 2 s) → ChoosePath (3 preset, mặc định Hành Trình; 19 §5.6) → Loading → Lửa Canh ST_HEARTH (Ulla, H01 khoá sẵn SK01 + SK03, UL1, AS1, không menu) → đi bộ tới Bến Đò ST_DOCK (chỉ 2 trạm sáng; nhắc INTERACT) → DockDepart chỉ có Hành Trình → run 1. Không popup chữ dài; mọi hướng dẫn = beat NPC (≤ 3 câu) + 1 dòng HINT.

10.2 Gợi ý trong run (HINT, 1 dòng, glyph nút theo thiết bị)

Luật: mỗi gợi ý hiện tối đa 2 lần/tài khoản (đếm ở settings_shared.json), chỉ trong 3 run đầu đời (trừ dòng ghi khác); tự tắt khi người chơi làm đúng hành động hoặc sau 6 s; không hiện khi boss đang windup P hoặc trong 60 s đầu Hồi I nếu đã hiện 3 gợi ý trong phòng đó; Cài đặt "Gợi ý nút" TẮT → không hiện.

• Hub: run 1 → RunSummary tab Thưởng nhấn "Giữ 100% tiền meta khi chết"; về hub: beat Ulla (Phục Dựng), Grem (rèn H02), Hol (bia mộ) — tối đa 2 trạm mới/lần về hub; run 3: Răm mời bài ĐÁP 1 ở Sân Tập. "Thức Lại" ẩn run 1–2.
• Không có màn hướng dẫn riêng/không phòng tập bắt buộc; Sân Tập là tuỳ chọn (0 thưởng).

ui_screen {screen, from, dwell_s} · ui_draft {options[], picked, rerolls, banish, lock, skip, time_s, auto_pick} · ui_setting {key, value} · ui_hint {hint, shown, done_s} · ui_ash_inspect {hold_s}. Dùng để kiểm P5 (đọc thẻ < 3 s: trung vị time_s ≤ 3.0 ở draft thứ 10+) và KPI Tro Nhớ (≥ 60% người chơi mở AshInspect ≥ 1 lần trong 5 run).

• HUD và mọi màn dựng trong SAFE 427×267 UI px; 1 bản số cho 1080p và Deck; không neo phần tử tương tác ra mép canvas. Chỉ zoom nguyên, chỉ font FNT_BW_* / CJK đã duyệt, không scale lẻ chữ/khung.
• Màu chỉ từ token §1.3; thêm màu = thêm token (lý do + màn) và kiểm hue/S ngoài dải tell (INV-01a). Không bao giờ vàng #ffd84a/tím #b14cff hay màu cùng dải trên UI, trừ ngoại lệ H9 (biểu diễn chính tell).
• Không phần tử HUD nào trong vùng cấm 160×100 giữa SAFE; mọi khối HUD áp luật nhường H1; số sát thương theo 10 §6.5 nguyên văn.
• Chữ thẻ/tooltip = mẫu câu từ params (không viết tay số); giới hạn §8 đo ở 125%; CI pseudo-loc trên mọi màn.
• Mọi màn: điều hướng tường minh, focus đầu như spec, khoá xác nhận 0.30 s cho màn mở do sự kiện, nhắc nút đúng bộ glyph thiết bị cuối, chạy 100% bằng tay cầm.
• Hành động phá huỷ/không hoàn → UI_C_Hold 1.0 s (ngoại lệ: "Xoá toàn bộ tiến trình" 2.0 s × 2 lần, 43 §7.3); mua meta giá lớn → 0.5 s; focus mặc định của popup = lựa an toàn; màn đồng ý (Consent khối 1) không có lựa chọn sẵn, 2 nút ngang nhau.
• Mọi option trong Settings lấy khoá/giá trị/mặc định từ 42 (§6.3 chỉ xếp chỗ); thêm option = thêm vào 42 trước.
• Credits sinh từ credits.json lúc build (§5.7.1); thêm âm CC BY hoặc thư viện có giấy phép = thêm nguồn credit, CI credits_check chặn thiếu.
• Hiện/ẩn màn qua UIManager (không SetActive tay); async bằng UniTask; tween DOTween SetUpdate(true) (đồng hồ Real) và Kill khi đóng (rule third-party).
• Id âm/FX chỉ từ UI.json (SFX_UI_*, VFX_UI_*) + SHARED/HUB đã liệt kê; nhạc chỉ cue doc 32 §3.7.
• Tên hiển thị theo Bible §11 (Khăn Tang, Độ Tang, Dạng Rèn, Dư Âm, Then Chốt…); không hiện id loại; không tên game/studio/thương hiệu có thật trong chuỗi UI.
• Sửa doc này khi đổi số UI → đồng bộ hub ArtStyle §8 (token, kit, chữ, motion) cùng lượt + chạy art-style.py lint --changed.