43 — Steam & nền tảng (Steamworks, Deck, trang cửa hàng, vận hành)

Mục đích: đặc tả mọi thứ Bladewake cần trên Steam: trang cửa hàng (capsule, trailer, tag, mô tả VI/EN), demo + checklist Next Fest, trang Early Access, chính sách thành tựu, stats & leaderboard (DAILY / Truy Tuần / ENDLESS / BOSS_RUSH), Steam Cloud (file, luật xung đột), Steam Input & Steam Deck (checklist Verified), rich presence, overlay/tạm dừng, build & nhánh, kế hoạch bản địa hoá, chính sách không DRM, rủi ro hoàn tiền/đánh giá, telemetry + báo crash có đồng ý, quyết định mod/Workshop. Phụ thuộc: 00-Design-Bible.md §1 (USP, khoảnh khắc đinh), §1.1 (bản đồ nút), §4 + §4.1 (Khăn Tang, mode, điểm DAILY, chống gian lận), §4.3 (Thương Xót), §10 (mốc, ngôn ngữ, Deck, giá), §10.3 (60 thành tựu), §10.4 (hiệu năng, camera), §13 + data/_bible.json (milestones, modes, meta.accessibility, adaptive.legal_gate, endings); 01-Roadmap.md §1.2, §3.2, §3.5, §3.6, §3.10, §4, §5; 14-Adaptive-AI.md §9.1 (ash_profile), §15; 16-Run-Structure-Map.md §11 (lưu/tạm dừng); 30-Art-Direction.md §7 (key art, capsule); 32-Audio-Bible.md §3.7 (cue nhạc); 51-Data-Schema.md §4.28 (achievements.json). Được dùng bởi: producer (trang Steam, Next Fest, EA, phát hành), code PlatformServices/SteamBridge/SaveService/CloudGuard/LeaderboardClient/RichPresence/Telemetry/CrashReporter, máy chủ kiểm hợp lý điểm, agent sinh data/achievements.json, doc UI (màn đồng ý, màn kết demo, bảng xếp hạng), QA (checklist Deck, checklist phát hành), loc.

• Canon: Bible + _bible.json > doc nền (10–17, 20, 30–32, 51) > 01-Roadmap.md > doc này. Số [ASSUMED] = lượt đầu, chốt bằng số đo ở mốc tương ứng (ghi lại vào doc này, thay nhãn).
• Doc này không tạo ID gameplay mới. ID nền tảng định nghĩa ở đây (tên stat Steam STAT_*, tên leaderboard, token rich presence #*, tên nhánh, tên depot, file lưu save/meta_<steamId>.json, save/settings_shared.json) là định danh hạ tầng, không phải thực thể gameplay; bất biến sau khi ship giống luật ID Bible §11.
• Tên thương hiệu: chỉ viết Steam, Steam Deck, Steamworks, Next Fest và tên tính năng/API có tiền tố Steam (Roadmap Q12). Phần cứng, hệ điều hành, nền tảng video, dịch vụ backend, cửa hàng khác → viết chung ("HĐH PC 64-bit", "nền tảng video dọc ngắn", "máy chủ cộng đồng", "dịch vụ báo crash").
• Luật Steamworks (kích thước ảnh, hạn nộp, luật giá) đổi theo thời gian → mọi số mang nhãn [STEAMWORKS] phải đối chiếu trang tài liệu Steamworks hiện hành khi làm việc đó; lệch → theo Steamworks, sửa doc này cùng lượt.

2.1 Capsule & ảnh (kích thước = 30-Art-Direction.md §7.2; vẽ gốc rồi phóng NEAREST số nguyên)

• Luật: capsule chỉ art + logo — không chữ quảng cáo, giải thưởng, điểm đánh giá, giá (luật Steam + doc 30). Vàng #ffd84a / tím #b14cff tell không có trong key art (dành gameplay). Logo "BLADEWAKE" 1 bản cho mọi ngôn ngữ (không capsule bản địa hoá).
• Bản 12 hero xếp vòng quanh chuông (doc 30 §7.1 "bản phụ") thay main capsule ở 1.0; trước đó dùng bản Varek.
• A/B capsule: M3 nếu dưới sàn wishlist (Roadmap §4.3) → làm 2 header khác hướng (A: Varek cận + Trăng Máu; B: biển thây toàn cảnh) dùng tính năng thử nghiệm capsule của Steamworks [STEAMWORKS], chạy ≥ 14 ngày, giữ bản có CTR trang cao hơn ≥ 10% tương đối.

2.2 Ảnh chụp — thứ tự 10 ảnh (EA)

Mỗi mốc U thay ảnh 8–10 bằng nội dung mới; ảnh 1–3 cố định tới 1.0.

2.3 Trailer (khoảnh khắc đinh Bible §1: Trăng Máu giữa 250 thây · Xà Ích Xe Tang nghiền bầy · đòn cuối vào Mũ Chuông BS_FINAL, tro rơi ngược → title)

Luật chung: 3 s đầu là gameplay (Steam tự phát tắt tiếng → hiểu được không cần âm thanh) · ≥ 80% thời lượng là cảnh quay in-game 1920×1080 60 fps H.264 (máy quay + Autopilot seed cố định, Roadmap §4.2) · không cảnh dựng giả, không UI giả · thẻ chữ ≤ 6 từ, ≥ 48 px ở 1080p · âm −14 LUFS-I, đỉnh ≤ −1 dBTP · nhạc chỉ từ cue 32-Audio-Bible.md §3.7 · xuất thêm bản 9:16 1080×1920 cho video dọc ngắn.

Teaser "Đêm Câm" 60 s (MS01, M0) — TITLE · màn tiêu đề + menu chính (Cài đặt/Credits mở từ đây giữ nguyên cue dưới SN_DRAFT)… MUS_title_mute_night → EXPLORE/COMBAT · Hồi I B1 Đồi Mộ Tro · bản đồ + mọi nút CMB/ELT/CHL/RSC/EVT/SHP/RST/SEC c… MUS_b1_grave_hill

Trailer demo 90 s (M8, trước Next Fest) — 0–3 s hook như teaser · 3–20 s 3 hero (H01 Varek, H02 Bodan, H07 Veyra) mỗi người 1 đòn chữ ký + 1 ĐÁP · 20–40 s horde + draft (thẻ trên màn ≤ 1.5 s) · 40–55 s Tro Nhớ: callout "NÓ ĐÃ ĐỌC BẠN" + Tinh Anh đổi đòn · 55–75 s BS_B1 P1→P3 (BOSS · nút BOS Hồi I · BS_B1 Người Gác Chuông · stem theo pha (không theo I) · P3 "Chuông… MUS_boss_b1_bell_warden) · 75–84 s Trăng Máu · 84–90 s "Chơi demo — Next Fest 10/2027" + wishlist. Trailer EA 90 s (M11) — hook · 5 hero (thêm H03 Halka, H06 Ruvan) · B2 Đầm Vải Liệm + BS_B2 · DAILY (bảng xếp hạng thật trên màn) · thẻ "Early Access 01/2028 · lộ trình 12 Kẻ Thức". Trailer U1/U2/U3 45–60 s — mỗi bản: 2 hero mới (Bible §10) + Hồi mới + mode mới; mở bằng đòn chữ ký hero mới trong 3 s đầu. Trailer 1.0 120 s (M31) — hook · 12 Kẻ Thức lần lượt 3 s/người (36 s, mỗi người 1 ĐÁP riêng) · B1→B4 · Tro Nhớ · FINALE · B5 Đỉnh Chuông Câm (Kết, act V): ải 60 s trộn quái 4 Hồi (lớp theo I) + BS_FINAL… MUS_finale_crown · đòn cuối vào Mũ Chuông BS_FINAL, tro rơi ngược → title (không lộ lựa chọn "Giữ lõi", không lộ B6/BS_TRUE) · "Phát hành 1.0".

2.4 Tag (20, theo thứ tự ưu tiên — 5 tag đầu nặng nhất trong gợi ý của Steam)

• Không dùng tag thể loại "tự đánh/sinh tồn bầy" (Roadmap Q1: khác biệt bằng ĐÁP/Lướt có kỹ năng), không dùng tag khen ("Great Soundtrack", "Masterpiece"). "Early Access" do Steam tự gắn.
• Rà lại mỗi mốc: nếu 1 tag người chơi gắn đứng top 5 mà không có trong danh sách → giữ nếu đúng sản phẩm, gỡ nếu sai (ví dụ "Bullet Hell" sai: đạn tím ≤ 2 trên màn, INV-13).
• Hạng mục Steam: Single-player · Steam Achievements (từ EA) · Full controller support · Steam Cloud · Steam Leaderboards (từ EA) · Steam Trading Cards (1.0, nếu đủ điều kiện) · Remote Play on TV/Tablet/Phone · Family Sharing. Không: co-op, PvP, Remote Play Together (Bible #57).

2.5 Mô tả

Mô tả ngắn (≤ 300 ký tự [STEAMWORKS])

• VI (229 ký tự): "Đại Chuông Vọng câm tiếng, người chết hoá Tro. Chém xuyên bầy 250 thây cùng 12 Kẻ Thức — mỗi người một vũ khí, một nhịp, một cách ĐÁP tell vàng. Kẻ địch nhớ cách bạn đánh. Chết, thức dậy bên Lửa Canh, đi tiếp."
• EN (≈ 265 ký tự): "The Great Bell has gone silent and the dead turn to ash. Carve through hordes of 250 as 12 Wakers — each with one weapon, one rhythm, one way to answer the golden tell. Your enemies remember how you fight. Die, wake by the Vigil Fire, go again."

Mô tả dài — khung 8 khối (VI và EN cùng cấu trúc; GIF/webm 616 px rộng, ≤ 3 MB, 3–6 s lặp [STEAMWORKS])

• Luật chữ: không so sánh với game có thật, không "giống X"; số trên trang = số canon (150–250 quái, 12 hero, 60 thành tựu…); khối 7 chỉ liệt kê mode đã ship ở build hiện tại.
• Thuật ngữ EN chốt cho trang (bảng loc sở hữu bản cuối): ĐÁP = Answer · Lướt = Dash · Kẻ Thức = Waker · Tro Nhớ = Ash Memory · Khăn Tang = Mourning Band · Độ Tang = Mourning · Dư Âm = Afterring · Dạng Rèn = Forging · Then Chốt = Linchpin · Lửa Canh = Vigil Fire · Đại Chuông Vọng = Great Bell.

2.6 Giá, cấu hình, khảo sát nội dung

• Giá: EA 11.99 USD → 1.0 14.99 USD (Bible §1). Giá vùng = bảng đề xuất của Steamworks, không chỉnh tay trừ khi > ±15% so với đề xuất. Giảm ra mắt EA 10% × 7 ngày [ASSUMED]. Không giảm giá trong 30 ngày trước ngày tăng giá 1.0 và không giảm sau 1.0 trước 1.0 + 2 tháng (Roadmap §3.10). Báo tăng giá trên trang + sự kiện ≥ 30 ngày trước MS07. Không DLC, không gói hỗ trợ, không IAP (Bible §13).
• Cấu hình (điền model phần cứng thật trực tiếp trên Steamworks sau đo ở MS01b; không ghi tên hãng vào repo):

• Steam Deck (APU 4 nhân/8 luồng, 16 GB, 1280×800) = trần thiết kế riêng, ngưỡng ở §8.2 / doc 50 §5.1; không phải hàng "Tối thiểu".
• Ngân sách: RAM tiến trình ≤ 3 GB, texture thường trú ≤ 1 GB, cài đặt ≤ 4 GB (Roadmap §5.3). HĐH: PC 64-bit được Steam hỗ trợ; không build gốc cho HĐH khác ở 1.0 (Deck chạy build PC qua lớp tương thích của Steam — kiểm ở §8).
• Khảo sát nội dung trưởng thành [STEAMWORKS]: bạo lực giả tưởng thường xuyên (pixel, quái là Tro, máu tối giản: hạt đỏ/tro, không mảnh xác chi tiết); chủ đề cái chết, tang lễ, linh hồn. Không khoả thân, không tình dục, không cờ bạc, không mua bán trong game. Nhãn tuổi khu vực: tự khai qua bảng câu hỏi của Steamworks; dự kiến 12+/13+ [ASSUMED].

3.1 Phạm vi demo (= Roadmap §3.5, MS02)

3.2 Khác biệt kỹ thuật của demo

3.3 Checklist Next Fest (kỳ 10/2027 = tuần F; mốc lùi theo tuần)

• Kiểm chất lượng demo trước F−5: chạy được 100% bằng tay cầm (§8) · Deck: 60 fps cảnh MS01b, chữ đọc được ở 1280×800 · màn đồng ý telemetry điều hướng được bằng tay cầm · 0 lỗi A, ≤ 5 lỗi B · ngôn ngữ EN + VI 100% chuỗi · không chuỗi debug · nút Wishlist hoạt động có/không overlay.

3.4 KPI demo (Roadmap §3.5, giữ nguyên ngưỡng)

• Bảng lộ trình trên trang (ảnh 616 px, cập nhật mỗi mốc): U1 (05/2028) +H10 Ingra, +H04 Sậu, Hồi III, Canh Thâu Đêm · U2 (09/2028) +H11 Wenna, +H08 Dov, Hồi IV, Đêm Hồi Chuông, Khăn Tang 11–15, Act Mutator · U3 (02/2029) +H09 Kessa, +H05 Oska, trận cuối + kết đầu, Lễ Tự Chọn, Truy Tuần · 1.0 (08/2029) +H12 Ambrin, vùng bí mật, 2 kết, 10 ngôn ngữ.
• Luật EA: chỉ hứa nội dung đã có trong Bible §10; trễ mốc → cập nhật ảnh lộ trình + sự kiện Steam trong 7 ngày, ghi lý do; không bao giờ hứa ngày cụ thể dưới mức tháng. Màn "tiến độ EA" trong game (Roadmap §3.6) đọc cùng bảng này từ config/ea_roadmap.json (tải theo build, không gọi mạng).

5.1 Số lượng theo mốc

5.2 Nhóm (tổng 60 ở 1.0 · 30 ở EA)

5.3 Luật thiết kế thành tựu

• Dạy hệ thống, không cày: ≤ 3 thành tựu cần > 40 h (MR10 × 12 hero tính là nhóm hero, mỗi mục ≤ 8 run, DEC-2026-11-07-02); không thành tựu "chơi N ngày liên tiếp", không thành tựu theo thứ hạng leaderboard (top %), không thành tựu "bỏ lỡ vĩnh viễn" (mọi mục làm lại được, kể cả END_ASH_CROWN: "lần sau chọn lại được").
• Ẩn chỉ để giấu truyện (B6, 2 kết sau); mô tả ẩn hiện "Bí mật của Sổ Tang".
• CUSTOM: 0 thành tựu (Bible §4.1). Thương Xót bật: khoá đúng các mục mercy_blocked: true = 6 mục nhóm Khăn Tang (Bible §4.3: Thương Xót chỉ khoá leaderboard + thành tựu Độ Tang); mọi nhóm khác vẫn mở. UI chọn Thương Xót ghi rõ số mục bị khoá.
• Mod/nội dung lệch hash (§16): thành tựu vẫn mở (chơi đơn), leaderboard khoá.
• API: steam_api_name = ACH_<SLUG> viết hoa của id (vd ACH_ash_crown → ACH_ASH_CROWN); bất biến sau khi ship; không xoá thành tựu đã ship (chỉ sửa chữ). Mở khoá → SetAchievement + StoreStats ngay (thành tựu là sự kiện hiếm, không gom).
• Ngoại tuyến: Steam không chạy → ghi achievements_pending[] trong save/meta_<steamId>.json; lần init Steam kế → đẩy hết, xoá hàng chờ khi StoreStats callback OK.
• Icon: 256×256 = gốc 64×64 ×4 pixel; bản khoá = cùng hình, độ bão hoà 0, sáng 40% (sinh bằng script, không vẽ 2 lần); tên icon icon_<slug> (field icon).
• Thứ tự hiển thị trên Steam = thứ tự nhóm bảng §5.2; agent sinh file đánh số theo nhóm.

6.1 Stats Steam (ISteamUserStats; INT trừ khi ghi; API name bất biến)

• Luật ghi: SetStat ở sự kiện, StoreStats chỉ ở điểm lưu run (MAP, BOSS_GATE, DOCK — doc 16 §11), hub, màn kết, thoát game; tối đa 1 StoreStats/60 s trừ khi có thành tựu mới. Không bao giờ ghi trong vòng lặp frame.
• Thành tựu tiến trình (vd 100 ĐÁP) dùng stat + "progress stat" của Steamworks để Steam hiện thanh tiến độ.
• CUSTOM và chế độ Thương Xót: stats vẫn cộng (thống kê cá nhân), chỉ thành tựu/leaderboard khoá.

6.2 Leaderboard (Bible §4.1; STANDARD và CUSTOM không có bảng)

• Tuần = tuần ISO, đổi thứ Hai 00:00 UTC (Bible: seed Truy Tuần). <YYYYMMDD> theo UTC. Bảng cũ giữ 90 ngày rồi ẩn trong UI (vẫn còn trên Steam).
• Tất cả bảng ghi "Trusted" [STEAMWORKS]: client không ghi điểm; chỉ máy chủ ghi qua Web API sau kiểm hợp lý (§6.3). Client chỉ đọc (FindLeaderboard, DownloadLeaderboardEntries Global/AroundUser/Friends).
• Khoá nộp điểm: CUSTOM · Thương Xót bật bất kỳ mục · build debug/qa (nộp vào bảng DEV_* riêng) · hash nội dung lệch (§16) · trạng thái ngoại tuyến quá hạn (§6.3 bước 5).
• 1 lượt tính điểm: DAILY 1/ngày, Truy Tuần 1/tuần (Bible). Lượt bị tiêu khi bắt đầu run tính điểm (ghi daily_key vào run_active.json + meta) → thoát/crash không reroll được; chơi lại sau đó = luyện tập, không nộp. BOSS_RUSH và ENDLESS: nộp mọi lần, bảng giữ điểm tốt nhất mỗi người.
• Chi tiết đính kèm (details, int32[], ≤ 64 [STEAMWORKS]): [0] schema=1 · [1] hero 1–12 · [2] Dạng Rèn 1–3 · [3] ult 1–3 · [4] Độ Tang · [5] kills · [6] perfectAnswers · [7] actsCleared · [8] giây chơi · [9] content_version · [10] build_number · [11–16] BOSS_RUSH ms từng trận (0 nếu mode khác) · [17] tầng ENDLESS. UI bảng xếp hạng đọc [1]–[4] để hiện hero/Dạng Rèn/Độ Tang mỗi dòng.

6.3 Luồng nộp điểm có kiểm hợp lý (Bible §4.1 "Chống gian lận DAILY"; 1 PM tech Bible §10.1)

1. Nướng trần theo seed (CI, trước khi bảng mở): job CI daily_seed_bake (Unity headless, -batchmode -nographics) chạy đúng code C# MapGen + ngân sách Director + bảng encounter của build cho 14 daily_key kế tiếp + 2 key tuần kế tiếp, với mỗi content_version đang live (danh sách hash live §11.4). Mỗi tổ hợp tải lên kho khoá-giá trị seedcap/<daily_key>/<content_version> = {spawn_max_per_min_250, spawn_max_per_min_180, act_min_s[4], score_per_s_cap[4]} (kills/phút tối đa Director sinh được với trần 250 và 180 quái sống; giây tối thiểu mỗi Hồi I–IV = 60% trung vị Bible, vd Hồi I 6:30 → 234 s [ASSUMED]; trần điểm/giây mỗi Hồi). Job chạy mỗi ngày 00:00 UTC + mỗi lần đẩy build mới lên default/beta; thiếu key → cảnh báo kênh vận hành, máy chủ đưa mọi bài nộp của key đó vào held (không tự chấp nhận). Máy chủ chỉ đọc KV này, không chạy MapGen/Director.
2. Kết run tính điểm → client dựng RunSubmission {steam_id, board, seed64, daily_key, mode, hero, aspect, ult, do_tang, kills, perfect_answers, acts_cleared, seconds_played, tells_emitted_yellow, tells_emitted_purple, act_times_s[], alive_cap, content_hash, build_number, details[]}. alive_cap = 250 | 180: trần quái sống thấp nhất đã áp trong run (preset Deck/máy yếu tự hạ 180 khi fps < 50 trong 10 s — doc 01 §5.1; một khi xuống 180 thì ghi 180 cho cả run).
3. Client lấy vé GetAuthTicketForWebApi("bw-score") → POST HTTPS tới máy chủ điểm (URL trong config build).
4. Máy chủ xác thực vé qua Web API (AuthenticateUserTicket), kiểm quyền sở hữu app, tra content_hash → content_version trong danh sách hash live, đọc seedcap/<daily_key>/<content_version> (bước 0; key tuần dùng key tuần), rồi kiểm: (a) điểm/giây mỗi Hồi ≤ score_per_s_cap[act] · (b) kills/phút ≤ spawn_max_per_min_250 nếu alive_cap = 250, ≤ spawn_max_per_min_180 nếu alive_cap = 180 (trần của nền tảng nộp, doc 19 §6; giá trị alive_cap khác 250/180 → held) · (c) mỗi act_times_s[i] ≥ act_min_s[i] · (d) perfect_answers ≤ tells_emitted_yellow + tells_emitted_purple · (e) content_hash thuộc danh sách hash build đang live · (f) chưa có lượt cho daily_key/tuần đó.
5. Đạt → ghi điểm bằng Web API SetLeaderboardScore (KeepBest cho ENDLESS/BOSS_RUSH, ForceUpdate cho DAILY/WEEKLY) → client nhận accepted + hạng. Trượt → held (không ghi), lưu vào hàng duyệt tay; UI: "Điểm đang chờ duyệt" (không buộc tội). Top 50 mỗi bảng duyệt tay mỗi ngày (Bible); gỡ điểm sai bằng Web API xoá điểm.
6. Ngoại tuyến/máy chủ lỗi: client giữ RunSubmission trong local/score_queue/, thử lại khi khởi động + mỗi 5 phút ở hub. Hạn nộp (theo giờ máy chủ nhận, doc 19 §5.2): DAILY nhận chỉ khi tới máy chủ trước 02:00 UTC ngày kế ngày của daily_key · tuần trước 02:00 UTC thứ Hai sau tuần đó; sau hạn → máy chủ trả expired, client xoá bài khỏi hàng chờ, báo "Đã quá hạn nộp".
7. Máy chủ: 1 hàm không trạng thái + kho khoá-giá trị (seedcap/, daily_result/, hàng duyệt, log 90 ngày); khoá Web API publisher chỉ nằm ở máy chủ, không bao giờ trong build. Tải thiết kế: 20k nộp/ngày [ASSUMED].
8. Chốt bảng ngày & thưởng top 10% (+5 Nến Canh, Bible / doc 17 / doc 19 §5.2): lúc 02:00 UTC ngày kế, tác vụ hẹn giờ của máy chủ đóng bảng DAILY của daily_key (từ đó mọi bài nộp key này = expired), đọc entry_count (số dòng được ghi, không tính held) và tính cutoff = điểm ở hạng ceil(0.10 × entry_count) (vd 2 347 dòng → hạng 235). Ghi KV daily_result/<daily_key> = {cutoff, entry_count}; bất biến sau khi ghi (gỡ điểm gian lận sau đó không tính lại). Client gọi GET /v1/daily/result?key=<daily_key> lúc khởi động và mỗi lần vào hub, cho mọi daily_key có lượt tính điểm accepted chưa nhận thưởng trong 30 ngày qua (chưa có kết quả → 404, thử lại lần sau). Nếu điểm của mình (giá trị accepted máy chủ trả ở bước 4) ≥ cutoff và daily_key chưa có trong meta.daily_rewards_claimed[] → cộng 5 Nến Canh CUR_VIGIL_CANDLE, thêm key vào meta.daily_rewards_claimed[] trong cùng một lần ghi nguyên tử meta_<steamId>.json (§7.2), hiện toast "Top 10% Daily — +5 Nến Canh". Key đã có trong danh sách → bỏ qua (chống nhận đôi kể cả khi 2 máy cùng gọi: luật xung đột §7.3 giữ một bản, danh sách đi cùng số dư). daily_rewards_claimed[] giữ key ≤ 30 ngày (key cũ hơn xoá ở lần ghi meta kế); KV daily_result/ giữ 90 ngày. Điểm held được duyệt chấp nhận sau 02:00 → vào bảng, không đổi cutoff, vẫn được nhận nếu ≥ cutoff.

6.4 Ví dụ tính

• DAILY: kills 4 200 · perfectAnswers 180 · actsCleared 4 · Độ Tang của seed 5 · giây chơi 1 950 → (4 200 + 50×180 + 2 000×4) × (1 + 0.05×5) − 1 950 = 21 200 × 1.25 − 1 950 = 24 550. Kiểm (b): alive_cap 250 → 4 200 / 32.5 phút = 129 kill/phút ≤ spawn_max_per_min_250 của seed (vd 190) → đạt; cùng run trên Deck đã tự hạ (alive_cap 180) so với spawn_max_per_min_180 (vd 140) → 129 ≤ 140 → đạt. Thưởng (bước 7): bảng ngày 2 347 dòng → cutoff = điểm hạng 235 = 23 900 → 24 550 ≥ 23 900 → +5 Nến Canh ở lần mở game kế.
• ENDLESS: qua tầng 14, tổng 3 725 s → 14 × 1 000 000 + (999 999 − 3 725) = 14 996 274; UI hiện "Tầng 14 · 62:05". Cùng tầng 14 nhưng 3 600 s → 14 996 399 > 14 996 274 → nhanh hơn xếp trên.
• BOSS_RUSH: 6 trận 41 200 + 55 800 + 63 100 + 70 400 + 88 900 + 102 600 ms = 422 000 ms → hiện "7:02.000".

7.1 File & thư mục

Gốc lưu = thư mục dữ liệu người dùng của game + /<steamId64>/ (mỗi tài khoản Steam 1 hồ sơ; Bible §8: Tro Nhớ lưu phía người chơi). Auto-Cloud đồng bộ save/ (mẫu *.json, *.bak); không đồng bộ local/.

• Quota Steamworks: 64 MB, 40 file / người [ASSUMED] (dùng thực ~3 MB, 8 file).
• Demo: gốc save_demo/ (app riêng → cloud riêng), cùng luật.

7.2 Ghi file

• Mọi file save/ có khối đầu {schema_version, content_version, save_seq, utc_written, device_id, checksum}; save_seq +1 mỗi lần ghi; device_id = UUID ngẫu nhiên lưu ở local/ (không phải mã phần cứng); checksum = CRC32 phần thân.
• Ghi nguyên tử (doc 16 §11): .tmp → fsync → đổi tên file cũ thành .bak → rename .tmp → cập nhật local/cloud_marker.json. Không ghi trong phòng chiến đấu; tần suất: điểm lưu run, hub, màn kết, thoát game.
• Meta tiền tệ gửi vào meta_<steamId>.json ở mỗi điểm lưu (doc 16) → crash/mất cloud tối đa mất 1 phòng.

7.3 Luật xung đột (thứ tự áp dụng)

• Không bao giờ tự xoá dữ liệu cloud. "Xoá toàn bộ tiến trình" trong Cài đặt: xác nhận 2 lần (giữ nút 2 s) + chép bản sao vào local/conflict/.
• Ví dụ: chơi PC tới GD2 (meta.save_seq 410), tắt mạng, chơi Deck từ bản cũ seq 380 thêm 2 run (seq 395), bật mạng → Steam báo xung đột (luật 1), người chơi chọn "Cloud" (PC, 410) trên Deck → Deck tải seq 410 > marker Deck 395 → không hiện luật 2; 2 run trên Deck mất, bản seq 395 không còn (do Steam đè) → chấp nhận (người chơi đã chọn). Nếu Steam tự tải bản cloud cũ hơn mà không hỏi (seq 380 < marker 410 trên PC) → luật 2 hiện màn chọn.

8.1 Input

• Game đọc tay cầm qua lớp input của engine (1 InputActions, InputFrame — Roadmap §5.2); không bắt buộc Steam Input. Steamworks: cấu hình Steam Input mặc định = mẫu "Gamepad" cho Deck; tay cầm PC khác theo thiết lập Steam của người chơi.
• Bản đồ nút = Bible §1.1 (khoá): Đánh X/LMB · ĐÁP chạm / verb giữ RB/RMB · Lướt A/Space · Kỹ năng LB·LT·RT / Q·E·F · Ult Y/R · Bình máu d-pad xuống/1 · Xem Tro Nhớ View/Tab · Bản đồ/tạm dừng d-pad lên·Menu / M·Esc · Tương tác B/G. Remap toàn bộ + preset 1 tay ở Trợ năng.
• Nút lưng Deck (L4/R4/L5/R5) trong cấu hình chính thức: L4 = Bình máu, R4 = Ult, L5 = Xem Tro Nhớ, R5 = Tương tác (bản sao, không thay nút chính) [ASSUMED]; gyro tắt; trackpad phải = chuột chỉ trong menu.
• Glyph: 5 bộ (Roadmap §5.2): bàn phím/chuột · bố cục ABXY · bố cục ký hiệu hình học · Deck · chạm (sau). Chọn bộ theo thiết bị input cuối; nếu Steam Input khởi tạo được → GetInputTypeForHandle quyết định (Deck → bộ Deck). Đổi glyph sống ≤ 1 frame sau input đầu tiên của thiết bị mới.
• Nhập chữ (chỉ: seed ở CUSTOM, tên preset remap): ShowFloatingGamepadTextInput khi đang dùng tay cầm; không có ô nào bắt buộc gõ.
• Mất kết nối tay cầm trong run → tự tạm dừng (§10) + "Kết nối lại tay cầm".

8.2 Checklist Steam Deck Verified (mục tiêu MS07; MS03 = Playable)

• Nộp đánh giá Deck: M12 (cho nhãn Playable lúc EA) và M30 (Verified trước 1.0); lỗi trả về → sửa trong ≤ 2 tuần, nộp lại.

8.3 Suspend / resume & tiêu điểm

• Mất tiêu điểm cửa sổ, Deck suspend, overlay mở, tay cầm rời → Menu tạm dừng ngay trong frame đó (World + Hero dừng — doc 16 §11), âm thanh vào snapshot tạm dừng; không cần lưu.
• Resume: đồng hồ run không tính thời gian suspend (giây chơi DAILY = đồng hồ run, không tính tạm dừng); hiện lại khung cuối ≤ 2 s; hàng chờ mạng (§6.3, §15) thử lại sau 10 s; không nhả tạm dừng tự động (người chơi bấm Menu/B để tiếp).
• Suspend > 30 phút giữa DAILY: vẫn hợp lệ (đồng hồ không chạy), nhưng bước 5 §6.3 vẫn áp hạn nộp 02:00 UTC ngày kế.

• Khoá steam_display = 1 token dưới đây; tham số qua SetRichPresence(key, value); file token Steamworks có 1 khối/ngôn ngữ đã ship (§12). Token lồng: {#Hero_%hero%} → tên hero, {#Biome_%biome%} → tên vùng.
• Cập nhật chỉ khi đổi trạng thái (vào hub, đổi Hồi, vào/ra boss, đổi tầng/trận), tối đa 1 lần/5 s; không bao giờ đưa chữ người chơi gõ; Hồi VI (B6) và boss B5/B6 không lộ tên (chống spoil).

• Tham số: hero = Varek H01…Ambrin H12; act = I…IV (số La Mã, giống UI); biome = Đồi Mộ Tro B1…Thành Chuông Treo B4; dotang 1–43; floor 1–999; fight 1–6. Demo chỉ dùng #Menu, #Hub, #Yard, #Run, #Boss.
• Không dùng steam_player_group (không co-op). Bộ token mới (hero hậu 1.0) thêm bằng #Hero_<id> khi ID được cấp.

• Tạm dừng không được dùng để "đọc tell": khi tạm dừng, tell đang chạy đóng băng nhưng hiện mờ 50% dưới menu; tiếp tục → 0.3 s đếm ngược trước khi World chạy (không đổi INV-03, vì windup dừng cùng World).

11.1 App & depot

• File symbol debug không nằm trong depot; lưu nội bộ theo build_number để giải mã dump crash (§15).

11.2 Nhánh Steam

• Lùi về previous sau khi đã chơi bản mới → luật 5 §7.3 (khoá chỉ-đọc nếu save mới hơn); ghi cảnh báo trong mô tả nhánh.
• Build qa/rc/dev_leaderboard: watermark góc màn "build_number + nhánh"; phím debug chỉ ở đây, bị gỡ khỏi default (Roadmap §3.10, kiểm bằng CI: build release không chứa symbol lệnh debug).

11.3 Phiên bản

• Chuỗi hiển thị MAJOR.MINOR.PATCH (build_number): demo 0.9.x · EA MS03 0.1.0 · U1 0.2.0 · U2 0.3.0 · U3 0.4.0 · 1.0 1.0.0 · hero hậu 1.0 1.1.0, 1.2.0… · vá nóng tăng PATCH. build_number tăng đơn điệu toàn dự án (CI).
• content_version (int, trong save + details[9]) tăng khi dữ liệu gameplay đổi theo cách cần migration hoặc làm điểm không so được; bảng leaderboard theo ngày/tuần nên không cần reset; ENDLESS_FLOOR* reset (đổi tên bảng thêm hậu tố _V2) chỉ khi cân bằng ENDLESS đổi > 10% sức mạnh — cần mục DEC-.

11.4 Checklist phát hành (mỗi bản lên default)

• Vá nóng: lỗi A (crash > 1/100 phiên, mất save, chặn tiến trình) → bản vá ≤ 48 h; lỗi B gom vào bản vá kế (≤ 14 ngày trong EA).
• Lùi: bản mới lỗi A không vá kịp trong 12 h → đặt lại build trước lên default (Steamworks giữ lịch sử build), báo bằng sự kiện Steam.

12.1 Lộ trình ngôn ngữ (Bible §10, milestones)

• Cut-line bước 9 (Bible §10.2): trễ → 1.0 giữ 5 ngôn ngữ, 5 ngôn ngữ mới vào bản vá sau.
• Trên Steamworks khai: Giao diện + Phụ đề = có cho mọi ngôn ngữ đã ship; Lồng tiếng = không (Bible §13: không voice có nghĩa).

12.2 Quy trình

• Nguồn: VI (viết gốc, *_vi) → EN (bản trục cho dịch giả) → 8 ngôn ngữ còn lại dịch từ EN, có bảng thuật ngữ (§2.5 + glossary loc) và ngữ cảnh (ảnh chụp, giới hạn ký tự, {param}).
• Khối lượng ~65–70k từ nguồn (Bible §10.3); đóng băng loc 4 tuần trước mỗi MS (khoá nội dung M12 cho EA).
• Không ship bản dịch máy chưa qua người duyệt. Mỗi ngôn ngữ: 1 dịch giả + 1 người duyệt chơi build rc ≥ 4 h.
• UI chừa chỗ 140% độ dài EN (DE/RU/PT-BR dài nhất); pseudo-loc (kéo dài 40% + ký tự có dấu chồng) chạy trong CI.
• Font: pixel Latin có đủ dấu chồng tiếng Việt (2 tầng dấu trong chiều cao dòng); CJK glyph ≥ 12 px, canvas UI riêng (Bible §10.3); KO dùng cùng chuẩn CJK; RU Cyrillic cùng lưới pixel Latin.
• Trang cửa hàng, ghi chú cập nhật lớn, rich presence (§9), mô tả thành tựu: dịch cùng bộ ngôn ngữ đã ship trong game. Devlog nhỏ: chỉ VI + EN.

• Không dùng lớp DRM bên thứ ba, không vỏ DRM của Steam, không chống gian lận cài thêm, không yêu cầu trực tuyến. Game chạy khi Steam ngoại tuyến (chế độ Offline của Steam client).
• SteamAPI_Init thất bại (không có Steam) → vẫn vào game ở chế độ ngoại tuyến: lưu cục bộ cùng định dạng (không cloud), thành tựu vào achievements_pending[], stats cộng cục bộ, leaderboard ẩn, rich presence tắt, DAILY chơi được dạng luyện tập (seed vẫn sinh tất định từ ngày UTC, không nộp). Không gọi RestartAppIfNecessary để ép mở qua Steam.
• Lý do: người chơi mua game sở hữu bản chạy được; rủi ro sao chép chấp nhận (game premium giá thấp; leaderboard + cloud là giá trị chỉ có khi mua).
• Mã nguồn và dữ liệu không mã hoá (ngoài đóng gói asset bình thường); toàn vẹn leaderboard dựa vào máy chủ (§6.3), không dựa vào làm rối mã.

Cửa hoàn tiền Steam: < 2 h chơi và < 14 ngày từ ngày mua [STEAMWORKS] → 2 giờ đầu quyết định. KPI EA (Roadmap §3.6): hoàn tiền ≤ 8% an toàn, > 12% đỏ; đánh giá ≥ 80% an toàn, < 70% đỏ.

• Luật đánh giá: không bao giờ thưởng/khuyến khích đánh giá (cấm theo luật Steam); không hộp thoại xin đánh giá trong game; chỉ 1 mục "Góp ý" ở menu chính. Key cho người sáng tạo/báo chí chỉ qua công cụ key Steamworks, ghi sổ; không bán key cho bên trung gian.
• Trả lời đánh giá: 2 tuần đầu EA và 1.0: trả lời mọi đánh giá tiêu cực có lỗi cụ thể trong ≤ 72 h với hướng xử lý; không tranh luận về sở thích.

15.1 Màn đồng ý (lần chạy đầu, sau chọn ngôn ngữ; điều hướng tay cầm)

• Đổi bất cứ lúc nào ở Cài đặt › Quyền riêng tư; có nút "Xoá dữ liệu đã gửi" (gửi yêu cầu xoá theo telemetry_id, xử lý ≤ 30 ngày) và "Tạo mã ẩn danh mới".
• Nộp điểm leaderboard (§6.3) là chức năng, không phải telemetry: lần đầu vào DAILY/ENDLESS/BOSS_RUSH hiện 1 thông báo "Điểm và thống kê run sẽ gửi tới máy chủ bảng xếp hạng" + lựa chọn "Chơi không xếp hạng".
• Liên kết chính sách quyền riêng tư trên trang Steam + trong màn đồng ý. Không thu thập: tên tài khoản, email, IP lưu lâu (> 24 h ở log mạng), danh sách bạn bè, đường dẫn thư mục người dùng, ảnh màn hình.

15.2 Sự kiện (chỉ khi đồng ý; telemetry_id = UUID ngẫu nhiên lưu settings_shared.json, không suy ra từ steamId)

• Gửi theo lô ở hub/màn kết/thoát; nén ≤ 50 KB/run; hàng chờ ngoại tuyến ≤ 5 MB (đầy → bỏ cũ nhất); không gửi trong phòng chiến đấu. Lưu thô 13 tháng, tổng hợp lâu dài. Máy chủ telemetry = cùng hạ tầng máy chủ điểm (§6.3), khác endpoint.

15.3 Báo crash

• Bộ bắt crash ghi: minidump + 2 000 dòng log cuối + build_number + content_version + 30 sự kiện run gần nhất + preset; xoá đường dẫn người dùng/tên máy trong log trước khi lưu. Lần chạy kế → theo lựa chọn §15.1 (hỏi: hộp thoại "Game đã gặp lỗi lần trước. Gửi báo lỗi?" với "Gửi" / "Không").
• ≤ 2 MB nén/báo; giữ 90 ngày; symbol theo build_number (§11.1). Gộp theo chữ ký stack; KPI ≤ 0.2 crash/100 phiên (Roadmap §3.5).
• Báo lỗi không crash: phím "Báo lỗi" trong menu tạm dừng (bản qa/rc + bản phát hành) gửi log + ảnh chụp chỉ khi người chơi tick "Đính kèm ảnh".

• Quyết định: không Workshop, không công cụ mod chính thức tới hết MS08 (Bible §13: không công cụ mod/editor màn ở 1.0). Xem lại ở cổng port M33–M35 chỉ khi đạt cổng "Steam tốt" (Roadmap §3.11) và có ≥ 1 PM dư — mục DEC- mới.
• Không chặn mod cộng đồng (dữ liệu không mã hoá, §13), không hỗ trợ: lúc khởi động tính content_hash của gói dữ liệu; lệch danh sách hash của build → cờ "nội dung đã sửa": leaderboard khoá (§6.2), thành tựu + stats vẫn mở, crash report gắn cờ để lọc; telemetry gắn cờ, loại khỏi số liệu cân bằng.
• Family Sharing: cho phép. Remote Play (lên TV/máy tính bảng/điện thoại): cho phép, không tối ưu riêng. Remote Play Together: không (không co-op, Bible #57).
• Thẻ giao dịch Steam: đăng ký khi Steam xác nhận đủ điều kiện, mục tiêu 1.0: 6 thẻ = 6 khoảnh khắc (Varek Trăng Máu, Bodan, Veyra, Xà Ích Xe Tang, BS_B1, Tháp Chuông Gãy), 5 emoticon (◇ tell vàng, ▲ tím, Mắt Tro, chuông câm, Lửa Canh), 3 nền hồ sơ (B1, B2, hub) — art từ asset đã duyệt, vẽ mới ≤ 0.5 PM.
• Steam Playtest: chỉ M7–M8 (§1), không dùng lại sau Next Fest (nhánh beta thay thế).
• Hồ sơ Steam/điểm Steam (vật phẩm hồ sơ mua bằng điểm): không làm.

• Mọi lệnh gọi Steamworks đi qua 1 interface IPlatformServices (Roadmap §3.11) — cài đặt SteamPlatformServices + OfflinePlatformServices (§13); gameplay không gọi API Steam trực tiếp (CI grep SteamUserStats, SteamFriends… ngoài thư mục Platform).
• API name thành tựu/stat/leaderboard và token rich presence bất biến sau khi ship; thêm mới được, đổi tên/xoá = không (chỉ sửa chữ hiển thị).
• Leaderboard luôn Trusted; khoá Web API publisher chỉ ở máy chủ; build có khoá → chặn phát hành.
• StoreStats chỉ ở điểm lưu/hub/kết/thoát, ≤ 1/60 s trừ khi có thành tựu mới.
• File save/ chỉ ghi nguyên tử với khối đầu §7.2; thêm file cloud mới → thêm vào bảng §7.1 + mẫu Auto-Cloud cùng lượt.
• Mọi màn hình phải điều hướng được bằng tay cầm và đọc được ở 1280×800 (chữ ≥ 12 px); thêm màn mới phải qua 2 kiểm này trước merge.
• Không gửi telemetry/crash khi chưa có đồng ý tương ứng; trường mới vào sự kiện → thêm vào bảng §15.2.
• Chỉ viết tên thương hiệu Steam/Steam Deck/Steamworks/Next Fest; số [STEAMWORKS] đối chiếu tài liệu Steamworks hiện hành khi thực hiện.
• Số [ASSUMED] thay bằng số đo ở mốc tương ứng (ghi ngày) — không đổi luật canon Bible.