05 — Kẻ địch & wave (một Enemy chung, hành vi riêng ở component anh em)

Nguồn framework: docs/framework/05-characters-pets-enemies.md §2.3, §3.4–3.6, §5; docs/framework/02-combat-projectiles.md §3.1/§3.6; docs/framework/06-juice-game-feel.md §3.2/§3.4; [liveops catalog: SCREEN_CATALOG.md] §6. 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

Muốn màn hình có hàng nghìn mục tiêu (cây, quặng, quái, boss) mà vẫn 60 fps, và muốn thêm một loại mục tiêu mới không phải sửa code đạn — thì tách "phần chung" (máu, tiền, thanh máu, nảy) vào một component Enemy, và để mỗi loại có component anh em quyết định chết thì làm gì. Trang này liệt kê 6 loại kẻ địch của CatGunner, số lượng thật trong scene, và cách wave/stage vận hành.

Game gốc làm gì

Công thức / pseudocode

// ---- L1 ANALYSIS (có RVA) ----

// Enemy.Die_Reload — RVA 0x2AFF354 : loại chung uỷ quyền vòng đời cho loại riêng
switch (_type) {
    case Tree:          GetComponent<Tree>().Die_Reload();          gameObject.SetActive(false); break;
    case Tree_SpeedRun: GetComponent<Tree_SpeedRun>().Die_Reload(); gameObject.SetActive(false); break;
    case BossMonster:   GetComponent<Boss>().Die_Reload();          break;   // KHÔNG tắt ở đây
    case Monster:       GetComponent<Monster>().Die_Reload();       break;   // KHÔNG tắt
    case Ore:           GetComponent<Ore>().Die_Reload();           break;   // KHÔNG tắt (Ore tự SetActive(false) ở cuối)
    case RaidBoss:      GetComponent<Raid_Boss>().Die_Reload();     break;   // KHÔNG tắt
}

// Enemy.Damaged — RVA 0x2AFEF9C
if (is_Die) return;  if (!Gamemanager.is_gaming) return;         // G132b
Health_Now -= Damage;
if (_type == Type.Monster) GetComponent<Monster>()?.Apply_Knockback((float)(Damage / Health_Max));  // chia Health_MAX
Slider_Reload();                                                 // ratio = Health_Now / Health_Max -> SpriteFill kênh đỏ
if (Health_Now <= 0) Die(); else _bounce.Bounce_Start();

// Enemy.Die  ->  Gamemanager.Get_Money(Money, transform.position);  Die_Reload();

// Damage_Tag — RVA 0x2A503F0 : Ore là mục tiêu đếm nhát
if (tag == "Enemy") { e.Damaged(Damage);     return true; }
if (tag == "Ore")   { e.Damaged((InfVal)1);  return true; }

// Tree.Die_Reload — RVA 0x2B43904 : chỉ HAI dòng (G346)
Particle_Polling.instance.Spawn(MoneySpawn_trans.position, is_Boss ? 15 : 5);   // không null-guard: binary dereference thẳng
Tree_manager.instance.Tree_Destroyed();

// Tree_manager.Tree_Destroyed : vòng đời một wave (trước đây bị gộp nhầm vào Die_Reload)
if (!Gamemanager.is_gaming) return;
TreeCount_Now--;
gameSlider.Value_Reload((TreeCount_Max - TreeCount_Now) / TreeCount_Max);
// [R1] SendLog_WaveRatio CHỈ khi Stage_Now == 0 && Level_Now >= Stage_Value_Max, mốc 10 %, dedup "{stage}_{level}_{percent}"
if (TreeCount_Now <= 0) Game_Win();                                    // private, cùng class
Mission_manager.instance.MissionValue_Increase(Mission_Type.TreeCount);

// Tree_manager.Game_Win (G347)
if (!is_gaming) return;  is_gaming = false;
_stageTimeAll += realtimeSinceStartup - _roundStartTime;  gameSlider.Value_Reload(1f);
StageAdvance(ref Stage_Now, ref Level_Now);
if (Random.Range(0, 100) < Relic_manager.Skip_Value && Level_Now + 10*Stage_Now < Stage_Value_Max)
    StageAdvance(ref Stage_Now, ref Level_Now);                        // relic Skip: chỉ trong vùng đã chinh phục
if (Level_Now + 10*Stage_Now >= Stage_Value_Max) {
    Stage_Value_Max = Level_Now + 10*Stage_Now;
    if (!is_ProgramDestroyed) Rank_manager.SubmitScore(false, null);   // [R1]
    Contents_Lock_Reload();  /* [R1] SendLog_WaveClear, SendLog_StageClear khi level cũ == 4 */
}
Sound_manager.PlaySfx(Win);  MissionValue_Increase(StageClear);  GameWin_UI on;  Loading_Then_Start();

// Tree_Grid.Spawn (G343): đặt cây theo đường cong Morton, lấy mẫu cách đều
order = indices 0..99 sắp theo Morton(i % 10, i / 10)      // Morton = Spread(x) | (Spread(z) << 1), Spread = đan bit
acc = 0; for k in 0..want-1 { acc += total; chọn order[acc / want]; }
localPosition = (5*j - 50*(j/10) + jitter, 0, 5*(j/10) + jitter), jitter ∈ ±randomRange

// Monster: animation trên shader, KHÔNG Animator  (dump.cs:594503)
_mpb.SetFloat(ID_TimeOffset, <lệch pha riêng từng con>);   // 240 con không đập cánh đồng loạt
_mpb.SetFloat(ID_AnimSpeed, …); _mpb.SetFloat(ID_ScaleAmount, …);
renderer.SetPropertyBlock(_mpb);

// ---- Gợi ý framework ----
Enemy (chung)  : Health_Now/Max, Money, is_Die, IProgressBar, IBounce
IEnemyKind     : OnDie() — quyết định vòng đời riêng (tắt ngay, chạy FX chết trước, đẩy wave, nhả dia…)
IDamageRouter  : tag/component -> lượng damage (Ore = hằng 1, không đi qua chuỗi nhân)
ICrowdAnim     : MaterialPropertyBlock(timeOffset, animSpeed, scaleAmount) cho đám đông; Animator chỉ cho boss
StageCurve     : bảng tính trước N stage + cache; nguồn sự thật là BẢNG đã bake, không phải hàm sinh

Bẫy đã gặp

• SetActive(false) bất đối xứng trong Die_Reload là có thật trong disasm: chỉ Tree/Tree_SpeedRun bị tắt tại Enemy; 4 loại kia tự quyết (Ore tự tắt ở cuối Die_Reload, Monster/Boss có thể cần FX chết). Ép mọi loại chết giống nhau sẽ làm mất hiệu ứng chết của boss (doc 05 §3.4).
• Knockback chia Health_Max, không phải Health_Now — dùng Health_Now thì quái sắp chết bị bắn văng kỳ quặc (doc 06 §3.4).
• Thiếu guard is_gaming trong Enemy.Damaged/Die — quái ăn damage và rơi tiền trong menu (G132b). Ore.Die_Reload và Tree_manager.Tree_Destroyed đều có guard rõ ràng trong disasm.
• Raid có trong binary và scene nhưng không có lối vào — đừng coi nó là nội dung "đã ship" khi làm inventory; nó là chế độ ẩn (SCREEN_CATALOG §6, G153).
• Bảng stage không sinh lúc chạy. Tree_manager.Balance_Reload (0x2B447EC) là dead code như các Balance_Reload khác (CONVERGENCE, LIVEOPS_SURFACE §4); mảng thật ở Main.unity:20614934 / :20624935. Đọc PowOfThree rồi suy ra "máu tăng theo bậc 3" là đoán — doc 05 §5 ghi rõ công thức UNKNOWN.
• Đếm wave bằng nhiều state — SOT chỉ có một TreeCount_Now, tỉ lệ tính lại từ nó; thêm bộ đếm thứ hai là mời bug lệch (doc 05 §3.6).
• GetComponentInParent trên mỗi lần trúng đạn — SOT tránh bằng EnemyColl.enemyScript (doc 05 §3.4/§4.8).
• Đọc comparer Morton thành "xáo trộn" rồi thay bằng Random ⇒ cây tụ đám, đúng thứ SOT cố tránh (G343).
• Coi Ore.Spawn(int skinNum) là chỉ số skin ⇒ âm thầm phá thưởng dia (binary dùng nó như boolean; G343).
• GameTime_Max mặc định 0 vì công cụ decompile bỏ rơi khởi tạo field ⇒ màn thua ở frame 1 mà không ném gì — tệ hơn null vì nó im lặng (G306). Đọc .ctor của mọi class trước khi dựng bất kỳ method nào.
• Công cụ decompile gộp hai hàm làm một (Tree.Die_Reload "ôm" trọn Tree_manager.Tree_Destroyed qua tail call) ⇒ ship sai class, sai visibility, một stub rỗng và một null-guard bịa. Kiểm biên hàm trước khi tin kích thước (G346; doc 08 §3.6).

Checklist khi tự làm

• [ ] Một component Enemy chung (máu/tiền/thanh máu/nảy) + component anh em cho từng loại; Die_Reload() dispatch theo enum.
• [ ] Cho loại riêng tự quyết vòng đời (tắt ngay hay chạy FX chết) — không ép chung.
• [ ] Mọi kẻ địch nằm sẵn trong scene/pool; đếm .ctor lúc load bằng số instance (không Instantiate lúc chạy).
• [ ] Collider con có liên kết ngược tới Enemy (kiểu EnemyColl.enemyScript).
• [ ] Thanh máu đám đông = vertex color / shader (SpriteFill); thanh boss = 9-slice + text (doc 06 §3.2).
• [ ] Knockback tỉ lệ damage / maxHealth, chỉ cho loại "quái", lưu handle coroutine để huỷ cái cũ.
• [ ] Đám đông animate bằng MaterialPropertyBlock + lệch pha; Animator chỉ cho boss/raid boss.
• [ ] Mục tiêu tài nguyên phụ (quặng) nhận damage hằng số — tách khỏi chuỗi nhân damage.
• [ ] Wave = một số nguyên; tiến độ tính lại; Game_Win khi về 0.
• [ ] Đường cong stage: bake bảng, cache dictionary, tính trước N stage (5 000 ở SOT); bảng là nguồn sự thật.
• [ ] Cây boss chỉ khác cây thường bằng một số count hạt (15 vs 5), không cần prefab riêng.
• [ ] Đặt mục tiêu trên lưới tất định (Z-order + lấy mẫu cách đều) + jitter nhỏ; giữ Random cho jitter, không cho phân bố.
• [ ] Bảng bốc bậc theo level là trọng số 100 %/hàng; bậc "boss" không nằm trong roulette.
• [ ] Relic "skip màn" chỉ nhảy trong vùng đã chinh phục — tăng tốc cày lại, không đẩy tiến độ mới.

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

• ~~Công thức Tree_manager.GetStageHealth / GetStageMoney~~ — ĐÃ ĐÓNG (G395): hàm sinh dùng seed 250 (máu) / 20 (tiền), ×3 mỗi stage, cắt về 2 chữ số có nghĩa — mảng scene 5 000 mục khớp 8 mục đầu (2250 → 2200, 19800 → 19000, 171000 → 170000). Hàm sinh vẫn là dead code lúc chạy — mảng scene là nguồn sự thật; công thức giải thích vì sao mảng trông như thế. Chưa đối chiếu đủ 5 000 mục.
• Monster.Freeze() và Barrier_Touched() — CHƯA dựng lại; biết chữ ký và BarrierRadius = 20 (RVA 0x2AF82E8 / 0x2AF7904).
• Monster.Knockback_Coroutine — CHƯA dựng lại; đường cong/khoảng cách/thời gian UNKNOWN (RVA 0x2AF7DE8).
• Boss_Slider.Value_Reload / Time_Reload — CHƯA dựng lại, phụ thuộc InfVal_change() (G007a).
• 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 (UNLOCK_GATES §5, G153).
• Value thực tế của WantSize cho 1 939 Bounce_Custom (nảy khi trúng) — UNKNOWN, dữ liệu inspector trong scene (doc 06 §5).
• Boss_manager (29m), SpeedRun_manager (26m), Mine_manager (31m) — CHƯA khảo sát ngoài chữ ký, hằng số và field restore; Monster_manager / Raid_manager đã đọc được các bảng static nhưng chưa đọc spawner (doc 07 §5).
• MonsterCountPerLevel / SpawnIntervalPerLevel — "level" là Level_Now (0..4) hay bậc gì: UNKNOWN (consumer chưa đọc; G353).
• ~~Cây/quặng chưa hiện trên bản dựng lại~~ — ĐÃ GIẢI (G354): cây nằm ngoài khung camera orthographic cho tới khi mèo tự đi tới (batch C); quặng (Mine) vẫn cần batch riêng cho Mine_manager (21 stub).
• ~~Cây không mất máu khi bị bắn (G424)~~ — ĐÃ ĐÓNG (G405): build 20 cây đổ 104/104 hit (xem 04).
• Chế độ Play (SpeedRun) — đã đọc trọn (G406): số cây clamp(15·stage + 20, 20..190), bậc ngẫu nhiên 1 / 1.8 / 3 trên đường cong stage, 60 s, bố cục vòng tròn, thắng = cây cuối đổ ⇒ stage++ và 30 dia (×4 auto); quét tự động khi sức mạnh ≥ máu stage × n × 193/100/24. Xem 10.
• Map "kẹo ngọt" ở stage 2 — không phải bug: chủ đề map = stage % 10 (10 chủ đề lặp) (G406).
• Ánh xạ sprite/skin của quái (SkinSprite trong Monster.Spawn) tới asset cụ thể — chưa trích từ scene.

Đọc thêm

• ../framework/05-characters-pets-enemies.md §2.3, §3.4–3.6 — bảng bằng chứng đầy đủ
• ../framework/02-combat-projectiles.md — đạn trúng quái như thế nào
• ../framework/06-juice-game-feel.md — thanh máu 2 tầng, knockback, nảy
• ../framework/03-particles-vfx.md §3.5 — số hạt theo ngữ cảnh
• ../framework/09-prestige-rebirth.md §3.2 — vì sao bảng scene là nguồn sự thật
• [liveops catalog: SCREEN_CATALOG.md] §6 — Raid chưa phát hành
• [liveops catalog: UNLOCK_GATES.md] — cổng Boss / Hunt / Mine
• gap list (nội bộ) — G127, G131, G132b, G153