02 — Chiến đấu & đạn (Combat / Projectiles)

Nguồn: chưng cất từ restore SOT com.Chodun.CatGunner 1.1.59 (BardCat). Mọi C# ở đây là L1 ANALYSIS — dựng lại clean-room từ ARM64 disassembly, không phải source gốc.

1. Câu hỏi tài liệu này trả lời

Một idle-shooter phải bắn liên tục, không cấp phát, va chạm với hàng nghìn mục tiêu, và hỗ trợ nhiều "loại súng" có ngữ nghĩa va chạm khác nhau — tất cả trong một class đạn duy nhất. Bullet.Update chạy 14 199 lần / 40 giây trong trace runtime; nó là hot path thật.

2. Stable truths

| Tiếng bắn bị chặn bởi hai cờ: Cat_manager.is_Shoot_Mute AND Setting.is_eco | disasm-proven | Attack 0x2AE9624; G363 | Mute kép (doc 04) | | Chuỗi 100 sát thương của súng khởi đầu — xác minh từ số scene: Gun_list[0].Damage 100 × Power_balance[0] 100/100 × Rebirth 100/100 × Skin 100/100 × (Fish 0 + 100)/100 × Relic 100/100 = 100; đường TrySpawnBulletEx → Bullet.SpawnEx → OnTriggerEnter → HitSingle → Damage_Collider đã đầy đủ. Hai bẫy base-100 (Rebirth_manager.Damage_return = 0, Relic.Dmg_Value = 0) từng đưa tích về 0 | disasm-proven + scene-YAML (derived) | G363, G361; R13 | Bài học then chốt |

3. Mô hình hành vi

3.1 Kiến trúc tổng thể — một class đạn, dispatch theo enum

Gun_manager / Cat_manager  (quyết định bắn)
        |
        v
Polling_manager.Object_Polling(Objects_Type.Bullet)   -> lấy Bullet từ pool
        |
        v
Bullet.SpawnEx(...)          hoặc   Bullet.SpawnMissile(...)
   Skin_Reload(gunNum)  -> chọn ParticleSystem theo skin súng
   Mesh_Reload(gunNum)  -> bật Bullet_Mesh tương ứng
   ResetState()         -> xoá _hitIds, _pierceCount, cờ; bật lại collider
   SetupLinear()        -> rb.linearVelocity = forward * Speed
   Invoke("Destroy", t)
        |
        v (va chạm)
Bullet.OnTriggerEnter(other)
   dedup theo _hitIds
   hitPos = other.ClosestPoint(rewound position)
   switch (gunType) -> HitSingle | HitLaser | HitPierce | HitExplosive | HitBlastSniper
        |
        v
Gamemanager.Damage_Collider(coll, Damage, hitPos, Damage_str, is_Cri)
   -> Damage_Tag(coll, Damage)
        -> coll.GetComponent<EnemyColl>().enemyScript   (Enemy)
        -> tag "Enemy" ? Enemy.Damaged(Damage)
         : tag "Ore"   ? Enemy.Damaged((InfVal)1)
         : false
   -> nếu trúng: is_Cri ? Critical_Txt_Spawn(str, pos) : Damage_Txt_Spawn(str, pos)
        |
        v
Enemy.Damaged -> Health_Now -= Damage
              -> (Monster) Apply_Knockback(Damage / Health_Max)
              -> Slider_Reload()
              -> Health_Now <= 0 ? Die() : _bounce.Bounce_Start()
Enemy.Die     -> Gamemanager.Get_Money(Money, transform.position)
              -> Die_Reload()  (dispatch theo Enemy.Type)

Điểm kiến trúc quan trọng: Bullet không bao giờ gọi Enemy.Damaged trực tiếp. Nó chỉ biết Collider. Toàn bộ "collider này là gì, nhận bao nhiêu damage" nằm ở một chỗ duy nhất (Damage_Tag). Nhờ vậy thêm một loại mục tiêu mới (Ore, Tree, Boss) không cần chạm vào code đạn.

3.2 Ngữ nghĩa từng GunType

Điều đáng học: 7 loại vũ khí, 5 handler, 1 class. Sự khác biệt không nằm ở prefab riêng hay class con — nó nằm ở một switch trên enum + vài field trạng thái (_hitIds, _pierceCount, _firstHitDone, explosionRadius). Đây là lý do pool 27 viên đạn phục vụ được cả game.

3.3 Missile — parabol tường minh

// L1 ANALYSIS — RVA 0x2B0816C
_msTimer += Time.deltaTime;
float t = Mathf.Clamp01(_msTimer / _msDuration);
float x = _msStart.x + (_msEnd.x - _msStart.x) * t;
float z = _msStart.z + (_msEnd.z - _msStart.z) * t;
float linearY = _msStart.y + t * (_msEnd.y - _msStart.y);
float y = linearY + (1f - t) * (t * (_msArcHeight * 4f));   // đỉnh tại t = 0.5
transform.position = new Vector3(x, y, z);
// hướng mũi theo vector di chuyển thực tế
Vector3 move = newPos - oldPos;
if (move.sqrMagnitude > 0.0001f) transform.forward = move.normalized;
LastPos = oldPos;                         // dùng làm điểm gốc tính hitPos
if (t >= 1f) { Explode(pos); SpawnFX(pos); DieAndWait(); }

Hệ số 4f là chuẩn hoá: (1-t)·t đạt cực đại 0.25 tại t = 0.5, nên ×4 khiến _msArcHeight đúng bằng độ cao đỉnh cung thực tế tính từ đường thẳng nối. Đây là cách viết parabol mà tham số có ý nghĩa vật lý trực tiếp — đáng chuẩn hoá vào framework.

Missile là isKinematic = true; đạn thẳng là isKinematic = false. Cùng một class, hai chế độ chuyển động, chọn bằng cờ _isMissile.

3.4 Điểm va chạm "tua ngược"

Vector3 basePoint = _isMissile
    ? LastPos                                                        // vị trí frame trước
    : transform.position - rb.linearVelocity * Time.fixedDeltaTime;  // lùi 1 bước vật lý
Vector3 hitPos = other.ClosestPoint(basePoint);

Với đạn nhanh, OnTriggerEnter được gọi khi đạn đã xuyên vào trong collider, nên transform.position nằm bên trong mục tiêu và VFX nổ ra ở giữa thân quái trông sai. Tua ngược đúng một bước rồi lấy ClosestPoint cho ra điểm trên bề mặt, phía đạn bay tới. Đây là một thủ thuật game-feel rẻ tiền và hiệu quả.

3.5 Bug is_gaming — vì sao nó quan trọng

Trong quá trình dựng lại, Enemy.Damaged và Enemy.Die ban đầu thiếu guard if (!Gamemanager.is_gaming) return;. Bug lộ ra khi đối chiếu chéo với Ore.Die_Reload (vốn có guard rõ ràng trong disasm). Đã sửa và ghi vào G132b.

Vì sao đây là bài học framework chứ không chỉ là một lỗi vặt:

• SOT chỉ có một scene duy nhất (Main.unity, 481 MB) chứa cả gameplay lẫn toàn bộ menu/popup. Quái, đạn và collider luôn tồn tại, kể cả khi người chơi đang mở shop.
• Không có "unload scene gameplay" để bảo vệ. Thứ duy nhất ngăn combat chạy trong menu là một cờ boolean toàn cục Gamemanager.is_gaming được kiểm tra ở từng entry-point.
• Thiếu một guard ⇒ quái vẫn ăn damage và vẫn rơi tiền khi người chơi đang ở menu ⇒ lỗi kinh tế im lặng, không crash, cực khó phát hiện qua smoke test.

Framework rút ra: khi kiến trúc là "một scene, mọi thứ luôn sống", cờ trạng thái game phải là một guard bắt buộc ở tầng framework (ví dụ một base class hoặc một IDamageable gate), không phải một dòng if mà mỗi lập trình viên phải nhớ chép vào.

3.6 Ore = 1 damage cố định

if (tag == "Enemy") { e.Damaged(Damage); return true; }
if (tag == "Ore")   { e.Damaged((InfVal)1); return true; }

Ore (1 000 instance trong scene) là mục tiêu đếm số lần đánh, không phải mục tiêu theo sức mạnh: máu 3 (skin 0) hoặc 5 (skin ≠ 0), mỗi lần trúng trừ đúng 1. Thưởng cũng tách khỏi Enemy: Ore.Spawn truyền Money = 0 cho Enemy và giữ _diaValue riêng — 1 dia (skin 0) hoặc 10 dia (skin ≠ 0), cấp khi chết; tham số int skinNum thực chất là boolean (G343). Nghĩa là tốc độ đào phụ thuộc tốc độ bắn, không phụ thuộc damage. Đây là một cần gạt tuning riêng, cố ý tách khỏi chuỗi multiplier damage — một mẫu hay cho tài nguyên phụ trong idle (chống việc một stat làm phẳng mọi thứ).

4. Framework takeaway

1. Một Projectile duy nhất + enum dispatch, thay vì cây kế thừa. Trạng thái riêng của từng ngữ nghĩa nằm gọn trong vài field; ResetState() phải xoá tất cả chúng khi lấy từ pool. Đây là hợp đồng quan trọng nhất của pooling: một object tái sử dụng phải trở về trạng thái xuất xưởng, không được mang theo _hitIds của lần bắn trước.

2. Tách "va chạm" khỏi "sát thương". IProjectile -> chỉ biết Collider và điểm va chạm IDamageRouter-> biết Collider nào là gì, và bao nhiêu damage IDamageable -> biết mất máu thì làm gì Thêm loại mục tiêu = sửa router, không sửa đạn.

3. Dedup theo GetInstanceID() trong một HashSet là đủ và rẻ cho pierce + AoE. Dùng chung một tập cho cả OnTriggerEnter và OverlapSphere khiến vụ nổ không đánh trùng mục tiêu vừa bị đạn xuyên.

4. Chuẩn hoá điểm va chạm bằng rewind + ClosestPoint. Framework nên cung cấp sẵn ResolveHitPoint(collider, previousPosition).

5. Parabol tham số hoá theo độ cao đỉnh ((1-t)·t·h·4), vì designer nghĩ bằng "cung cao bao nhiêu", không nghĩ bằng hệ số bậc hai.

6. Guard trạng thái game phải ở tầng framework. Trong kiến trúc một-scene, đây là lớp phòng thủ duy nhất giữa gameplay và menu.

7. Đừng suy ra hot path từ tên class. BulletShooter nghe như trái tim của game và có 0 lần gọi; Bullet chạy 14 199 lần. Runtime ranking là oracle, tên là phỏng đoán.

5. Negative evidence & UNKNOWN

6. Raw evidence

• [evidence codegen: README.md], Bullet.cs} — dựng lại đủ 22 method
• [evidence codegen: combat_damage.cs.evidence] — Damage_Collider × 2 + Damage_Tag
• [disasm: Bullet.asm], Bullet_Update.c, Bullet_Update.decompiled.c}
• [disasm: Bullet.c], Bullet_fixed.c, Enemy.c}
• [reconstructed: Enemy.cs], EnemyColl.cs, Bullet_Mesh.cs, Gun.cs, BulletShooter.cs}
• [evidence codegen: rule_statics.cs.evidence] — enum GunType đầy đủ
• [runtime trace: runtime_ranking.json] — 505 method đã chạy, kèm số lần
• Gaps: G124, G130, G132b, G133, G134 trong gap list (nội bộ)