🔔 Bladewake GDD
🎨 Art · VFX · Âm thanh

Thành tựu

Chính sách thành tựu Steam: số lượng theo mốc, nhóm, luật ẩn và Thương Xót.

Cập nhật: 2026-11-07

1Trạng thái & đích

📋
Trạng thái dữ liệu File data/achievements.json đã có. Bible đặt đích 60 thành tựu ở 1.0 (upgrades.counts_shared.achievements); doc 43 §5 ghi danh sách sinh sau theo schema doc 51 §4.28.
Số thành tựu theo bản phát hànhSố thành tựu theo bản phát hànhDemo / PlaytestDemo / Playtest: 00EA MS03EA MS03: 30301.0 MS071.0 MS07: 6060
Nguồn: doc 43 §5.1.
Schema achievements.json (doc 51 §4.28)
FieldKiểu / giá trị cho phép★Nghĩa
achievements[ object ] (1..60)★60 thành tựu
achievements[].idstring ^ACH_[a-z0-9_]+$★ID duy nhất (mẫu ở §2)
achievements[].name_vistring★tên hiển thị tiếng Việt có dấu
achievements[].desc_vistring★chữ thẻ/tooltip, mẫu câu có {param}
achievements[].condition→ condition (§4.0)★điều kiện có cấu trúc {kind, ref, op, value}
achievements[].hiddenany★ẩn
achievements[].steam_api_namestring ^[A-Z0-9_]+$★tên API Steam
achievements[].mercy_blockedany★khoá khi Thương Xót
achievements[].mourning_relatedanyliên quan Độ Tang
achievements[].iconstringtên sprite icon icon_<slug>
docstring★doc định nghĩa luật của file/khối (vd 12-Hero-Framework §8)

2Nhóm thành tựu

Thành tựu theo nhóm (EA → 1.0)Thành tựu theo nhóm (EA → 1.0)Có từ EAThêm tới 1.002.557.510Truyện & kếtTruyện & kết · Có từ EA: 22Truyện & kết · Thêm tới 1.0: 668Kẻ ThứcKẻ Thức · Có từ EA: 55Kẻ Thức · Thêm tới 1.0: 7712Boss & CổngBoss & Cổng · Có từ EA: 44Boss & Cổng · Thêm tới 1.0: 226Kỹ năng (ĐÁP/Né)Kỹ năng (ĐÁP/Né) · Có từ EA: 66Kỹ năng (ĐÁP/Né) · Thêm tới 1.0: 228BuildBuild · Có từ EA: 55Build · Thêm tới 1.0: 227Tro NhớTro Nhớ · Có từ EA: 33Tro Nhớ · Thêm tới 1.0: 225Khăn TangKhăn Tang · Có từ EA: 33Khăn Tang · Thêm tới 1.0: 336ModeMode · Có từ EA: 11Mode · Thêm tới 1.0: 334Hub & codexHub & codex · Có từ EA: 11Hub & codex · Thêm tới 1.0: 334
Nguồn: doc 43 §5.2.
Cơ cấu 60 thành tựu ở 1.0Cơ cấu 60 thành tựu ở 1.0Truyện & kết: 8 (13%)Kẻ Thức: 12 (20%)Boss & Cổng: 6 (10%)Kỹ năng (ĐÁP/Né): 8 (13%)Build: 7 (12%)Tro Nhớ: 5 (8%)Khăn Tang: 6 (10%)Mode: 4 (7%)Hub & codex: 4 (7%)60thành tựuTruyện & kết — 8 (13%)Kẻ Thức — 12 (20%)Boss & Cổng — 6 (10%)Kỹ năng (ĐÁP/Né) — 8 (13%)Build — 7 (12%)Tro Nhớ — 5 (8%)Khăn Tang — 6 (10%)Mode — 4 (7%)Hub & codex — 4 (7%)

Truyện & kết

1.0: 8EA: 2Ẩn: true cho 3 mục END_QUIET_SHORE, END_ASH_Khoá khi Thương Xót: false

qua Hồi I · II · III · IV; END_BELL_TOLL = ACH_bell_toll (ACH_BELL_TOLL) · END_QUIET_SHORE = ACH_quiet_shore (ACH_QUIET_SHORE) · END_ASH_CROWN = ACH_ash_crown (canon) · FLAG_SHORE_OPEN = ACH_shore_open

Kẻ Thức

1.0: 12EA: 5Ẩn: falseKhoá khi Thương Xót: false

1/hero: đạt MR10 với Hxx (EA: 5 hero đã ship)

Boss & Cổng

1.0: 6EA: 4Ẩn: falseKhoá khi Thương Xót: false

hạ đủ mini-boss 1 biome; hạ BS_Bx không dùng bình máu; …

Kỹ năng (ĐÁP/Né)

1.0: 8EA: 6Ẩn: falseKhoá khi Thương Xót: false

100 ĐÁP trong 1 run; 10 Né Hoàn Hảo liên tiếp; ĐÁP 1 tell vàng của boss pha 3; …

Build

1.0: 7EA: 5Ẩn: falseKhoá khi Thương Xót: false

kích 1 Cộng Hưởng II; 1 Tiến Hoá; Then Chốt (1.0); thắng Hồi với 3 Relic Lời Nguyền; …

Tro Nhớ

1.0: 5EA: 3Ẩn: falseKhoá khi Thương Xót: false (Thương Xót đặt Tro Nhớ 0 → tự nhi

thấy Mắt Tro 3/3; thắng trận có thế đáp ASH bật; hạ boss mang Sẹo (sau END_BELL_TOLL); …

Khăn Tang

1.0: 6EA: 3Ẩn: falseKhoá khi Thương Xót: true, mourning_related: true

hạ boss Hồi cuối của build với Độ Tang ≥ 4 · 8 · 16 · 24 · 32 · 43 (EA: 4 · 8 · 16; trần EA 29)

Mode

1.0: 4EA: 1Ẩn: falseKhoá khi Thương Xót: false

xong 1 Lễ Ngày; xong 1 Truy Tuần; ENDLESS tầng 10; xong Đêm Hồi Chuông

Hub & codex

1.0: 4EA: 1Ẩn: falseKhoá khi Thương Xót: false

Phục Dựng GD5; 120 trang codex; dâng đủ LV01–LV06; xong TT1–TT5

3Luật thiết kế

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

4Liên kết dữ liệu

KếtThành tựu
Hồi Chuông END_BELL_TOLLACH_bell_toll
Mũ Tro END_ASH_CROWNACH_ash_crown
Bến Bình Yên END_QUIET_SHOREACH_quiet_shore

Hiển thị khi mở khoá: AchievementUnlocked (toast góc phải trên; hàng đợi ≤ 3, trong combat … VFX_UI_achievement_toast · AchievementUnlocked (ACH_*; toast góc phải trên) SFX_UI_achievement