DEEPSTAIR — Master GDD

0Cách đọc bộ GDD

Bảng số liệu xuất được nằm ở GDD/Config/*.csv, sinh từ GDD/Tools/data/*.py bằng py -I GDD/Tools/build_tables.py (đồng thời cập nhật các bảng nằm giữa cặp marker HTML BEGIN:<tên> … END:<tên>). Sửa số ở file data, không sửa tay bảng. Mô phỏng cân bằng: GDD/Tools/balance_sim.py.

Quy ước:

• [INV-xx] Design Invariant — ràng buộc cứng; pipeline kỹ thuật coi là hard constraint.
• Giá trị balance mặc định là [ASSUMED] (khởi điểm, tinh chỉnh bằng CSV/Remote Config) trừ khi ghi [DERIVED] (từ công thức/mô phỏng) hoặc [BENCHMARK] (thị trường).
• KC = Kim Cương (Gem). Khoảng cách tính bằng pixel nghệ thuật (px); thời gian bằng giây; tick mô phỏng = 1/60 s.
• Tên trong game luôn là tên gốc của Deepstair; không dùng tên/thương hiệu của game, anime, phim có sẵn.

1Tổng quan

Tiền đề. Thành phố Dawnhold sống dưới nhật thực vĩnh viễn từ khi Tâm Bình Minh — đốm lửa cuối của mặt trời — bị Vua Rỗng (The Hollow King) lôi xuống đáy Deepstair: cầu thang xoắn đào vào vực thẳm, 100 chiếu nghỉ sâu dần. Những chiến binh mang Đèn Hồn (Lanternbound) lần lượt đi xuống. Trên mỗi bậc thang còn vương Hồi Âm — ký ức chiến đấu của những người đã ngã xuống trước họ. Mỗi tầng vượt qua, đèn hút lấy một Hồi Âm và người mang đèn học thêm một lối đánh. Gục ngã, đèn kéo linh hồn về Trạm Đầu Thang (camp trên mặt đất): Hồi Âm tan biến, nhưng tro hồn và vàng nhặt được thì ở lại.

Hook một câu: Xem những trận chém pixel nhanh, đã, đúng nhịp như phim hành động — mỗi tầng bạn chọn một Hồi Âm, mỗi run là một bộ combo khác hẳn.

USP:

1. Hack&slash biên đạo tự động: chuỗi đòn có hủy đòn (cancel), tung hứng trên không, dội tường, đánh nằm, gạt đòn (Deflect) đúng khung hình, chặn (Block), né (Evade), phản đòn (Counter), va kiếm (Clash), vỡ thế → Tuyệt Sát điện ảnh. Người chơi không bấm, nhưng mọi va chạm đều "đúng nhịp".
2. Mỗi anh hùng một phong cách, một vũ khí, cố định: 8 anh hùng ra mắt, mỗi người 55–70 đòn riêng (gồm đòn phòng thủ, di chuyển) và 35+ Lộ Trình Combo; không có đổi vũ khí/trang bị vũ khí.
3. Build hiện bằng chuyển động: Hồi Âm Combo thêm lộ trình mới vào Cây Combo — người chơi thấy đòn mình vừa chọn ngay tầng sau. Phong Độ D→SSS đo độ đa dạng & đẹp mắt.
4. Phòng thủ là cảnh diễn: tỉ lệ Gạt/Chặn/Né hiển thị công khai, build được; chuỗi gạt liên tiếp → Dòng Chảy (Flow State).
5. Cầu thang xoắn đi xuống: tiến trình đọc bằng mắt — càng sâu càng tối, chọn thẻ trong lúc anh hùng đi xuống cầu thang.
6. Pixel art sinh bằng code (Tools/pixelfx): rig 3D raster hóa ra pixel, act dạng dữ liệu → mở rộng nội dung đòn rẻ.

2Trụ cột thiết kế

3Design Invariants

• INV-01 Chiến đấu 100% tự động. Tương tác trong run giới hạn: chọn Hồi Âm, lựa chọn ở Chiếu Nghỉ/Cổng, tốc độ, bật/tắt Auto-Pick, kích hoạt Bộc Phá thủ công (tùy chọn), tạm dừng, bỏ cuộc.
• INV-02 Mỗi tầng vượt qua cho đúng một lượt chọn Hồi Âm chuẩn 1-trong-3 (4 thẻ chỉ với nút Cây Đèn Hồn E10 ở tầng Thủ Vệ/Boss hoặc Phước Lành quảng cáo ở tầng Boss). Thẻ thêm ngoài lượt chuẩn chỉ đến từ danh sách 06 §5.5 (Chiếu Nghỉ, Cây Đèn Hồn E03 Lv2 ở tầng 1, tự chọn của Xuống Nhanh).
• INV-03 Roguelite: gục hết hồi sinh → mất toàn bộ Hồi Âm, Than Hồng, buff run; giữ Vàng/Tro Hồn/EXP/XP Thông Thạo/rương theo công thức kết quả (05 §9).
• INV-04 Một anh hùng = một vũ khí, cố định. Không đổi/trang bị vũ khí. Hình dáng, bảng màu chính và vũ khí của anh hùng không bao giờ đổi; Trang Phục chỉ đổi phụ kiện + ramp màu phụ + màu VFX (02 §3.4). Địch luôn khác bảng màu anh hùng.
• INV-05 Sát thương chỉ phát ra ở hit-frame của MoveDef (sinh từ act.hits[].t của pixelfx). Kết quả phòng thủ của anh hùng được quyết định tại thời điểm cam kết của đòn địch (DEFENSE_LEAD = 0.15 s trước hit-frame) và hiển thị đúng hit-frame của địch. Hit-stop, rung, VFX, SFX bám cùng frame đó.
• INV-06 Phòng thủ là xác suất công khai. Mọi kết quả Gạt/Chặn/Né/Trúng đến từ tỉ lệ hiển thị trên bảng chỉ số anh hùng + điều chỉnh theo loại đòn (01 §5.3); không có RNG ẩn khác. Mọi roll dùng luồng RNG có seed.
• INV-07 Màn hình dọc, một tay: mọi nút tương tác trong run nằm ở 45% dưới màn hình (trừ tạm dừng/tốc độ ở dải trên).
• INV-08 Không bán Hồi Âm cụ thể bằng tiền thật, không popup IAP trong run. Trong run chỉ tiêu KC/quảng cáo cho: hồi sinh (≤ 1 quảng cáo + 1 KC/run), đổi thẻ (1 quảng cáo + ≤ 3 KC/run), Phước Lành (1 quảng cáo/run).
• INV-09 Offline-first: gameplay, kinh tế, IAP grant chạy local theo pattern pack của template (CSV + PackageManager + RewardManager + TimeManager). Chỉ bảng xếp hạng (v1.1) cần mạng và không ảnh hưởng tiến trình.
• INV-10 Không quảng cáo xen kẽ trong trận hay màn chọn thẻ. Trong run chỉ một điểm nghỉ: rời tầng Boss (x0) sau khi đã chọn thẻ; chung trần/ngày với màn Kết Quả; Remote Config ads_interstitial_boss_enabled.
• INV-11 Ra thẻ tất định theo seed: lượt chọn tầng N được sinh một lần và lưu vào snapshot trước khi hiển thị; thoát/vào lại không đổi được thẻ.
• INV-12 Nhịp 10 tầng cố định: Boss ở x0, Thủ Vệ ở x5, Chiếu Nghỉ sau x3 và x7, Cổng Boss sau x9.
• INV-13 Tốc độ game, hit-stop, slow-mo không ảnh hưởng kết quả kinh tế; phần thưởng tính theo tầng/sự kiện, không theo giây.
• INV-14 Mô phỏng chiến đấu tất định, độc lập frame-rate: tick cố định 60 Hz trên CombatClock riêng; cùng seed + cùng build + cùng anh hùng → cùng trận (chạy headless hàng nghìn run để cân bằng).
• INV-15 Hồi Âm riêng chỉ xuất hiện cho đúng anh hùng của nó; Hồi Âm chung cho mọi anh hùng. Hồi Âm riêng được mở dần bằng Thông Thạo anh hùng (chơi), không bao giờ bán.
• INV-16 Mọi đòn trong một Lộ Trình bắt đầu và kết thúc ở khung "thủ" (guard key) của anh hùng (trừ đòn trên không/đòn nối có cờ link) — sprite không blend được, nên tính liên tục của chuỗi đến từ khung đầu/cuối chung (02 §5.3).

4Vòng lặp cốt lõi

KHOẢNH KHẮC (1–4s)  Địch lấy đà (báo hiệu) → anh hùng GẠT đúng khung va (tia lửa, đóng băng)
        │           → PHẢN ĐÒN → mở Lộ Trình Combo: chém nối → hất tung → combo trên không → đập xuống
        │           → Thế địch vỡ → TUYỆT SÁT (zoom 2×, letterbox)
TẦNG (30–75s)       Xuống thang vào phòng → 2–4 wave địch tràn ra từ cửa ngục/khe tường/trần
        │           → hạ hết → đi xuống cầu thang xoắn → CHỌN 1/3 HỒI ÂM → tầng sâu hơn
RUN (8–40 phút)     B1 → … Chiếu Nghỉ (x3, x7) → Thủ Vệ (x5) → Cổng Boss (x9) → Boss (x0) → …
        │           → gục (hết hồi sinh) hoặc hạ Vua Rỗng ở B100 → KẾT QUẢ: Vàng, Tro Hồn, EXP, XP Thông Thạo, Rương
META (mỗi ngày)     Rèn Luyện (Vàng) · Cây Đèn Hồn (Tro Hồn) · Anh hùng: cấp (Vàng+Quyển Chiến), sao (Mảnh), Thông Thạo (chơi)
        │           · Di Vật (Rương) · Lửa Trại AFK · nhiệm vụ · Pass · sự kiện → run sau xuống sâu hơn
DÀI HẠN             Kỷ lục độ sâu B1→B100 · sưu tầm 8(+4) anh hùng · Thông Thạo 20 cấp/anh hùng · Bậc Kinh Hoàng 1–20 · Vực Không Đáy

5State machine

5.1 Trạng thái ứng dụng

5.2 Trạng thái trong run

EchoPick diễn ra trong lúc anh hùng đi xuống cầu thang xoắn (diegetic): camera trượt dọc theo trục cầu thang, phòng tầng trước mờ dần lên phía trên, UI chọn thẻ phủ nửa dưới (11 §4.4).

6Cấu trúc nội dung

6.1 Roster (khóa) — concept art: Heroes/H01.png … H21.png

Sau ra mắt (1 anh hùng/mùa 28 ngày, 03 §9): H09 Zerran (song đại đao ma, L) · H10 Feng (tay không, R) · H11 Momo (côn vàng, E) · H12 Isolde (băng pháp, L) · H13 Aurelle (quyền trượng thiên sứ, E) · H14 Sorin (song vuốt, E) · H15 Tsubaki (ô giấy, E) · H16 Juno (đại pháo, E) · H17 Ignis (kiếm liễu, R) · H18 Elowen (cung, R) · H19 Kazane (song quạt, E) · H20 Taurok (đại chùy, R) · H21 Vulkar (song liêm xích dung nham, L). Bảng tổng (sinh từ dữ liệu):

7Lộ trình người chơi

7.1 FTUE (ngày 0, ~15 phút đầu)

Run 1 có trợ lực ẩn +30% sát thương tới hết B9 (địch B1–9 giữ nguyên), B11–14 HP/ATK địch ×0.85; Thủ Vệ B15 của run 1 HP ×4, ATK ×4 là bức tường có chủ đích. Số ở RunRules.csv (ftue_*), chỉ áp run 1.

7.2 Mốc kỳ vọng (F2P — mô phỏng 08 §6)

Dolphin (~$30/tháng) hạ B100 khoảng D20–28; Whale (~$300+/tháng) khoảng D10 DERIVED — 08 §6.

8Mở khóa tính năng

Luật hàng đợi: mỗi lần về Home phát tối đa 1 tính năng mới (+ quà của nó); các mốc đủ điều kiện cùng lúc xếp hàng theo cột "Hàng đợi" (số nhỏ trước), lưu bền. Tính năng chưa phát vẫn khóa: không badge, nút có chỗ cố định thì vẽ trạng thái khóa (pixel xám), chạm → toast điều kiện. Cổng im lặng (0) — mở ngay khi đủ điều kiện, không popup: Tốc độ x1.5/x2/x3, Auto-Pick, Auto-Rerun, Xuống Nhanh, Bậc Kinh Hoàng + Vực Không Đáy. Ngoại lệ duy nhất: xong bước FTUE 10 ở một lần về Home thì Sảnh Anh Hùng (bước 11) phát luôn trong lần đó nếu Boss B10 đã hạ. Lần về Home có quà Vex (bước 14) không phát tính năng nào. Thẻ mới mở, thưởng lên cấp, thưởng mốc độ sâu kiếm trong run hiện ở Kết Quả, không thành popup ở Home.

9Bản đồ điểm chạm kiếm tiền

10Thuật ngữ (khóa)

11Bản đồ module & thứ tự xây dựng

12Edge case toàn cục

13Hằng số gốc (numeric spine)

Nguồn duy nhất: GDD/Tools/data/constants.py. Mọi module nhập từ đây.

14Sổ đăng ký ID (khóa — mọi module dùng đúng các id này)

14.1 Hồi Âm chung dùng làm xúc tác Tiến Hóa (id + tên cố định)

14.2 Nút Cây Đèn Hồn được module khác tham chiếu

HANDOFF BLOCK — GDD → TECH

Locked Invariants

• INV-01 Chiến đấu tự động hoàn toàn
• INV-02 Một lượt chọn chuẩn 1-trong-3 mỗi tầng; thẻ thêm chỉ từ nguồn liệt kê
• INV-03 Chết mất build run, giữ meta theo công thức
• INV-04 Một anh hùng = một vũ khí cố định; skin không đổi danh tính
• INV-05 Sát thương ở hit-frame MoveDef; phòng thủ quyết định lúc cam kết, hiển thị đúng hit-frame địch
• INV-06 Phòng thủ là xác suất công khai, có trần tổng
• INV-07 UI tương tác trong run ở 45% dưới
• INV-08 Không bán Hồi Âm, không IAP trong run
• INV-09 Offline-first
• INV-10 Không quảng cáo xen kẽ trong trận/chọn thẻ
• INV-11 Ra thẻ tất định, lưu trước khi hiển thị
• INV-12 Nhịp 10 tầng
• INV-13 Tốc độ game không ảnh hưởng kinh tế
• INV-14 Mô phỏng tất định 60 Hz trên CombatClock
• INV-15 Hồi Âm riêng chỉ cho đúng anh hùng, mở bằng Thông Thạo
• INV-16 Đòn trong lộ trình bắt đầu/kết thúc ở guard key

Locked Terminology

• §10.

Mitigated Issues (Tech pipeline KHÔNG raise lại)

• Save-scum thẻ: INV-11 + snapshot trước khi hiển thị.
• Save-scum máu giữa tầng: checkpoint đầu wave + snapshot khi Downed (05 §16).
• Phòng thủ bất tử: trần Gạt 60%, Chặn 60%, Né 50%, Gạt+Né ≤ 70%, Gạt+Chặn+Né ≤ 90%; Chặn chỉ giảm (≤ 75% đòn nhẹ, 45% đòn nặng) và tốn Khí Thủ; đòn không thể chặn (đâm/quét/túm) bỏ qua Chặn/Gạt (01 §5).
• Vòng lặp hồi máu từ phòng thủ: mọi hồi máu "khi Gạt/Chặn/Né" có ICD và tính vào trần Regen 2%/s quy đổi (01 §3.1, 06 §8.4).
• Phản đòn spam: ICD Phản Đòn 0.8/1.5/1.2 s (Gạt/Chặn/Né).
• Tung hứng vô hạn: trần 10 hit trên không (thẻ nâng tối đa 24), trọng lực ×1.5 sau 6 hit, 1 lần dội tường + 1 lần dội đất mỗi lượt tung (01 §9).
• Build bất tử khác: trần DR 60%, tổng giảm ≥ 15% sát thương lọt, Regen 2%/s sau mọi hệ số, tối đa 3 hồi sinh miễn phí + 2 trả phí/run.
• Hồi Âm riêng tràn lượt chọn: cấu trúc lượt chọn cố định (ô A riêng, ô B chung, ô C linh hoạt) + chuẩn hóa trọng số (06 §4).
• Idle 24/7 phá nhịp kinh tế: Auto-Rerun dừng sau 5 run không chạm (Thẻ Tháng: 10).
• Run quá dài khi mạnh: Xuống Nhanh + tốc độ x2/x3.
• Lạm phát Vàng ở Vực Không Đáy: Vàng/tầng tuyến tính sau B100.
• Whale phá cân bằng: không PvP; bảng xếp hạng v1.1 tách theo Bậc Kinh Hoàng và theo anh hùng.

Quyết định đã chốt (owner giao AI tự quyết — 2026-11-01)

Owner yêu cầu "tự làm tất cả những gì bạn thấy tốt nhất mà không cần confirm". Các quyết định sau là baseline; chỉnh bằng CSV/Remote Config sau playtest: