10 — Tiến trình & thang mở khoá

Nguồn framework: docs/framework/07-progression-managers.md §2–§4, docs/framework/09-prestige-rebirth.md §2, §3.2, [liveops catalog: UNLOCK_GATES.md] §1–§5, [liveops catalog: SCREEN_CATALOG.md] §7, [liveops catalog: LIVEOPS_SURFACE.md] §4. Cấp bằng chứng: L1 ANALYSIS — dựng lại clean-room từ disasm + metadata + quan sát runtime; không phải source gốc. Mỗi dòng bên dưới mang nhãn bằng chứng riêng.

Mục tiêu

Bạn muốn làm một game idle có nhiều "phòng" (Rebirth, Mine, Fish, Boss, Pet, Hunt, Trip…) mở dần theo tiến độ, và mỗi phòng là một hệ thống nhỏ có nâng cấp, gacha, buff, nhiệm vụ riêng. Recipe này cho biết game gốc mở khoá bằng đúng một con số, tổ chức 35 hệ thống bằng một khuôn manager lặp lại, và cân bằng bằng bảng đã bake vào scene — kèm tất cả con số thật.

Game gốc làm gì

Biến cổng duy nhất và thang mở khoá 7 nút chính

Thang mở khoá (mọi ngưỡng là bội số của 10 ⇒ luôn mở ở level 1 của stage tương ứng):

Đối chiếu độc lập: ảnh chụp save thật "Stage 5-4" ⇒ Stage_Value = 3 + 40 = 43 ⇒ Rebirth(20) và Mine(30) mở, Fish/Boss/Pet/Hunt/Trip khoá — khớp 100 % với ảnh (UNLOCK_GATES §1.5, VERIFIED).

Cổng phụ và nút không có cổng

Nút không có cổng (mở từ Stage 1-1): Shop_Btn, Gun_Btn, Skin_Btn, SpeedRun_Btn (Play), Mission_Btn, EcoMode_Btn, Auto_Btn, Setting_Btn, DailyCheck_Btn, DiaPig_Btn, PowerBuff_Btn, MoneyBuff_Btn, Rank_Btn (UNLOCK_GATES §4). Các nút liveops (StepUp_Btn/DailyGun_Btn/WeeklyShop_Btn/FreeCash_Btn/OfferWall_Btn) mặc định m_IsActive: 0, bật bởi thời gian/liveops, không phải stage.

Bộ khung manager

Nâng cấp trong vòng (Upgrade_manager)

Buff, súng, relic, skin, nhiệm vụ

Trip (Adventure_manager): vé, XP, bảng mở khoá — đợt 3

Công thức / pseudocode

# Cổng mở khoá — Tree_manager (VERIFIED, RVA 0x2B4441C / 0x2B452E4 / 0x2B45820)
Stage_Value      = Level_Now + 10 * Stage_Now          # Level_Now 0..4, Stage_Now 0-based
on Game_Win:                                           # G347 — thân hàm đầy đủ ở doc 05 §3.6
    StageAdvance(ref Stage_Now, ref Level_Now)
    if Random(0,100) < Relic.Skip_Value and Level_Now + 10*Stage_Now < Stage_Value_Max:
        StageAdvance(...)                              # relic "Skip": chỉ nhảy TRONG vùng đã chinh phục
    Stage_Value = Level_Now + 10 * Stage_Now
    if Stage_Value >= Stage_Value_Max:
        Stage_Value_Max = Stage_Value                  # chỉ tăng, Rebirth không reset
        Rank_manager.SubmitScore(...)                  # [R1] leaderboard
        Contents_Lock_Reload()

Contents_Lock_Reload():
    Rebirth_Btn_Locked_obj.SetActive(Stage_Value_Max < 20)
    Mine_Btn_Locked_obj.SetActive(Stage_Value_Max < 30)
    Fish_Btn_Locked_obj.SetActive(Stage_Value_Max < 50)
    Boss_Btn_Locked_obj.SetActive(Stage_Value_Max < 90)
    Pet_Btn_Locked_obj.SetActive(Stage_Value_Max < 110)
    Monster_Btn_Locked_obj.SetActive(Stage_Value_Max < 110)
    Adventure_Btn_Locked_obj.SetActive(Stage_Value_Max < 340)
    FreeCash_manager.Hud_Reload(); OfferWall_manager.Hud_Reload()   # [R1] ad exposure

Content_Btn_X():
    if Stage_Value_Max >= N: mở panel X
    else: UI_manager.Alert(Format(Alarm.StageUnlock, N/10 + 1))   # số stage hiển thị

StageAdvance(ref stage, ref level):
    if level >= 4: level = 0; stage += 1
    else:          level += 1

// Khuôn manager lặp lại ở ~30 hệ thống (doc 07 §3.1)
public class X_manager : MonoBehaviour
{
    public static X_manager instance;          // field static trần, Awake: instance = this
    public void Balance_Reload() { … }         // sinh bảng — DEAD CODE trong 1.1.59, bảng thật nằm trong scene
    public int[] SaveData_return() { … }       // xuất state
    public void LoadData(SaveData data) { … }  // nạp state
    public void First_Reload() { … }           // thiết lập 1 lần (sprite, tên)
    public void Value_Reload() { … }           // cập nhật thường xuyên (số, tiến độ, khoá)
    public static T X_return() { … }           // phơi giá trị dẫn xuất cho hệ khác
}

# Buff (doc 07 §3.4) — thời gian còn lại có trần, không phải danh sách instance
AddBuff(type):   remaining[type] = min(remaining[type] + 300, 900)
IsBuffActive(t): IsPermanentBuff || remaining[t] > 0

# Súng (doc 07 §3.3)
degree(gunNum)   = gunNum / 5                          # 10 bậc, 5 khẩu/bậc
DrawRandomGun(d) -> slot = FindFirstEmptyOwned()       # int[16], -1 = trống
                 -> Owned_Gun_list[slot] = gunNum; Weapon_Get_Counts[d]++
TryStartAutoMerge(): limit = min(AutoMerge_Degree, Max_Collected_Degree); bậc >= 7 KHÔNG BAO GIỜ tự ghép

# Quota theo ngày (doc 07 §3.7) — khuôn dùng chung cho điểm danh, vé, lượt rút thưởng
Quota_Reload(key, maxPending):
    if savedDate.Date >= Today:            return    # Today = giờ local ĐÃ HIỆU CHỈNH, không phải giờ máy
    if !CanRolloverDaily(key, maxPending): return    # bị chặn -> KHÔNG ghi ngày mới, lần sau thử lại
    RecordGain(key); used = 0; savedDate = Today     # ghi sổ TRƯỚC, phát SAU, đánh dấu CUỐI
OnClockSynced(): savedDate = ClampFutureLocalDate(savedDate)      # trần = Today + 1 ngày

Bẫy đã gặp

• Balance_Reload không chạy ở runtime. CodeRefsTo = [] cho Upgrade_manager (0x2B4A02C), Rebirth_manager (0x2B21CB4), Gun_manager (0x2B0AB4C); không có string literal, không có UnityEvent trong scene. Bảng thật là mảng serialize trong Main.unity, sinh bằng lặp có cắt chứ không phải pow(). Dùng 100·1.08^lv sẽ lệch −10.2 % ở lv 50 và ×6.5 ở lv 1 000 (doc 09 §3.2; G138a; CONVERGENCE). Doc 01 §2 và doc 07 §2.1 còn dòng "bảng sinh bằng công thức lúc chạy" — đó là bản cũ, doc 09 đã đính chính.
• Kết luận "field không được tham chiếu" từ dump.cs là sai phương pháp. dump.cs chỉ liệt kê khai báo field, không liệt kê truy cập. Rebirth_Btn_Locked_obj từng bị ghi UNKNOWN vì thế; thực tế nó được Contents_Lock_Reload điều khiển qua static-instance + offset thô +48 (UNLOCK_GATES §2.3; G139 METHODOLOGY). Muốn chứng minh dead code / dead field: dùng IDA CodeRefsTo / DataRefsTo.
• Stage_Value_Max không reset khi Rebirth — nếu framework của bạn reset nó, nút sẽ khoá lại sau mỗi lần prestige (VERIFIED, doc 09 §2).
• Game_Win gọi Rank_manager.SubmitScore ngay sau khi tăng Stage_Value_Max — mọi probe ghi field này phải no-op SubmitScore, nếu không sẽ làm bẩn leaderboard production (G148 SAFETY).
• Ràng buộc bảo vệ người chơi phải là const trong code: AutoMerge_Exclude_Degree = 7. Designer chỉnh nhầm cấu hình sẽ tự ghép mất súng hiếm (doc 07 §3.3).
• Khớp nối chéo toàn phần: cặp Tree.Die_Reload → Tree_manager.Tree_Destroyed chạm 5 singleton cho một cây đổ — không ship được Gamemanager dạng overlay 70 method vì nó kéo theo cả đồ thị (doc 07 §3.1; G129).
• Mặc định giá trị bị công cụ decompile bỏ rơi: Ticket_Charge_Interval = 0 ⇒ chia cho 0 hai method sau; GameTime_Max = 0 ⇒ màn thua ở frame 1. Đọc .ctor của mọi class trước (doc 08 §3.6; G306, G321).
• Tích luỹ base-100 rỗng = nhân về 0 trong im lặng (R13). Relic.Dmg_Value = 0 ⇒ mèo 0 sát thương; Skin_Value_Reload rỗng ⇒ 0 damage, 0 tốc độ; không ngoại lệ, không cảnh báo. Trước khi ship bất kỳ thứ gì nhân X / 100, truy X tới setter (G359, G361, G363).
• Cân bằng súng có endpoint Google Sheet nhưng 0 code-xref tới Balance_Reload — HYPOTHESIS là design-time only; nếu sai, cân bằng súng là remote-driven và kết luận "liveops không ghi đè kinh tế" phải sửa (G144 OPEN-HIGH-RISK).
• Đừng xếp hạng công việc theo tên class: 731 type, 190 vào scene, 66 class chiếm phần lớn thời gian chạy (doc 07 §4.10).
• Đánh dấu "đã phát" trước khi phát, ở quota theo ngày. Ghi savedDate = Today trước khi qua cổng chống chỉnh giờ ⇒ người chơi mất trắng quota hôm đó và không có lỗi nào hiện ra. Đúng thứ tự là: kiểm ngày → kiểm cổng trust → ghi sổ → phát → mới đánh dấu ngày (doc 07 §3.7).
• Quên kẹp ngày lưu nằm ở TƯƠNG LAI. Không có bước ClampFutureLocalDate khi đồng hồ được đồng bộ, người chơi đẩy giờ máy tới năm sau rồi trả về là quota đóng băng vĩnh viễn (điều kiện savedDate < Today không bao giờ đúng nữa).
• Dựng đúng một hàm có thể KÍCH HOẠT một stub ở lớp khác đang nằm im. ClampFutureLocalDate từng là return default(DateTime) và vô hại — cho tới khi một lô khác dựng đúng OnTimeSynced; từ đó mỗi lần đồng bộ giờ ghi 0001-01-01 vào ngày lưu, tức reset quota mỗi lần. Trước khi đóng một lô, quét stub trên toàn bộ callee mà lô vừa mở đường tới, không chỉ các hàm mình viết.

Checklist khi tự làm

• [ ] Một biến tiến độ tổng hợp (Stage_Value), lưu max từng đạt, không reset khi prestige.
• [ ] Ngưỡng mở khoá là hằng số trong code, bội số của "số level mỗi stage" để luôn mở ở level 1.
• [ ] Cùng một ngưỡng kiểm ở hai chỗ: hàm bật/tắt ổ khoá và handler nút (kèm alert số stage).
• [ ] Gọi hàm cổng ở Start và ở mỗi lần lập kỷ lục stage; không nối qua UnityEvent nếu muốn tìm được bằng xref.
• [ ] Khuôn manager: instance + SaveData_return/LoadData + First_Reload/Value_Reload + X_return static.
• [ ] Nếu bake bảng cân bằng vào asset: bảng là nguồn sự thật; hàm sinh là công cụ Editor; ghi rõ luật cắt/tròn và số chữ số.
• [ ] Buff = float remaining có trần + IsPermanent property; một coroutine chỉ chạy khi có buff.
• [ ] Kho vật phẩm nhỏ: mảng cố định + giá trị lính canh (-1), quét tuyến tính.
• [ ] Mọi quota theo ngày đi qua một khuôn: giờ đã hiệu chỉnh + sổ nợ có trần theo khoá + giữ nguyên ngày cũ khi bị chặn + kẹp ngày ở tương lai.
• [ ] Gọi Quota_Reload ở cả hai đường: mỗi lần vẽ lại UI của bề mặt, và khi đồng hồ vừa đồng bộ lúc UI đang đóng.
• [ ] Ràng buộc bảo vệ người chơi (bậc không tự ghép) là const.
• [ ] Ít loại nhiệm vụ (4 là đủ), một API tăng tiến độ, phần thưởng nhận theo thứ tự.
• [ ] Tách máy móc toàn vẹn (Time_manager, anti-cheat) khỏi manager kinh tế, sau ITrustedTime.
• [ ] Cấu hình từ xa đi qua IRemoteConfigService fail-closed; ghi rõ số nào có thể bị ghi đè.
• [ ] Có một cheat panel riêng cho QA (như Cheat_manager), tắt bằng GameObject; loại cheat cấp tài nguyên khỏi mọi probe tự động.

Điều chưa biết (UNKNOWN)

• ~~Giá trị Adventure_Unlock_Balance[], Adventure_PetSlot_Unlock_Balance[]~~ — ĐÃ ĐÓNG: [0,1,3,6,10] và [0,2,7] (runtime; Unlock và Duration còn xác nhận tĩnh bằng blob — G353).
• ~~Adventure_manager.Exp_balance[] mâu thuẫn~~ — ĐÃ GIẢI (G361): mảng scene sống (hex blob), công thức chỉ là fallback khi mảng trống.
• HighTier_Gun_Table, MonsterCountPerLevel, SpawnIntervalPerLevel — giá trị đã đọc, nơi dùng chưa đọc (ý nghĩa UNKNOWN; doc 07 §5).
• Ngưỡng Mission SequenceLocked theo Reward_Degree/Lv — UNKNOWN.
• Ý nghĩa 2 cờ tĩnh trong Shop_manager.is_DiaPig_Unlock — UNKNOWN.
• 2/5 code-xref còn lại tới Contents_Lock_Reload — UNKNOWN.
• Có đường mở khoá Raid nào ở runtime không — bằng chứng tĩnh: KHÔNG; cần probe xác nhận (G142/G153).
• Thân WeeklyShop.Is_VIP_Unlocked (RVA 0x2B3EA58) — chưa giải mã.
• Thân Gun_manager.DrawRandomGun (RVA 0x2B0A278) — tỉ lệ rơi gacha UNKNOWN, chưa hề được đọc (doc 07 §5).
• Nội dung Google Sheet 65×9 và việc nó có được nạp ở runtime không — UNKNOWN, HYPOTHESIS "không" (G144).
• Request_Sheet có chạy lúc boot không — CHƯA XÁC MINH (không thấy trong cửa sổ trace 40 s).
• ~~Cấu trúc SaveData~~ — ĐÃ ĐÓNG: bản đồ 22 + 5 + 35 field, thứ tự nạp, vị trí AllowSave — xem 14 Lưu game & offline.
• Shop_manager, Adventure_manager, Fish_manager, Monster_manager, Raid_manager — khảo sát một phần (đường nạp save, vé/XP Trip, bể cá, các bảng static — doc 07 §5); Mine_manager, Boss_manager, SpeedRun_manager — chưa khảo sát ngoài số method và field restore.
• Relic_manager.Rebirth_Value nhận giá trị từ đâu — UNKNOWN (doc 09 §5).
• Điểm gãy ×1.002 (lv ≥ 14999) của giá node prestige trong mảng scene — UNKNOWN (chỉ tồn tại trong Balance_Reload đã chết).

Đọc thêm

• ../framework/07-progression-managers.md — bộ khung 35 manager, buff, gacha, nhiệm vụ, ranh giới R1
• ../framework/09-prestige-rebirth.md — bảng scene vs công thức designer, cổng Rebirth
• 14 — Lưu game & offline — đường nạp save 35 field, AllowSave, kẹp buff, cửa sổ offline
• ../framework/01-economy-money.md — mắt Upgrade/Rebirth trong chuỗi thu nhập
• [liveops catalog: UNLOCK_GATES.md] — bảng ngưỡng đầy đủ + chuỗi bằng chứng scene YAML
• [liveops catalog: SCREEN_CATALOG.md] — kiểm kê màn hình, Raid ẩn, Cheat_manager
• [liveops catalog: LIVEOPS_SURFACE.md] — Google Sheet súng (§4), lịch trình shop cố định (§6)
• [phân tích nội bộ] — hai phân tích độc lập hội tụ về U1/U4 và Balance_Reload
• gap list (nội bộ) — G129, G134, G136, G138a, G139, G144, G147, G148