07 — Juice & game feel

Nguồn framework: docs/framework/06-juice-game-feel.md toàn bộ; docs/framework/01-economy-money.md §3.5.1 (chữ HOA / chữ thường của đơn vị). 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 game idle "đã tay" — quái nảy khi trúng đạn, panel bật ra có độ nảy, số sát thương vỡ tung, thanh máu chạy mượt mà không giết frame-rate — thì làm theo cách CatGunner đã làm: nhiều component nhỏ (~20 dòng mỗi cái) gắn ở rất nhiều chỗ, chứ không phải một hệ thống animation lớn. Bằng chứng đo được: 1 939 component nảy trong scene, 169 246 lời gọi cho riêng class vẽ thanh máu trong 40 giây. Trang này liệt kê từng kỹ thuật, kèm hằng số thật, và chỉ rõ cái nào rẻ, cái nào đắt.

Game gốc làm gì

Luật game feel đọc trọn từ binary (đợt 12, G410 — chủ đề ưu tiên của user)

Tám hệ nhỏ làm nên cảm giác "đã tay" của game — tất cả đều đã dựng lại và chạy trên bản học; giá trị là của game gốc:

Điều đáng học nhất là dòng cuối: một game idle thương mại "đã tay" mà không dùng camera shake hay hit-stop. Toàn bộ cảm giác đến từ squash 0.2 s + số bay + hạt + âm thanh có volume theo hàng + rung đúng một chỗ. Nếu framework của bạn thêm shake/hit-stop, đó là lựa chọn của bạn — không phải "chuẩn" của thể loại. Ngược lại, hai thứ bắt buộc mà bản dựng lại từng thiếu và game câm lặng: FXThrottle trả false ⇒ không FX trúng nào; CanSpawnText trả false ⇒ không số bay nào — hai stub im lặng giết "đã tay" mà không ném gì.

Công thức / pseudocode

Nảy trúng đòn (Bounce_Custom) — L1 ANALYSIS, RVA 0x2A694AC / 0x2A69650:

// .ctor: _upSizeTime = 0.2f; mysize = Vector3.one      (RVA 0x2A695D8)
// Awake -> Size_reload(): HalfTime = _upSizeTime * 0.5f  (RVA 0x2A6942C)
// OnEnable: Bouncing = false; localScale = mysize         (RVA 0x2A6947C)

public void Bounce_Start()                                 // RVA 0x2A69540
{
    time = 0f;
    if (Bouncing) return;                                  // đang nảy -> CHỈ reset đồng hồ
    if (gameObject.activeInHierarchy) StartCoroutine(Coroutine_NoRepeat());
}

while (Bouncing)
{
    yield return null;
    time += Time.deltaTime;
    if (time <= HalfTime)
        transform.localScale = Vector3.Lerp(mysize, WantSize, time / HalfTime);
    else if (time <= _upSizeTime)
        transform.localScale = Vector3.Lerp(WantSize, mysize, (time - HalfTime) / HalfTime);
    else { time = 0f; Bouncing = false; transform.localScale = mysize; }
}

Pop-in (BounceStart) — L1 ANALYSIS, RVA 0x2A68DB4 / 0x2A68E24:

_upSizeTime = 0.3 s, Middle_value = 0.6, WantSize = 1.1
First_Time  = 0.3 * 0.6  = 0.18 s   scale 0.001 -> 1.1   (vọt lên, 60 % thời gian)
Second_Time = 0.3 - 0.18 = 0.12 s   scale 1.1   -> 1.0   (lắng xuống, 40 % thời gian)
khởi động ở OnEnable

Thanh máu rẻ (SpriteFill) — L1 ANALYSIS, RVA 0x2A52BF4, runtime-verified:

public void Value_Reload(float value)
{
    if (_sprite == null) _sprite = GetComponent<SpriteRenderer>();   // fallback trước Awake
    if (_sprite != null) _sprite.color = new Color(value, 1f, 1f, 1f); // tỉ lệ máu vào kênh ĐỎ
}
// shader đọc color.r và cắt sprite — không mesh, không Canvas bẩn, không layout

Throttle text theo ô lưới (Gamemanager) — hằng số metadata-proven, thân CanSpawnText đã dựng (G402):

static readonly Dictionary<Vector2Int, float> _textCooldowns;   // dump.cs:583820
const float BUCKET_SIZE            = 1.5f;
const float DAMAGE_TEXT_COOLDOWN   = 0.12f;
const float CRITICAL_TEXT_COOLDOWN = 0.12f;
const float MONEY_TEXT_COOLDOWN    = 0.2f;
static bool CanSpawnText(Vector3 worldPos, float cooldown);      // RVA 0x2A507F4 — G402: key = Vector2Int(Math.Round(x/1.5), Math.Round(y/1.5)); z bỏ; đóng dấu Time.time
IEnumerator CleanupTextCooldowns();                              // dọn ô cũ, chống rò rỉ

Nướng đường cong (DamageTextAnimationCurve) — metadata-proven, dump.cs:584171:

public AnimationCurve movementX, movementY, alpha, scale;   // designer chỉnh trong Editor
public const int BAKE_SAMPLES = 64;
public bool baked;
public float[] bakedMovementX, bakedMovementY, bakedAlpha, bakedScale;
public void Bake();                                          // nướng một lần
public static float EvalBaked(float[] baked, float t);      // tra bảng + nội suy tuyến tính

Knockback — L1 ANALYSIS, Enemy.Damaged RVA 0x2AFEF9C:

if (_type == Type.Monster)
{
    float damageRatio = (float)(Damage / Health_Max);   // chia cho Health_MAX, không phải Health_Now
    Monster m = GetComponent<Monster>();
    if (m != null) m.Apply_Knockback(damageRatio);      // huỷ _knockbackCoroutine cũ trước
}

Chuyển động nền — L1 ANALYSIS, Scrolling RVA 0x2AD4EB0, Hatch RVA 0x2AD49A4:

// Scrolling: nền cuộn vô hạn, chỉ đổi uvRect
Rect r = img.uvRect;
img.uvRect = new Rect(r.x + Speed.x * Time.deltaTime, r.y + Speed.y * Time.deltaTime, r.width, r.height);
// Hatch: mật độ hoa văn không đổi theo pixel dù RectTransform to nhỏ khác nhau
img.uvRect = new Rect(0f, 0f, rect.rect.width / Hatch_Size, rect.rect.height / Hatch_Size);
// Follow: cố tình KHÔNG lerp — thanh máu trên đầu quái phải dính chặt
private void Update() { transform.position = Target_trans.position; }

Gợi ý framework (không phải bằng chứng SOT): một interface IProgressBar.SetValue(float) với hai hiện thực (vertex-color rẻ / 9-slice đắt); kiểu HysteresisThreshold; giữ AnimationCurve cho Editor và float[N] cho runtime.

Bẫy đã gặp

• Xếp chồng nảy. Nếu Bounce_Start không thoát sớm khi đang nảy, bắn liên thanh sẽ tạo nhiều coroutine tranh nhau ghi localScale. SOT chỉ reset đồng hồ (time = 0 rồi return) — disasm-proven RVA 0x2A69540.
• Object từ pool mang scale dở dang. OnEnable phải reset về mysize (RVA 0x2A6947C). Đây là hợp đồng pooling (xem 09-vfx-pooling.md) áp dụng cho juice.
• Dùng một giải pháp thanh máu cho mọi chỗ. SlicedFilledImage dựng lại tessellation 9-slice mỗi lần fillAmount đổi (31 620 GenerateFilledSprite, 4 739 OnPopulateMesh trong 40 s). Dùng nó cho 1 931 quái là tự sát về hiệu năng; SOT chỉ dùng cho 93 thanh UI. G126/G128.
• Hand-reconstruct SlicedFilledImage. Nó là source MIT thượng nguồn — per R2 phải lấy từ upstream, không dựng lại tay 44 method (G128).
• Knockback chia cho Health_Now. Quái sắp chết sẽ bị bắn văng kỳ quặc. SOT chia cho Health_Max (RVA 0x2AFEF9C).
• Throttle text theo đối tượng thay vì theo vùng màn hình. Vấn đề thị giác là mật độ text trong một vùng, nên SOT băm theo ô lưới BUCKET_SIZE = 1.5. Không có coroutine dọn dẹp thì dictionary rò rỉ một entry mỗi ô người chơi từng đi qua.
• Gọi AnimationCurve.Evaluate() trên hot path. Hàng chục text × 4 curve × mỗi frame xuất hiện trong profiler; SOT nướng 64 mẫu và tra bảng.
• Giả định một formatter duy nhất. Ảnh chụp save thật cho thấy 3.12A (world) và 3.12a (HUD) cho cùng giá trị; đường code viết HOA là UNKNOWN-pending (doc 01 §3.5.1). Một bản restore chỉ dùng InfVal_change() sẽ hiển thị sai kiểu chữ ở text bay.
• Mang 4 file .ttf 0 byte vào project. [SOT: DevXProject] từng ghi 4 font rỗng — đó là file bịa; SOT thật sự ship m_FontData độ dài 0 (G012).
• Làm mượt thứ phải dính chặt. Follow gán cứng vị trí; bất kỳ lerp nào trên thanh máu đầu quái trông như lỗi.

Checklist khi tự làm

• [ ] Có một component squash-stretch nhỏ (upSizeTime, wantSize: Vector3) với quy tắc "đang nảy thì chỉ reset đồng hồ".
• [ ] OnEnable của mọi component juice reset về trạng thái xuất xưởng (pool contract).
• [ ] Bốn biến thể riêng cho bốn ngữ cảnh: trúng đòn / pop-in / chạm nút / theo vị trí — không có component "làm tất cả".
• [ ] Pop-in chia cửa sổ không đều (60/40) và xuất phát từ 0.001, không phải 0.
• [ ] Hai tầng thanh tiến độ: vertex-color cho hàng nghìn mục tiêu trong thế giới, 9-slice mesh cho vài chục thanh UI.
• [ ] Boss có thanh riêng (máu + thời gian), không đi chung đường với quái thường.
• [ ] Text nổi: throttle theo ô lưới không gian, cooldown riêng theo loại text, có coroutine dọn dẹp.
• [ ] AnimationCurve được nướng thành float[64] với cờ baked; chỉ nướng một lần.
• [ ] Chữ số bay tản ra hai bên (DistributeMovementX) + spriteGap.
• [ ] Knockback = damage / maxHealth; lưu handle coroutine để huỷ cái cũ.
• [ ] Nền chuyển động bằng uvRect; hoa văn chia kích thước cho hằng số để mật độ không đổi.
• [ ] Thứ phải dính chặt thì gán cứng, không lerp.
• [ ] Nếu có hai kiểu chữ đơn vị (HOA/thường), khai báo tường minh đường nào dùng kiểu nào và có test parity.

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

• Tween mỗi frame của Bounce_Custom.Coroutine_NoRepeat: đã chạy (3 997×), giá trị localScale từng frame CHƯA đối chiếu. Khoá bằng oracle đọc localScale sau mỗi frame trong một chu kỳ nảy (doc 06 §5).
• BounceStart.Coroutine_NoRepeat: disasm-proven, chưa quan sát chạy trong cửa sổ trace. Khoá bằng cách mở/đóng panel có BounceStart khi đang hook.
• SlicedFilledImage (44 method): CỐ Ý KHÔNG dựng lại tay (G128, R2) — lấy từ upstream MIT.
• Boss_Slider.Value_Reload / Time_Reload: CHƯA dựng lại — chặn bởi khoảng cách version InfVal (G007a).
• DamageTextAnimation.InitDamageTextAnimation / DistributeMovementX: CHƯA dựng lại — chữ ký + mặc định (400 / -400 / 0 / 1) đã biết; thân thì chưa (RVA 0x2A52FC0 / 0x2A5304C).
• DamageTextObject: UNKNOWN — kiểu tham số, chưa trích.
• ~~CanSpawnText~~: ĐÃ DỰNG (G402) — băm Math.Round(x/1.5), Math.Round(y/1.5) (X/Y, làm tròn ngân hàng, không Floor, z bỏ). Stub return false của nó từng tắt mọi số bay.
• Monster.Knockback_Coroutine (RVA 0x2AF7DE8): CHƯA dựng lại — đường cong / khoảng cách / thời gian UNKNOWN.
• Giá trị WantSize thực tế của 1 939 Bounce_Custom: UNKNOWN — dữ liệu inspector trong Main.unity, chưa trích; mặc định .ctor là (0,0,0) nên mọi instance phải được đặt trong scene.
• Đường code viết HOA đơn vị ở text bay (3.12A) vs thường ở HUD (3.12a): UNKNOWN-pending — hiện tượng xác nhận bằng ảnh chụp; ứng viên Damage_Txt_Spawn 0x2A50594, Critical_Txt_Spawn 0x2A506AC, Money_Txt_Spawn 0x2A4EF48, hoặc .ToUpper() trong DamageTextAnimation. Tiêu chí nhiều khả năng là "text bay trong thế giới vs text HUD" — vẫn là suy luận (doc 01 §3.5.1; backlog T401).
• Không quan sát thấy DOTween trong các class juice đã dựng lại — mọi tween là coroutine viết tay, dù DOTween Pro có trong build. Nơi DOTween thực sự được dùng: UNKNOWN.
• Không quan sát thấy screen-shake, hit-stop hay time-scale trong các class đã khảo sát. Nếu có, chúng nằm ở nơi chưa khảo sát (cần grep Time.timeScale trong dump.cs).

Đọc thêm

• docs/framework/06-juice-game-feel.md — nguồn chính, đầy đủ RVA và số lần gọi
• docs/framework/01-economy-money.md §3.5 — notation hiển thị và phát hiện HOA/thường
• docs/framework/03-particles-vfx.md §3.4 — hợp đồng pooling mà juice phải tuân
• docs/framework/02-combat-projectiles.md — nơi Enemy.Damaged gọi Bounce_Start và knockback
• gap list (nội bộ) — G007a, G012, G126, G128