42 — Trợ năng & Tuỳ chọn (mọi option, khoảng, mặc định, hệ chạm tới)

Mục đích: danh mục ĐẦY ĐỦ mọi tuỳ chọn người chơi của Bladewake 1.0 (hình ảnh, mù màu, nhạy sáng, âm thanh, chữ/phụ đề tiếng Việt, vận động, nhận thức, hỗ trợ độ khó Thương Xót) với khoá cài đặt, khoảng, mặc định PC/Deck, hệ thống bị chạm, có khoá leaderboard hay không; luật giữ phân biệt tell vàng/tím khi mù màu; giới hạn chớp; preset nhanh; cách xem trước ở Sân Tập; ca kiểm thử. Phụ thuộc: 00-Design-Bible.md §4.3 + INV-01/02/09/11/13/16 + data/_bible.json (meta.mercy, meta.accessibility); 10-Combat-Core.md §6.2, §6.5, §9; 11-Defense-Tells.md §1, §4.1, §4.2; 19-Difficulty-Modes.md §6; 30-Art-Direction.md §2.2; 31-VFX-Bible.md §1 (R1–R11); 32-Audio-Bible.md §2.1, §5.1–§5.2, §5.8, §9; 40-UI-UX-HUD.md §1.1–§1.2, §6.3, §7.1, §8, §9; 41-Controls-Camera.md; 43-Steam-Platform.md §7.1, §8.2; 01-Roadmap.md §5.1. Được dùng bởi: code AccessibilitySettings / SettingsService (phát AccessibilityChanged(key)), PaletteLut, FxRuntime, ShakeService, AudioMixer (BW_Main), SubtitleService, RebindService, Defense/Aim/Time (Thương Xót); màn Settings (40 §6.3), màn lần đầu; Sân Tập Sân Tập ST_YARD; QA (ma trận trợ năng, Deck Verified); loc.

• Canon: Bible + _bible.json > doc nền (10–17, 20, 30–32, 51) > doc này. Doc này không đổi số gameplay; mọi option là trình bày (không khoá gì) trừ nhóm Thương Xót §9 (gắn cờ run mercy_used: không nộp leaderboard, không mở thành tựu Độ Tang — Bible §4.3; không khoá gì khác — 19 §6.1). Không gắn cờ dù chạm gameplay: Hiệu chỉnh trễ mercy.latency_offset (§9, DEC-2026-11-07-16) và Trí nhớ xuyên run game.cross_run_memory (§8, 14 Q14).
• Trợ năng KHÔNG được: đổi hex tell #ffd84a/#b14cff/#e8e4f0 ở world (INV-01a), giảm windup/cửa sổ, tắt tell, tắt mũi tên công bằng bắt buộc (11 §5.3, 15 F9). Chỉ được THÊM hình, âm, chữ, độ tương phản, hoặc BỚT hiệu ứng trang trí.
• Mọi option áp ngay (≤ 1 frame, 40 §9), không khởi động lại; trừ độ phân giải/cửa sổ (popup "Giữ thiết lập này?" 10 s, 40 §6.3).
• Lưu: nhóm theo người → save/settings_shared.json (Steam Cloud); nhóm theo máy (độ phân giải, preset FX, trần fps, vsync, thiết bị âm, Vùng an toàn màn) → local/settings_device.json (43 §7.1). Cột "Lưu" dưới: S = shared, D = device.
• Khoá cài đặt: <nhóm>.<tên> (vd a11y.flash_reduce); là khoá code, không phải id dữ liệu. Mặc định Deck áp khi IsSteamRunningOnSteamDeck() ở lần chạy đầu và khi chưa từng chỉnh tay.
• Cột "Hệ chạm" = service/hệ đọc option; mọi đọc qua AccessibilitySettings/SettingsService, không màn nào đọc PlayerPrefs (40 §9).

1.1 Tab (= 40 §6.3) và vị trí option

1.2 Lần chạy đầu (40 §3.2: PhotoWarning → Language → Consent → QuickSetup → Title)

1. Cảnh báo nhạy sáng (trước Language, 4 s, bỏ qua bằng A/Enter sau 1.5 s): chữ VI/EN "Trò chơi có chớp sáng và chuyển động nhanh. Có thể giảm ở Trợ năng." + nút "Mở Trợ năng ngay" (§4).
2. Language → Consent (43 §15.1).
3. Thiết lập nhanh (1 màn, mọi mục bỏ qua được, chỉnh lại sau): Cỡ chữ (100/125/150%, xem trước câu tiếng Việt nhiều dấu "Ừ, đã hiểu rõ: ổn định, vững vàng.") · Tell mù màu (tắt/bật + ảnh trước/sau) · Phụ đề tell (tắt/bật) · Rung màn (100/50/0%) · Giảm chớp (tắt/bật) · Preset điều khiển (41 §8.2: Mặc định / Không chuột / 1 tay trái / 1 tay phải / Bàn phím 1 tay).
4. Màn "Chọn cách đi" (preset Thương Xót 19 §6.2) chỉ hiện khi bắt đầu run đầu tiên, sau thiết lập nhanh.

• "Giảm chuyển động" KHÔNG đổi tốc game, slow-mo hay hitstop (là gameplay, 10 §6); muốn chậm game → Thương Xót "Tốc game".

3.1 Option

• Luật cứng: không có bộ lọc màu toàn màn (daltonize) — bộ lọc dời hue tell ra khỏi dải dành riêng 32–62° / 260–290° (INV-01a) và đổi màu slot hero. Mọi chế độ chỉ THÊM hình/mẫu/viền/độ sáng; hex tell world giữ nguyên.

3.2 Lớp hình (bật bởi tell_shapes; = 11 §4.2, 31 R11)

• Gạch chéo chỉ dành cho tím mù màu (Bible INV-02: N không dùng gạch chéo) → không lẫn.

3.3 Lớp bổ sung theo chế độ

3.4 Số đo (mô phỏng Machado 2009 mức 1.0 trên sRGB, ΔE2000; chạy lại khi đổi palette)

• Cổng: ΔE(Y, P) ≥ 25 dưới mọi mô phỏng (đạt, min 25.9) và Y/P/N phân biệt được khi xem ảnh xám ở 50% kích thước (bắt buộc hình ◇/▲/chấm vì Y–N đơn sắc 2.4). Test 5 s mỗi chế độ trên B2 và B4 với 250 quái (như INV-09).
• Phân biệt Y với P còn qua: hình (glint điểm vs vùng sàn), âm ("tinh" vs "ù"), thời gian (Y glint 2 đúng 7 tick trước va chạm; P vùng lớn dần) — không bao giờ chỉ bằng màu.

4.1 Luật (mọi chế độ; 31 R9 + 40 §7.1)

4.2 Danh mục chớp & bản "Giảm chớp" (a11y.flash_reduce, tắt/bật · tắt, S)

• Kiểm tự động (CI, quay video 60 fps): phân tích độ sáng từng frame theo luật §4.1 trên 6 cảnh (MS01b 250 quái + Ult, 4 boss pha chuyển, Phản liên tục 10 s) → 0 cửa sổ 1.0 s > 3 chớp, 0 chớp đỏ; chạy ở cả Thường và Giảm chớp. Trailer (43 §2.3) qua cùng kiểm trước khi đăng.

• Màn đo trễ (Cài đặt › Âm thanh): 8 lần gõ CONFIRM theo click 100 BPM, lấy trung vị lệch → đề xuất audio.latency_ms; cùng màn có bước hình (chớp ô 8×8 ngà) để đo trễ hiển thị → đề xuất "Hiệu chỉnh trễ" mercy.latency_offset (§9, không gắn cờ; người chơi tự chọn áp).
• Không có lời thoại đọc ở 1.0 (32 §9) → không có option giọng/ngôn ngữ thoại.

6.1 Cỡ chữ & đọc

6.2 Tiếng Việt (nguồn VI, 40 §1.1, §8)

• Font FNT_BW_S/M/L/XL/NUM vẽ tay, đủ 134 ký tự tiếng Việt dựng sẵn + Latin Extended-A; dấu chồng (ể, ặ, ỗ, Ữ) = 2 tầng trong vùng dấu 3–5 UI px, không đè dòng trên; chữ HOA giữ đủ dấu (TẠM DỪNG, LÊN CẤP) — cấm bỏ dấu để vừa hộp.
• Chuỗi luôn chuẩn hoá Unicode NFC (ký tự dựng sẵn); CI loc từ chối mọi chuỗi còn dấu kết hợp U+0300–U+0323 sau chuẩn hoá hoặc ký tự ngoài bảng font (thay "□" = lỗi build).
• Cao chữ trên màn (cap + vùng dấu): FNT_BW_S 8 UI px = 32 px @1080p / 24 px @Deck; FNT_BW_M 10 UI px = 40 / 30 px. Sàn Deck: chữ nhỏ nhất ≥ 12 px cap (43 §8.2) → 125% đạt (S → M ở caption).
• Ngắt dòng: chỉ tại dấu cách; không ngắt giữa số và đơn vị ("12 px", "0.5 s"), giữa glyph nút {btn:…} và chữ theo sau, và trong tên riêng ≤ 3 âm tiết ("Bà Ulla", "Lò Rèn Vọng", "Khăn Tang") → build loc chèn dấu cách không ngắt (U+00A0).
• Đo hộp bằng UI px ở 125% (40 §8); 150% cho phép cuộn (thanh 2 px); cấm "…" trên chữ gameplay.
• Số: dấu nghìn VI "1.234", thập phân VI "0,5" trong chữ hiển thị (doc dùng "0.5" cho số kỹ thuật); đơn vị giữ ký hiệu quốc tế (s, px, %).

6.3 Phụ đề & chú thích âm

• Vị trí: khối SUBS đáy SAFE (40 §4.1), ≤ 2 dòng thoại/bark + ≤ 3 dòng tell chồng; tell 1.2 s/dòng; bark/chú thích hiện max(1.5, 0.5 + số ký tự / 15) s, trần 6.0 s (vd bark 48 ký tự → 3.7 s) [ASSUMED] (tốc đọc VI ~15 ký tự/s).
• Hướng 8 chữ: trái · phải · trên · dưới · trái-trên · phải-trên · trái-dưới · phải-dưới; "sau lưng" = nguồn trong nón 90° ngược hướng ngắm. Phụ đề tell hiện đúng tick SFX tell (glint 2 cho Y, đầu windup cho P).
• Phụ đề không bao giờ che vòng chân hero: hero ở 32 art px dưới đáy view → khối SUBS dời lên trên hero.

7.1 Option

• Verb giữ kiểu bật (chạm 1 vào, chạm 2 ra) KHÔNG nằm ở đây: Bible §4.3 xếp vào Thương Xót (§9, gắn cờ).

7.2 Preset 1 tay (Bible §4.3 "chế độ 1 tay"; không hành động nào cần 2 nút cùng lúc — 12 §1.1)

Mọi preset 1 tay: aim_mode = AIM_MOVE (đổi lại được), input.move_latch 0.25 s, MAP = mục "Bản đồ" trong Pause.

• Chạm/giữ trên cùng 1 nút (View, Menu) = ngữ nghĩa theo thời lượng, không phải tổ hợp; POTION phát lúc nhả (trễ ≤ 0.25 s, chấp nhận cho preset).
• Kiểm: 1 run Hồi I trọn vẹn với mỗi preset (41 CT-14).

• Tạm dừng được MỌI lúc trong run (kể cả boss, DAILY; đồng hồ run dừng, 43 §8.3); tiếp tục đếm 0.3 s; tell đang chạy đóng băng, mờ 50%.
• Mọi bài hướng dẫn xem lại được ở Sân Tập (Sân Tập ST_YARD, menu Yard); codex ghi mọi cơ chế đã gặp (CDX_*).

Bất kỳ mục nào khác mặc định trong run → cờ run mercy_used (giữ tới hết run kể cả khi tắt lại): không nộp leaderboard (DAILY / Truy Tuần / ENDLESS / BOSS_RUSH), không mở thành tựu Độ Tang (mercy_blocked). KHÔNG giảm Tro Hồn/Mảnh Vọng/Nến Canh/Thông Thạo, không khoá kết, hero, codex, thành tựu truyện; dùng chung được với Khăn Tang (MRN01–MRN15). Bật giữa run → UI_C_Confirm (40 §5.6); HUD: icon nến tắt 8×8 ui-text-2 ở đầu phải khối MODE, ngay trên Độ Tang (40 §4.1).

• Không thuộc Thương Xót (không cờ): Hiệu chỉnh trễ mercy.latency_offset (bảng dưới, DEC-2026-11-07-16), platform.answer_window_bonus_s theo nền tảng (0 trên PC/Deck), mọi option §2–§8.
• Hiệu chỉnh trễ — hiệu chỉnh/trợ năng, KHÔNG phải Thương Xót (Bible §4.3 DEC-2026-11-07-16, 19 Q7): hiện ở tab Trợ năng (cạnh màn đo trễ §5) và chung menu Thương Xót; khoá giữ tiền tố mercy. chỉ vì vị trí menu (19 §6.1 trỏ tên này), không mang luật cờ:

• Preset "Chọn cách đi" (19 §6.2; chỉ là bộ điền §9):

• Chỉnh tay bất kỳ ô nào → hiện "Tự chỉnh". Ví dụ: H01 Gạt gốc 0.16 s + Kể Chuyện +0.06 = 0.22 s = ceil(0.22 × 60 − 0.001) = 14 tick (≤ kẹp 15) ✓; H12 đúng phách 0.20 + 0.06 = 0.26 → kẹp 0.24 s (11 §3.1).

• Preset cộng dồn (bật preset sau không tắt option preset trước); "Mặc định" theo tab trả về bảng §2–§8.

• Mọi option §2–§8 có ảnh/clip minh hoạ 128×72 trong Settings (40 §6.3) + nút "Thử ở Sân Tập" (chỉ ở hub): Sân Tập ST_YARD mở dummy tell Y/P/N từng hạng, Thương Xót xem trước không gắn cờ (Sân Tập không phải run).

• Option mới = thêm 1 hàng vào bảng nhóm tương ứng (khoá, tên, giá trị · mặc định PC/Deck, hệ chạm, lưu S/D) + màn Settings 40 §6.3 + chuỗi loc cùng lượt.
• Option không bao giờ đổi hex tell world, windup, cửa sổ, token, mũi tên công bằng bắt buộc; đổi số gameplay = Thương Xót (cờ) hoặc DEC.
• Không bộ lọc màu toàn màn; mù màu chỉ thêm hình/mẫu/viền/độ sáng (§3).
• Mọi chớp mới phải khai báo vào §4.2 kèm bản Giảm chớp và qua kiểm tự động §4.2 trước merge.
• Chuỗi VI: NFC, đủ dấu, đo hộp ở 125%, không "…" trên chữ gameplay, dấu cách không ngắt trong tên riêng ≤ 3 âm tiết.
• Đọc option qua AccessibilitySettings/SettingsService + sự kiện AccessibilityChanged(key); cấm PlayerPrefs trực tiếp.