41 — Điều khiển & Camera (bindings, ngắm, buffer, remap, glyph, camera pixel)

Mục đích: đặc tả TOÀN BỘ input và camera của Bladewake bản 1.0 (PC Steam, tay cầm trước, bàn phím/chuột đủ, Steam Deck): action map theo ngữ cảnh, bảng nút đầy đủ cho 4 thiết bị (tay cầm ABXY · tay cầm ký hiệu hình · Steam Deck · bàn phím + chuột) ở combat/menu/bản đồ/hub, override theo hero, chế độ ngắm + trợ ngắm, buffer + chạm/giữ theo tick, luật remap + preset, glyph + Steam Input, camera (bám, nhìn trước, khung boss, giới hạn, rung, pixel-perfect, hồ sơ theo nút bản đồ/boss), rung tay cầm, ghi chú chạm cho bản mobile sau. Phụ thuộc: 00-Design-Bible.md §1.1 (bản đồ nút khoá), INV-06/07/09/11/12, §4.3, §10.4 (camera pixel) + data/_bible.json (input_map, meta.mercy, meta.accessibility); 10-Combat-Core.md §1.1–§1.6, §6.1–§6.3, §9; 11-Defense-Tells.md §2.1, §3, §4; 12-Hero-Framework.md §1.1–§1.5, §3.2–§3.5, §11; 30-Art-Direction.md §2.1–§2.2; 40-UI-UX-HUD.md §0.1, §1.5, §3.1, §5.2–§5.6, §6.2–§6.3; 43-Steam-Platform.md §7.1, §8, §10; 01-Roadmap.md §3.12, §5.1–§5.2; data/tuning.json (combat.*, platform.*, run.death_cam_s); GDD demo GDD/01-Camera-Controls.md (lịch sử). Được dùng bởi: code Input (InputActions, InputFrame, InputBuffer, RebindService, InputGlyphs, DeviceTracker), Presentation (PixelCamera, CameraDirector, ShakeService, Haptics), AimService; doc 42 (Trợ năng); doc UI 40 (màn remap, thanh nhắc nút); QA (checklist input/Deck); agent sinh tuning.json section platform/camera; cổng port console/mobile.

• Canon: Bible + _bible.json > doc nền (10–17, 20, 30–32, 51) > doc này. Doc này không đổi bản đồ nút Bible §1.1, cửa sổ ĐÁP, buffer 0.15 s, thứ tự ưu tiên INV-07, luật trợ ngắm 10 §9; chỉ trình bày đầy đủ, điền chỗ trống (nút phụ, menu, hub, camera chi tiết) và chốt số [ASSUMED] mới.
• Tên nút trong doc: tay cầm bố cục chữ = A/B/X/Y, LB/RB (vai), LT/RT (cò), LS/RS (cần), L3/R3 (bấm cần), View/Menu (2 nút giữa), d-pad. Bố cục ký hiệu hình = ✕/○/□/△, L1/R1, L2/R2, L3/R3, nút giữa trái/phải, bấm bàn cảm ứng. Steam Deck = A/B/X/Y, L1/R1, L2/R2, View/≡, L4/L5/R4/R5 (nút lưng), trackpad trái/phải. Không viết tên hãng/sản phẩm tay cầm.
• Đơn vị: tick = 1/60 s (10 §1.1); px sàn = px gameplay trên mặt sàn; art px = px màn trước phóng (480×270 ở 1080p); UI px = 40 §0.1.
• [ASSUMED] = số lượt đầu, chỉnh trong tuning.json (section platform cho số theo nền tảng; khoá cam_*/input_* mới ghi ở §13), không cần DEC nếu không chạm INV.
• Mọi đọc thiết bị nằm trong thư mục Input/ (CI grep Keyboard.current, Gamepad.current, Mouse.current, Touchscreen.current ngoài thư mục → lỗi; Roadmap §5.2). Gameplay chỉ đọc InputFrame.

• Luôn bật đúng 1 map + map nền System (chỉ PAUSE và phát hiện thiết bị). Mở màn Screens → tắt Gameplay trong cùng frame; mọi nút đang giữ được xả (coi như nhả, không bắn sự kiện thả) → ATTACK đang giữ không ra đòn nạp khi đóng màn.
• Đóng màn về Gameplay: nút còn đang giữ bị bỏ qua tới khi nhả (chống A xác nhận thẻ biến thành Lướt; chống X giữ Xoá thành nạp).
• Map chỉ đổi qua InputContextService.Push/Pop; ngăn xếp ≤ 4 (vd Gameplay → Pause → Settings → Confirm).

Canon Bible §1.1 + 12 §1.1. Cột KB/M "phụ" = ô thứ 2 mặc định (dùng cho người không có chuột, preset KBM_KEYS §8.2).

• d-pad ←/→ trong combat: không gán (để trống cho preset 1 tay 42 §7.2 và tránh bấm nhầm). Bấm cần trái L3: không gán.
• Cò (LT/RT, L2/R2) đọc như nút số: nhấn ở 0.35, nhả ở 0.25 (trễ chống rung tay) [ASSUMED]; không dùng độ sâu cò cho gameplay.
• Bàn phím: không dùng Shift+Tab, Ctrl+Alt, F12 (overlay/ảnh chụp Steam, 43 §10). Mọi gán mặc định là 1 phím, không tổ hợp.
• Chuột: nút bên M4 = DASH phụ, M5 = ANSWER_HOLD phụ khi có (gán sẵn trong ô thứ 3 ẩn chỉ cho nút chuột, không tranh 2 ô người chơi) [ASSUMED].

3.1 Điều hướng chung (mọi màn Screens)

• Thanh nhắc nút UI_C_PromptBar (40 §3.1): ≤ 5 cặp glyph + nhãn ≤ 12 ký tự; nhãn dùng token {btn:ACTION_ID} (§8.1).
• Con trỏ chuột chỉ hiện khi thiết bị cuối = KBM; ẩn sau 3 s không rê (focus giữ nguyên). Tay cầm: không có con trỏ ảo; trackpad phải Deck = chuột chỉ trong menu (43 §8.1).
• Khoá xác nhận 0.30 s đầu ở màn mở do sự kiện (draft, thưởng, cổng boss, chết, recap): CONFIRM bị nuốt, NAV vẫn nhận (40 §3.1).
• Lệnh nguy hiểm (Bỏ run, Xoá dữ liệu, Xoá Sổ Thù, Xoá thẻ draft, Bỏ qua draft) = UI_C_Hold (giữ, vòng tiến trình; thời lượng × "Thời gian giữ" 42 §7) hoặc hộp xác nhận 2 bước theo confirm_style (42 §7). Không lệnh nguy hiểm nào nằm trên CONFIRM chạm đơn.

3.2 Draft (13 §2–§4, 40 §5.3; World ×0.15 + hero bất tử ở phòng thường)

• Đồng hồ tự chọn 6.0 s (chỉ draft phòng thường); mọi input điều hướng đặt lại 6.0 s (draft.auto_pick_reset_on_input); tạm dừng dừng đồng hồ. Tuỳ chọn kéo dài/tắt ở 42 §8.
• Xoá Edge là nửa công thức Tiến Hoá → UI_C_Confirm, focus mặc định Huỷ (40 §5.3).

3.3 Bản đồ (Map, 16 §2.1, 40 §5.2)

• Mở MAP giữa phòng chưa sạch = dừng World + Hero như PAUSE (không ai trúng đòn vì đọc bản đồ); tiếp tục → đếm 0.3 s như 43 §10. Bản đồ là lớp UI, camera world đứng yên phía sau (§11.4).

3.4 Màn khác trong run

• Xuất phát: tương tác ST_DOCK (Calla NPC_CALLA) → DockDepart (map UI).
• ST_YARD (Sân Tập): bật Gameplay đầy đủ (hitbox thật trên dummy) + menu nổi Yard (World chạy, 40 §6.11) mở bằng INTERACT (B hoặc X · KB/M G hoặc LMB) khi đứng tại NPC Răm; trong menu: đổi dummy tell Y/P/N × hạng S/M/L/XL, replay 10 s, bảng frame data, mọi tuỳ chọn 42 xem trước sống. Trong Sân Tập, khi menu Yard đang đóng, Menu/Esc vẫn là lệnh "Tạm dừng / Cài đặt" của hub (hàng Menu bảng trên) như mọi chỗ khác trong hub — Menu không mở menu Yard. Khi menu Yard đang mở, B/Esc đóng nó → về map Gameplay.
• Mọi menu trạm mở UI chồng lên Hub; B/Esc đóng → hero đứng đúng chỗ cũ, camera giữ (§11.4).

W = ngưỡng giữ của ANSWER_HOLD = ceil(cửa sổ ĐÁP × 60) tick (chưa cộng Thương Xót/Edge/Relic/nền tảng). Remap của người chơi theo action_id, áp chung mọi hero.

• Kỹ năng cast_mode = HOLD (nạp/ngắm): giữ nút ô → reticle hình hitbox thật, thả = tung; Lướt/ĐÁP huỷ không mất thời gian hồi chiêu (12 §1.2). Tuỳ chọn input.skill_hold_mode = Chạm-chạm (42 §7.1): chạm 1 = bắt đầu ngắm, chạm 2 = tung, ngắm tối đa 3.0 s rồi tự tung.
• H12: máy nhịp chỉ hiển thị (Bible §1.1); audio.latency_ms (42 §5) chỉ dời hình/âm hiển thị nhịp, không dời mốc chấm phách — dời mốc chấm = "Hiệu chỉnh trễ" của Thương Xót (11 §4.1).

6.1 Chế độ ngắm (aim_mode, 12 §1.3)

• Vectơ ngắm 360° liên tục; sprite chọn 1/8 hướng. Cận chiến khoá hướng ở tick đầu startup; tầm xa khoá ở tick nhả, xoay ≤ 720°/s khi nạp (10 §1.6).
• Con trỏ chuột trong Gameplay: dấu ngắm 7×7 art px màu #e8e4f0 viền 1 px #15131d (không vàng/tím, INV-01a), vẽ lớp screen trên HUD; cỡ 1×/2×/3× (42 §2).

6.2 Trợ ngắm (10 §9 + PlatformTuning 01 §5.1)

• Trợ ngắm chỉ đổi hướng (và quãng lao), không đổi hitbox/sát thương; không bao giờ kéo vị trí hero.
• Khoá boss mềm: L/XL trong vùng an toàn luôn là ứng viên nếu lệch ≤ 30° so với hướng nhập, tầm ×1.5. Khoá boss cứng (BOSS_LOCK, tắt mặc định): khi khoá và không có input ngắm, hướng = boss; vòng khoá 1 px #e8e4f0 quanh vòng chân boss.
• Ví dụ (H01, tay cầm): ngắm 0°; quái M đang windup ở 30°/70 px, quái S ở 5°/40 px → cả hai trong nón ±50°/90 px; M thắng ưu tiên → hướng đòn 30° (≤ 35°). M ở 70 px > 60 → không lao thêm. Nếu M ở 45° → hướng = 35° (kẹp), cung A1 r44 vẫn chạm M nếu nằm trong cung.
• Ví dụ (H07, chuột): ngắm 0°; Tinh Anh L ở 4°/200 px → hướng 4° (≤ 6°); quái S ở 3° → không hút (chuột chỉ M/L/XL).

6.3 Đặt vật & reticle

• place_point (12 §1.3): tay cầm place_dist = place_min + (place_max − place_min) × |RS|, |RS| < 0.30 → place_default; chuột = điểm chuột kẹp place_max, ngoài vùng an toàn → mép vùng an toàn − 16 px; AIM_MOVE → place_default theo hướng đi.
• Reticle sàn màu slot hero α 0.40, hình = hitbox thật (LINE/ARC/CIRCLE), chỉ khi đang nạp/ngắm hoặc aim_reticle = ALWAYS; vẽ DƯỚI lớp tell, không bao giờ đè tell (Bible INV-02, 31 R2).
• Ví dụ H10 tay cầm: |RS| = 0.5 → 32 + (160 − 32) × 0.5 = 96 px; |RS| = 0.2 → 72 px (place_default).

Ví dụ thời gian (tick):

1. H01 đang hồi sau A2, cửa huỷ cho Lướt (ma trận 12 §3.2) mở ở t105. Bấm DASH ở t100 → Lướt chạy ở t105 (trong 9 tick).
2. Bấm ATTACK t100, DASH t102; cửa huỷ t105 → chạy Lướt (ưu tiên), ATTACK bị xoá.
3. Bấm DASH t90, cửa huỷ t105 → t90 + 9 = t99 < t105 → hết hạn, không Lướt (người chơi phải bấm lại).
4. H01 bị trúng ở t99 → 7 tick đầu Hurt khoá ĐÁP (t99–t105, 11 §2.1). Chạm RB t100 (thả t103) → ĐÁP chạy t106, W = 10 tick → cửa sổ t106–t115.
5. Giữ RB từ t100 lúc rảnh (H02, W = 11): ĐÁP chạy t100, còn giữ ở t111 → Dựng Quan bắt đầu t111.

8.1 Luật remap (Bible §1.1 "remap toàn bộ")

• Prompt trong chuỗi loc dùng token {btn:ACTION_ID} (vd "Nhấn {btn:INTERACT} để mở", "Giữ {btn:ANSWER_HOLD} để Thủ"); runtime thay bằng glyph binding hiện tại của thiết bị cuối. Cấm viết tên nút cứng trong chuỗi loc.

8.2 Preset (input_preset)

• Chọn preset ở màn khởi động lần đầu (42 §1.2) và Cài đặt › Điều khiển; preset 1 tay tự bật aim_mode = AIM_MOVE (đổi lại được).

8.3 Một lớp input (01 §5.2)

• 1 asset InputActions (map Gameplay · UI · Hub) → dựng InputFrame mỗi tick; Autopilot, replay ST_YARD và test chỉ ghi/đọc InputFrame.
• CI cấm đọc thiết bị trực tiếp ngoài thư mục Input (grep Keyboard.current, Gamepad.current, Mouse.current, Touchscreen.current).
• InputFrame = {move vec2, aim vec2 (đã qua aim_mode), bitmask nhấn/giữ/nhả 16 action, device_class, tick}; trợ ngắm chạy SAU InputFrame trong Combat, không trong lớp input.

8.4 Steam Input (1.0)

• Trần: mỗi mô tơ = min(1.0, Σ mẫu đang chạy); ≤ 3 mẫu cùng lúc; vượt → bỏ mẫu ưu tiên thấp nhất. Ưu tiên: tell > ĐÁP/Né > Vỡ Thế > trúng đòn > còn lại. Quái chết/trúng đòn của hero: không rung (bầy 250 quái = rung liên tục vô nghĩa).
• input.haptic_strength 0–100% nhân mọi mẫu (42 §7.1); PC_KBM = 0 (platform.haptics). Tạm dừng/mất focus → dừng mọi rung trong 1 frame.

11.1 Độ phân giải, zoom, vùng an toàn (khoá: Bible §10.4, 30 §2.2)

zoom = số nguyên lớn nhất z thoả H/z ≥ 266 và W/z ≥ 426 · view = (min(640, ceil(W/z)), min(360, ceil(H/z))) art px · phần thừa = viền void #15131d. Không bao giờ zoom lẻ.

• Vùng an toàn gameplay = 427×267 art px giữa view: spawn công bằng (INV-14), quái chỉ windup Y/P nhắm hero khi trong vùng này + 16 px (11 §5.3), HUD neo theo vùng này, bất kể view thật rộng hơn.
• Camera chiến đấu: không zoom, không xoay (30 §2.2). Zoom chỉ đổi khi đổi độ phân giải/cửa sổ (tính lại ngay, không chuyển mượt).

11.2 Bám theo (PixelCamera + CameraDirector, 50 §2; mọi ngữ cảnh có world)

• Ví dụ: H01 chạy phải đều 135 px/s → la = 135 × 0.22 = 29.7 → 30 art px. Chạy lên Bắc 135 px sàn/s = 67.5 px màn/s → 67.5 × 0.22 × 0.6 = 8.9 → 9 art px.
• a11y.reduce_motion (42 §2): nhìn trước = 0, giảm chấn T = 0.80 / 0.85 s, vùng chết 10% × 12%.

11.3 Giới hạn sân

• View không vượt viền phòng + 40 art px lề (ngoài viền = void/tile rìa). Phòng có cạnh ≤ view + 80 art px theo 1 trục → khoá trục đó ở tâm phòng (sân boss nhỏ đứng yên, không trượt lắc).
• Vùng P/tell cắt mép view: phần trong vùng an toàn phải chứa mọi điểm hero có thể đứng trong 0.45 s tới (11 §5.3) — camera không được tự kéo để "cứu" tell; luật là của bộ đạo diễn/quái.

11.4 Khung theo trận / boss (zoom = §11.1 ở MỌI ngữ cảnh; chỉ khác đích & lệch)

• Hero luôn thắng bias: nếu target + bias đẩy hero ra ngoài giới hạn cứng §11.2 → bias rút ngắn tới khi hero vào lại.
• Ví dụ boss: hero (0, 0), BS_B1 ở (+200, −80) art px màn → 0.25 × (200, −80) = (50, −20) → trong kẹp ±64 / ±32 → tâm camera lệch (50, −20 + 5) về phía boss.
• Bản đồ (MAP), tổng kết, Sổ Tang, menu: lớp UI riêng, camera world đứng yên phía sau (mờ 50% + tối 40%).

11.5 Rung màn (trauma; số canon 10 §6.2, tuning.combat.shake_*)

• Ví dụ: Phản (0.45) + Vỡ Thế cùng tick (0.50) → trauma 0.95 → nhiễu 7 × 0.95^1.5 = 6.48 → 6 art px; sau 0.2 s còn 0.95 − 0.44 = 0.51 → 2.6 → 3 px.
• Ult: chỉ "đá" camera (cú đẩy ≤ 4 px), không zoom/đẩy khung (30 §2.2 thắng demo "punch 1 px/khung").

11.6 Pixel-perfect (khoá 30 §2.1–§2.2, 50 §4.3)

• Render world vào RT view (§11.1), filter Point, phóng nguyên ×zoom; PixelPerfectCamera assetsPPU 16, orthographicSize = viewH / 32, upscaleRT bật.
• Vị trí camera làm tròn tới 1 art px (1/16 unit) mỗi frame sau mọi cộng dồn (bám + nhìn trước + bias + rung). Sprite/FX snap 1 art px trong shader; hero vẽ tại vị trí sim làm tròn cùng quy tắc → hero không rung lệch 1 px so với camera khi camera đuổi (chênh lệch hero–camera tính trên số nguyên).
• Toạ độ sàn → màn: screenX = x − camX · screenY = (z − camZ) × 0.5 + y (50 §4.3, tilt 0.5). Chuột → sàn (h = 0): x = mouseArtX + camX, z = (mouseArtY − camSY) × 2 + camZ với mouseArt = mousePx / zoom − viền.
• Cấm: zoom lẻ, xoay camera, sub-pixel camera, blur/bloom toàn màn làm mềm pixel, chuyển mượt zoom khi đổi độ phân giải.
• UI (HUD/Screens) canvas riêng (40 §0.2), không chịu rung màn.

11.7 Đồng hồ & thứ tự cập nhật (10 §1.1, 50 §2.3)

• Thứ tự mỗi frame: InputFrame → Sim (tick) → CameraDirector.Update(Real dt) → snap → Presentation.Sync() (50 §2.3).

11.8 Mũi tên & khung ngoài màn

• Camera không bao giờ tự lia để "cứu" tell. Thông tin ngoài view do UI vẽ: mũi tên báo beat ngoài khung ngà 0.8 s trước khi quái vào khung (15 §4 F9, luôn bật) · mũi tên đòn boss khởi phát ngoài màn ≥ 0.45 s (11 §5.3, luôn bật) · mũi tên mọi tell Y/P ngoài màn (Trợ năng "Mũi tên ngoài màn", 42 §2).
• 21:9 / 1280×720: view rộng hơn 427×267 → thấy thêm, nhưng spawn/tell/token luôn tính theo vùng an toàn 427×267 (không lợi thế cạnh tranh trên bảng DAILY).

• Lệch demo: GDD demo 01 §3.3 cho "Tự đánh" mặc định bật trên mobile → bỏ theo Roadmap §3.12 (canon cao hơn GDD demo).
• Tay cầm Bluetooth trên mobile: dùng nguyên bảng §2 (01 §3.12 "tay cầm không dây hỗ trợ đầy đủ").

• Khoá mới thuộc section platform (đọc theo cột nền tảng, 01 §5.1); cột ngoài DEFAULT/PC/DECK = [ASSUMED] tới cổng port.

• Gameplay chỉ đọc InputFrame; không đọc thiết bị ngoài thư mục Input/ (CI grep). Hero không thêm nút, không đổi ngữ nghĩa chạm/giữ ANSWER_HOLD, không đổi hướng Lướt, không đổi thứ tự INV-07 (12 §1.1).
• Override hero chỉ qua field input_override 12 §1.4; remap người chơi theo action_id, chung mọi hero.
• Mọi chuỗi có nút dùng token {btn:ACTION_ID}; cấm tên nút cứng trong loc; cấm tên hãng tay cầm trong chuỗi và glyph.
• Camera: zoom nguyên theo độ phân giải, không zoom/xoay trong combat, snap 1 art px sau mọi cộng dồn, đồng hồ Real; không lia camera để cứu tell; mọi số camera mới vào tuning.json section platform (§13), không hard-code.
• Luật công bằng (spawn, windup, token, mũi tên) luôn tính theo vùng an toàn 427×267, không theo view thật.
• Glyph, reticle, con trỏ, vòng khoá boss: không dùng #ffd84a/#b14cff hay dải hue tell (INV-01a); vẽ dưới lớp tell.
• Thêm action mới = sửa Bible §1.1 (DEC) + 12 §1.1 + bảng §2–§4 doc này + màn remap 40 §6.3 cùng lượt.
• Bản mobile chỉ khác qua PlatformTuning + layout §12; không tự đánh, không đổi ngữ pháp nút.