02 — Animation & Pixel Pipeline (pixelfx)

1Mục tiêu & thước đo chất lượng

Module rủi ro cao nhất: ~480 clip anh hùng + ~770 clip địch/Thủ Vệ/Boss + ~190 VFX, không có họa sĩ animation. Mục tiêu: đòn đọc được ở 1×, đúng nhịp từng tick, sản xuất bằng dữ liệu.

2Khóa tỉ lệ (scale lock)

2.1 Hằng số

Một pixel nghệ thuật (art px) = 1 px pixelfx = 1/16 unit Unity. Không bao giờ xoay sprite góc lẻ, scale lẻ, hay đặt vị trí lẻ khi hiển thị: mô phỏng dùng float, renderer làm tròn vị trí về art px nguyên (Mathf.Round, đối xứng khi lật) ngay trước khi vẽ. Lật trái/phải = flipX của SpriteRenderer với pivot đã bù nửa pixel (pivot X là số nguyên → lật quanh cạnh pixel, không lệch 1 px).

2.2 Hiển thị thế giới theo thiết bị

Camera thế giới = URP Pixel Perfect Camera (ref 270×480, PPU 16, upscaleRT = true, pixelSnapping = true, cropFrame = None). Quy tắc chọn hệ số:

k = min(⌊W / 270⌋, ⌊H / 480⌋)
nếu k ≥ 3 và W / k ≤ 384  → chế độ NGUYÊN: render target (⌊W/k⌋ × ⌊H/k⌋), phóng ×k
ngược lại                  → chế độ LẺ: kf = min(W/270, H/480), render target (W/kf × H/kf), phóng point-filter

Chiều cao dư (máy dài) → thêm vùng trên trần (vòm tối, thạch nhũ) và mặt sàn trước; bề rộng dư (iPad) → thấy thêm phòng, tối đa 384 px (phòng 352 + 16 px tường ngoài mỗi bên — tile tường ngoài phải tồn tại). Sàn neo ở 66% khung chiến đấu (01 §2; khung chiến đấu = giữa dải HUD trên 176 và panel dưới 496 đơn vị canvas, 11 §3).

Công thức đặt camera: camY = floorY + (floorFromTop_art − H_art/2) với floorFromTop_art = (floorCanvasY · s) / k. Camera bám x anh hùng (deadzone ±24 px), kẹp trong phòng; nâng y khi anh hùng y > 72 px: +0.5 × (y − 72), tối đa +40 px (combo trên không cao). Mọi giá trị camera làm tròn art px.

2.3 Cell, pivot, kích thước nhân vật

• Sprite không dùng cell lưới cố định khi ship: mỗi khung được trim theo bounding box + 1 px đệm, pack MaxRects (§3.5), pivot = gót chân (feet origin) riêng từng khung. "Cell" dưới đây là khung tham chiếu khi dựng act (meta.size) và trần kích thước cho ds-check.
• Thân anh hùng ≈ 24×38 (stock actor actor: 2); Brann scale 1.08 (≈ 41 px). Vũ khí dài cần canvas đòn rộng: giáo, lưỡi hái, liềm xích.

2.4 Luật pixel bắt buộc (hub §1, §3, §4, §7)

1. Một cỡ pixel trên mọi màn hình; zoom chỉ 1× hoặc 2× nguyên (Tuyệt Sát/Tuyệt Kỹ crop quanh điểm va).
2. Viền ink #0b0a10 1 px (nhân vật, đạo cụ, icon); VFX không viền (lines + light).
3. Ramp vật liệu 4 tông từ PAL (sáng → tối); ánh sáng trên-trái; trắng chỉ cho lõi nóng / lóe 1–2 khung.
4. Không anti-alias, không blur, không gradient mượt; dither Bayer 4×4 chỉ cho mờ dần và mảng lớn.
5. Hiệu ứng không vẽ vào sprite thân (polish §3): vệt chém, tia lửa, khói là VFX riêng; trạng thái là shader + emblem (§6.5).
6. Hình dáng chính, ramp chính, vũ khí của anh hùng cố định (INV-04).

3Mở rộng pixelfx (module M1 — nhánh deepstair của submodule)

3.0 Nguyên tắc

• Làm trên nhánh deepstair của Tools/pixelfx (submodule), commit gốc ghim trong .gitmodules; không push upstream main khi chưa có dev. Rebase upstream mỗi quý; mọi patch core giữ tương thích ngược (gọi cũ không truyền costume → hình y như cũ, node tools/check.mjs toàn thư viện vẫn sạch).
• Chỉ sheet đã export vào Assets/; records/ gitignored. Contact sheet duyệt copy sang Design/ArtPrompts/Anim/<hero>/.
• Credit giữ nguyên: Hugo Duprez (MIT), Hollow Crown (MIT), Patch — vào màn Credits (11 §8). Font gallery/fonts/PatchPixel không bao giờ ship.

3.1 Patch src/core/rig.js (hook, không viết lại)

3.2 src/core/costume.js

Một costume = dữ liệu thuần (không random, tất định). Mỗi anh hùng/địch có src/fx/<owner>/_costume.js export COSTUME.

import { costume, hair, hood, helmet, cape, scarf, pauldron, PAL } from "../../core/costume.js";
export const COSTUME = costume({                // H01 theo concept art Heroes/H01.png
  id: "kai", scale: 1,
  materials: {                       // 4 tông: [sáng, mặt, bóng, tối] — chỉ số trong ramp PAL
    skin:  ["dust", 6, 5, 4, 3],  suit:  ["night", 5, 4, 3, 2],  cape:  ["blood", 5, 4, 3, 2],
    hair:  ["stone", 7, 6, 5, 4], armor: ["metal", 5, 4, 3, 2],  belt:  ["wood", 4, 3, 2, 1],
    steel: ["stone", 4, 3, 2, 1], grip:  ["blood", 3, 2, 1, 0],  // lưỡi thép đen; ánh đỏ 1 px dọc cạnh lấy tông sáng của cape
  },
  parts: { head: "hair", face: "skin", neck: "cape", chest: "suit", waist: "suit", pelvis: "suit",
           upperN: "suit", foreN: "armor", handN: "suit", upperF: "suit", foreF: "armor", handF: "suit",
           thighN: "suit", shinN: "armor", footN: "suit", thighF: "suit", shinF: "armor", footF: "suit" },
  zones: [{ part: "waist", band: [-1, 1], mat: "belt" }],       // thắt lưng da theo tọa độ local LY
  extras: [hair.long({ len: 8 }), pauldron({ side: "N", spikes: 3 }), cape({ len: 14, seg: 7, torn: true }),
           scarf({ len: 4, seg: 2, from: "neck", lag: 2 })],
  eyes: { c: "#a4a4b2", px: [[1, 0]] },
  weapon: { name: "katana", steel: "steel", gold: "armor", grip: "grip" }, offWeapon: { name: "saya" },
  ghost: ["blood", 5],               // màu dư ảnh (§6.6)
});

• Ánh xạ tông: rig cho tông 0–3 (sáng → tối, chi phía xa +1); paint đổi tông → ramp vật liệu. Mỗi vật liệu đúng 4 màu → costume ≤ 12 vật liệu × 4 + ink + seam + mắt ≤ 52 màu (giới hạn LUT 64 màu/anh hùng, 255/LUT Địa Tầng).
• Phụ kiện hình học (đều qua depth buffer → che khuất đúng khi xoay yaw):

• Động lực vải tất định: posed() không có trạng thái, nên vải đọc cw/cl từ pose. body-sheet.mjs tự điền: cw = clamp(−vx_root/120 − Δchest_x/6, −1, 1) với vận tốc root/ngực lấy trễ lag khung (áo choàng Kaito trễ 2 khung), cl = clamp(vy_root/200, −1, 1); khi đứng yên cw tắt dần ×0.5/khung. Cùng clip → cùng kết quả.
• Scale: địch nhỏ 0.85, to 1.25, Thủ Vệ 1.5–1.8, Boss 2.0–2.5 (§5). Viền 1 px giữ nguyên → mật độ pixel không đổi.

3.3 Vũ khí mới trong WEAPONS

Thép theo anh hùng (concept art): Kaito thép đen ánh đỏ (stone tối + blood), Aldric bạc + gold, Brann thép sáng (metal) + rãnh tối, Mora/Lyra/Sable thép đen + blood, Rook găng lava, Thủ Vệ pha lê (arcane/ice).

3.4 Trang Phục (skin) — tôn trọng INV-04

Không skin nào đổi hình dáng thân, vũ khí, ramp chính (palette.signature + vật liệu chính khóa trong costume gốc; ds-check so sánh).

3.5 tools/body-sheet.mjs — xuất thân nhân vật

node tools/body-sheet.mjs hero-kai [--clips kai-l1,kai-l2] [--out ../../Assets/ArtAsset/Characters/Heroes/H01_Kaito]

Vào: src/fx/hero-kai/_costume.js, _poses.js, _loco.js (export CLIPS = { idle: { poses, loop:true }, … }), mọi file đòn kai-*.js (export meta, act, create).

Thuật toán:

1. Mỗi clip lấy act.poses; mốc 0 của clip = khóa đầu (t0, thường âm). Lấy mẫu: tại mỗi khóa và mỗi bước 1/12 s sau khóa đó tới khóa kế (đúng nhịp poseAt của pixelfx: tay chân giữ bước 12 fps); khóa snap → giữ pose trước tới đúng khóa.
2. Thời lượng khung = round(t_next·60) − round(t·60) tick (cộng dồn, không trôi); tối thiểu 2 tick (khung "release" ngắn hơn 5 tick là hợp lệ — đó là cách đòn nhanh "giật").
3. Render posed(q, costume) tại chỗ (bỏ x, y): vị trí chân thuộc về root track, không nằm trong ảnh. Trên không giữ cờ air (rig không cắt chân dưới sàn).
4. Điền cw/cl (§3.2), ghost → cờ khung.
5. Gộp khung liền kề giống hệt (hash idx + kích thước) → cộng tick. Dedupe toàn anh hùng: khung trùng giữa các clip (GUARD đầu/cuối mọi đòn — INV-16) dùng chung một ô.
6. Trim + 1 px đệm trong suốt, pack MaxRects (không xoay, đệm 2 px giữa ô) vào trang 1024×1024 (tối đa 2048×1024). Quá 2 trang → lỗi, giảm khung.
7. Xuất <code>_body_p<N>.png R8 index (0 = trong suốt, 1 = ink, 2… = LUT), <code>_palette.png (RGBA32 256×N, hàng 0 = gốc, hàng skin palette kế tiếp), <code>.pxbody (JSON).

Socket mỗi khung (cho VFX, xích, túm, dư ảnh): handN, handF, weaponTip (cuối trục vũ khí), head, chest — từ skeleton(q), đổi về tọa độ feet-local, làm tròn px.

{ "owner": "H01", "costume": "kai", "ppu": 16, "pages": ["kai_body_p0.png", "kai_body_p1.png"], "palette": "kai_palette.png",
  "cells": [ { "id": 0, "page": 0, "x": 2, "y": 2, "w": 21, "h": 39, "ox": 9, "oy": 38 } ],
  "clips": { "KAI_L1": { "loop": false, "ticks": 22,
      "frames": [ { "cell": 0, "ticks": 5 }, { "cell": 7, "ticks": 3, "ghost": true }, { "cell": 8, "ticks": 4 } ],
      "root": [ [0, 0, 0, "smooth"], [8, 6, 0, "snap"], [22, 6, 0, "smooth"] ],
      "sockets": [ { "handN": [12, -21], "weaponTip": [30, -36], "head": [1, -36] } ] } } }

root = các khóa [tick, x, y, how] (y dương = lên trong Unity; exporter đổi dấu từ pixelfx); runtime nội suy cùng hàm ease của poseAt theo từng tick (chân mượt, tay chân nhảy bước 12 fps — đúng cách pixelfx diễn).

3.6 tools/move-export.mjs — xuất MoveClip (art) cho mỗi đòn

node tools/move-export.mjs hero-kai [--check-csv ../../GDD/Config/HeroHits.csv]

Mỗi file đòn → <move-id>.pxmove:

{ "id": "KAI_L1", "body": "KAI_L1", "ticks": 22, "windup": 7, "contact": null,
  "lock": [[4, 10]],
  "hits": [ { "t": 7, "freeze": 2, "shake": 0, "amp": 0, "push": 2.8, "skin": null } ],
  "cues": [ { "fx": "kai_slash_l", "t": 7, "until": null, "x": 6, "y": -22, "palette": "metal", "layer": "front",
              "flip": false, "angle": 0, "follow": "none" } ],
  "projectiles": [], "tethers": [], "sfx": [ { "id": "kai_slash_l", "t": 6 } ], "dust": [ { "t": 7, "x": 12, "n": 6 } ] }

Render cue: mỗi cặp (fx, palette, options) render đúng một lần bằng renderFrames (dedupe toàn dự án), xuất hai sheet: <name>@<pal>.png (buffer color, RGBA32 alpha thật) và <name>@<pal>_light.png (buffer light, RGB24 cộng) — thay cho sheet gộp của render.mjs --sheet (gộp chỉ đúng trên nền tối). Trim + pack như §3.5, JSON giữ meta.pixelfx (fps, loop, pivot, frames) + rect từng khung.

3.7 Công cụ phụ

4Quy ước biên đạo theo anh hùng

4.1 Thư mục

Tools/pixelfx/src/fx/hero-kai/
  _costume.js   COSTUME (§3.2)
  _poses.js     thư viện pose (§4.2)
  _loco.js      CLIPS: idle, run, hurt1, hurt2, knockdown, getup, death, victory, descent, intro + 6 clip phụ (§10)
  kai-l1.js     một file / MoveDef  (id KAI_L1 → kebab thường)
  kai-r01.js    (không có) — lộ trình là dữ liệu 01 §6.3, không có file art
  fx-slash-l.js VFX chữ ký: fx id "kai_slash_l" ↔ module "hero-kai/fx-slash-l"

Quy ước fx: trong hero_*.py, fx="melee/sword-slash" = effect catalog (recolor theo palette anh hùng), fx="kai_slash_l" = effect chữ ký trong thư mục anh hùng. sfx="kai_slash_l" → file sfx_kai_slash_l[_n].ogg (12 §9).

4.2 Thư viện pose (_poses.js)

Mỗi anh hùng ≥ 30 pose có tên; mọi đòn ghép từ thư viện (spread + ghi đè vài trường). Pose bắt buộc:

4.3 Luật nối đòn (INV-16)

1. Đòn mặt đất: khóa đầu và khóa cuối bằng đúng GUARD (chỉ x khác). ds-check so sâu mọi trường.
2. Pose tại cancel (từ MoveDef) phải ≈ GUARD (Q3): khóa GUARD cuối đặt ≤ cancel; đoạn [cancel, dur] chỉ là "lắng" trong GUARD. Vì đòn kế bắt đầu ở cancel, nếu bỏ luật này sẽ thấy pose giật.
3. Đòn AIR: đầu/cuối AIR_READY; đòn nhảy lên (move.dy > 0) đầu GUARD cuối AIR_READY; đòn đập xuống đầu AIR_READY cuối GUARD sau tiếp đất.
4. Cờ link trong MoveDef (đòn nối có chủ đích): miễn luật 1, nhưng cặp đòn được phép nối phải liệt kê trong _poses.js LINKS = [["VEX_A3", "VEX_A4"]] và pose cuối A ≡ pose đầu B.
5. Xoay: kết thúc ở yaw = k·2π; quay người (TURN) dùng flipX ở khung đầu, không xoay 180° bằng yaw.
6. Phản Đòn: khung đầu = khung contact của clip phòng thủ trước (cùng pose) → Phản Đòn "bật" ngay khung kế (01 §5.5).

4.4 Clip phòng thủ & contact

contact = DEFENSE_LEAD (0.15 s) cho mọi clip phòng thủ → bắt đầu clip ở t_commit thì khung chạm rơi đúng hit-frame địch (01 §5.1). Body-sheet đặt một khóa đúng tại 0.15 s nên khung contact bắt đầu đúng tick 9. Clip phòng thủ có thể bắt đầu từ bất kỳ pose nào (là phản xạ) — khung đầu là DEF_* đã giữ tư thế, không cần GUARD.

Clip địch dùng cùng cơ chế ngược lại: hits[0].t của đòn địch = hit-frame mà DefenseResolver nhắm; windup ≥ mức tối thiểu theo AttackKind (light 21 tick, heavy 36, thrust/sweep/grab 42, projectile 30, area 48 — 01 §11.3). ds-check từ chối nếu thiếu.

4.5 Thời gian: act → tick → MoveDef

• Act viết bằng giây (pixelfx); export đổi sang tick 60 Hz nguyên (round(t·60)). Mọi dữ liệu runtime là tick.
• HitDef.t (giây, hero_*.py) là thiết kế; act đặt khóa release sao cho hit rơi đúng. Lệch > 1 tick khi export → sửa act, hoặc sửa hero_*.py trong cùng task (không để hai nguồn lệch).
• AtkSpeed chia thời lượng mọi tick của clip (cả hit, root, cue) — runtime dùng bộ tích lũy phân số (§6.2), không làm tròn từng khung.
• Hit-stop không bake thành khung (pixelfx stop trong act chỉ để xem trước); runtime đóng băng đồng hồ actor (§6.3).

4.6 Ví dụ file đòn

// hero-kai/kai-l1.js — KAI_L1 Chém Ngang (L, dur 0.36, cancel 0.26, hit 0.12)
import { chain } from "../../core/index.js";
import { GUARD, WIND_LOW, CUT_MID, FOLLOW } from "./_poses.js";
import * as slash from "./fx-slash-l.js";
export const meta = { name: "KAI_L1", size: [112, 72], origin: [40, 64], duration: 0.36, fps: 30, actor: 2, costume: "kai" };
export const act = {
  target: { x: 30 },
  poses: [[-0.12, GUARD], [-0.04, WIND_LOW], [0, CUT_MID, "snap"], [0.06, FOLLOW, "snap"], [0.14, { ...GUARD, x: 6 }]],
  hits: [{ t: 0, stop: 0.033, shake: 0, amp: 0, push: 2 }],
  dust: [{ t: 0, x: 8, n: 4, dir: 1 }],
};
export const create = chain([{ fx: slash, t: -0.01, x: 6, y: -22, palette: "metal" }]);

Ở đây t0 = −0.12 → hit ở tick round(0.12·60) = 7 ↔ HitDef.t = 0.12 ✔; GUARD cuối ở 0.26 s tính từ t0 = cancel ✔.

5Địch, Thủ Vệ, Boss

5.1 Địch hình người — rig + costume

Lớp HUM-S/M/L (12 §4). Mỗi loại: src/fx/enemy-<id>/_costume.js (scale 0.85/1.0/1.25, vũ khí, ramp không trùng ramp chính anh hùng — INV-04), _poses.js riêng 15–20 pose, 3 đòn (atk-*.js), 4 loco (idle, walk, run, taunt), và thư viện phản ứng chung src/fx/_react/ (16 clip viết một lần trên pose tham số, render cho mọi costume):

flinch_hi, flinch_lo, stagger, launch_up, air_hit, air_fall, land_bounce, knockdown, getup, wallsplat, crumple, spin, broken (quỳ một gối, loop), offbalance, grabbed (paired), pulled (bị kéo — liềm xích/lưỡi hái), + 3 biến thể death (đứng, trên không, quỳ). Mọi clip phản ứng bắt đầu/kết thúc ở pose chung R_STAND để nối tự do; biến thể chọn tất định theo hash(actorId, hitIndex), không lặp 2 lần liền (chỉ hình ảnh).

5.2 Sinh vật — module dựa trên critters/*

Lớp CRT-S/M/L (dơi, chuột, slime, nấm, nhện, đốm hồn, sói xương…): module thuần draw(p, t, o) theo khuôn critters/bat, critters/slime, thêm tùy chọn o.state ∈ {idle, move, windup, attack, hurt, launch, die} và o.phase (0–1). creature-sheet.mjs render mỗi state ở 12 fps → cùng schema .pxbody (root = 0, chuyển động do runtime). Phản ứng rút gọn: hurt (nháy + lùi 1 px), launch (lộn 2 khung), die. Cánh/đuôi lặp seamless (cycle, loopNoise).

5.3 Thủ Vệ & Boss

• Rig phóng to (scale 1.5–2.5) + costume + vũ khí địch (§3.3 đợt 2): đa số Thủ Vệ, Gorrak, Valcor (costume không đầu + fire/spirit-flame recolor ở cổ), Nereth, Brakka, Morvane, Vua Rỗng (2 costume = 2 pha).
• Module riêng: Mẹ Bào Tử (thân nấm + 4 xúc tu spline), Hàn Long Skarn (đầu + cổ spline 16 đốt kiểu critters/snake + cánh 2 lớp), Song Tử Lăng Kính (2 rig ×1.6, costume pha lê + khúc xạ = VFX).
• Bóng Gương (BS09): dùng body-sheet + MoveClip của anh hùng đang chơi, LUT hàng mirror (thân PAL.shadow, mắt PAL.neon), dư ảnh tím — 0 sprite mới.
• Canvas đòn Boss ≤ 192×144, cao ≤ 96 px (hub §4). Đòn Boss có phase (1/2) và cờ armor (siêu giáp) hiển thị bằng viền shader trắng 1 px nhấp nháy 2 khung khi bắt đầu armor.

5.4 Báo hiệu đòn trong sprite

Mỗi đòn địch có ≥ 2 khung lấy đà giữ (đọc được), silhouette lấy đà khác silhouette đứng. Nháy đỏ đòn heavy (2 khung/0.1 s #ff2040) và viền đỏ thẫm đòn không chặn được là shader (skin red, chế độ viền) do runtime bật theo AttackKind — không bake. Glyph "!" / mũi tên / sóng / bàn tay là sprite UI kit (11 §3.3), neo trên đầu theo socket head.

5.5 Đòn ghép đôi (túm, kéo)

Đòn có tag grab (Rook, Sable, Boss túm anh hùng): MoveClip có pair = { t0, t1, socket: "handN", victimClip: "grabbed", offset: [x, y], release: { vx, vy } }. Từ t0 nạn nhân bám socket của kẻ túm theo từng khung (vị trí làm tròn px), phát grabbed; t1 → thả với vận tốc → phản ứng launch/knockback. Chỉ mục tiêu tgt:grab (01 §6.4).

6Unity runtime

6.1 Asset dữ liệu

Gameplay không đọc sprite; mô phỏng headless (INV-14) chỉ cần MoveDef + root/lock/hits của MoveClip (dữ liệu thuần, không Unity Object nặng) → MoveClipData struct tách khỏi phần sprite để autosim chạy không cần texture.

6.2 CombatClock & PixelClipPlayer

CombatClock (1 / trận):  acc += unscaledDt × gameSpeed(1|1.5|2|3) × globalSlowmo
                          while acc ≥ 1/60: acc −= 1/60; Tick()      // tối đa 8 tick/frame, phần dư dồn
Tick(): với mỗi actor:   if freezeTicks > 0 → freezeTicks−−; continue     // hit-stop cục bộ
                          clip.Advance(rate = AtkSpeed (đòn tấn công) | 1 (loco, phản ứng))
PixelClipPlayer.Advance:  pos += rate × 1000   (đơn vị 1/1000 tick, số nguyên)
                          while pos ≥ frameEnd[i]: i++ ; bắn sự kiện có tick ∈ (prev, now] theo thứ tự
                          root = EvalRoot(pos)  ; sprite đổi chỉ khi i đổi

• Sự kiện (hit, cue, sfx, projectile, tether, pair, lock in/out) bắn theo thứ tự tick, kể cả khi một frame Unity chứa nhiều tick (x3) → không mất hit (01 §19).
• Vị trí hiển thị = vị trí mô phỏng ở tick cuối, làm tròn art px; không nội suy giữa tick (pixel art cần dừng gọn).
• Pin tiết kiệm (11 §8): render 30 fps, mô phỏng vẫn 60 Hz (2 tick/frame).

6.3 Hit-stop, slow-mo, tốc độ

6.4 Camera

Rung = offset nguyên art px theo công thức pixelfx (act.shake) với amp của hit (hoặc lớp hit 01 §12.1), cộng camera punch 2 px theo hướng đòn trong 2 tick ở hit H/F/K; Giảm nhấp nháy → biên độ ×0.5 (làm tròn xuống), cài đặt cường độ rung 0–100% (11 §8). Zoom 2×: Pixel Perfect Camera đổi refResolution sang 135×240 quanh điểm va (tâm kẹp trong phòng), vào/ra trong 1 tick (cắt cảnh, không zoom mượt — pixel không zoom lẻ).

6.5 Shader & mã hóa per-instance

Để giữ batching (không dùng MaterialPropertyBlock), tham số mỗi actor đi qua SpriteRenderer.color (vertex color 8-bit):

• Skin trúng đòn (2–6 khung, toàn thân): char (hỏa), shock (lôi), ice (băng), holy, shadow, poison — đúng bảng SKINS của pixelfx.
• Trạng thái kéo dài (Bỏng, Độc, Ám Ấn…): chỉ đổi màu viền + emblem nhỏ gắn đầu/chân (polish §4: không tô cả thân). Ngoại lệ có nghĩa: Đóng Băng = skin ice toàn thân + khối băng VFX.
• Viền Tinh Anh theo affix và viền Vỡ Thế (trắng nhấp nháy) dùng chế độ "chỉ viền".

6.6 Dư ảnh

Pool 3 SpriteRenderer/actor (Low tier: tắt). Khi khung có cờ ghost (hoặc Dòng Chảy, Thức Tỉnh), mỗi 2 tick chụp sprite + vị trí hiện tại vào bản cũ nhất; sống 0.16 s (pixelfx GHOST_LIFE), độ sáng bậc 0.5 → 0.33 → 0.17; màu = costume.ghost; lớp FxBack (sau thân — anh hùng luôn sắc nét trước dư ảnh của mình).

6.7 Lớp & thứ tự vẽ

UI canvas (Screen Space – Camera) nằm trên tất cả.

6.8 VFX player & pool

PixelVfx = 2 SpriteRenderer (màu + sáng) + chỉ số khung, chạy theo CombatClock (hoặc unscaled cho UI). Pool theo VfxSheet (PoolingManager), prewarm ở FloorIntro: số instance = tần suất cue tối đa trong 1 s của Cây Combo hiện tại (tính khi nhận Hồi Âm) + 2. Trần đồng thời: 48 VFX High / 32 Mid / 20 Low; vượt → bỏ cue cấp thấp nhất (bụi < tia lửa < vệt chém < hit chính, không bao giờ bỏ VFX phòng thủ).

6.9 Xích & đạn

ChainLine (Sable, móc lưỡi hái Mora): vẽ mắt xích sprite 3×2 (px_chain_link, xen ngang/dọc) theo đường Bresenham từ socket tay tới đầu liềm/tạ, võng bậc 2 theo slack (giảm dần khi căng), tối đa 112 px, mỗi tick tính lại từ dữ liệu tethers — không physics. Đạn: sprite VFX loop + hitbox tròn từ projectiles, bay tuyến tính/parabol (g = 950 px/s²), pool theo id.

7Import pipeline

Thư mục: Characters/Heroes/H01_Kaito/{kai_body_p0.png, kai_palette.png, kai.pxbody, Moves/*.pxmove} · Characters/Enemies/<S0x>/<EN..>/ · Characters/Bosses/<BS..|WD..>/ · Vfx/Pixel/<category>/<name>@<pal>[_light].png · Vfx/Pixel/Hero/<code>/ · Environment/<S0x>/ · UIPixel/Combat/ (chữ chiến đấu, số, glyph).

8Atlas, bộ nhớ, Addressables

• Thân: body-sheet đã pack sẵn trang R8 → không đưa vào SpriteAtlas Unity (atlas sẽ ép RGBA32). 1 trang = 1 MB (1024²).
• VFX / môi trường / UI: SpriteAtlas V2, ≤ 2048², padding 2, không xoay, không tight packing, Full Rect; atlas màu RGBA32 và atlas sáng RGB24 tách riêng.
• Compression None là luật hub (pixel không chịu nén); tiết kiệm bằng R8 index, trim, dedupe, nạp theo Địa Tầng.

9Ngân sách khung & kích thước theo loại đòn

Khung = khung duy nhất sau gộp. Canvas = trần bounding box một khung (trim thật thường nhỏ hơn 40–60%).

Quy tắc thêm: khung release 2–3 tick (đòn L/M), giữ lấy đà ≥ 2 bước 12 fps cho H/F; ULT/EXEC chia "shot" — mỗi shot ≤ 8 khung, giữa shot cắt bằng VFX màn hình hoặc zoom 2× (không cần pose trung gian).

10Số lượng asset theo anh hùng

Đếm từ hero_*.py (cột Nguồn = data) hoặc kế hoạch 03 §2 (plan) khi chương anh hùng chưa có dữ liệu. Clip phụ (6/anh hùng, không phải MoveDef): camp_idle, parried (bị địch gạt, 01 §5.9), guard_break, grabbed, downed, revive + pose PORTRAIT.

File act = MoveDef không phải LOCO + _poses.js, _loco.js, _costume.js. Icon Hồi Âm động = Hồi Âm riêng COMBO/TECH/SKILL/ART/EVO (06 §9) → echo-icon.mjs, 0 chi phí AI.

11Cổng duyệt

Mỗi commit thêm clip kèm đường dẫn contact sheet trong Design/ArtPrompts/Anim/<owner>/ (thiếu → không merge).

12Đặt tên

13Năng suất & lịch sản xuất

Chạy 3 agent song song → ~12 tuần lịch; vertical slice (Kaito, Aldric, 6 địch, Gorrak, Valcor ≈ 300 clip + 40 VFX) ≈ 4 tuần sau M1. Thứ tự: M1 công cụ → Kaito trọn bộ (khóa chất lượng, G2 + G4) → Aldric → địch S01–S02 → BS01/BS02 → còn lại theo Địa Tầng.

14Rủi ro

15QA checklist

• [ ] ds-check sạch cho mọi owner; check.mjs toàn thư viện sạch sau patch core.
• [ ] Mọi MoveClip: hit trùng HeroHits.csv ±1 tick; contact phòng thủ = 9 tick; pose tại cancel ≈ GUARD.
• [ ] PixelLab x3: số hit hiển thị = số hit log (INV-05); defense_contact_error_ticks = 0.
• [ ] Không sprite nào có màu ngoài LUT; viền ink kín; 0 pixel đơn lẻ.
• [ ] Đổi skin palette không đổi sprite; skin costume không đổi thân/vũ khí/ramp chính (INV-04).
• [ ] Texture trong run ≤ ngân sách §8 ở từng tier (Memory Profiler, B1/B50/B100).
• [ ] Lật trái/phải không lệch 1 px; zoom 2× không có pixel lẻ.
• [ ] Hit-stop: chỉ attacker + nạn nhân đứng; VFX của hit giữ khung 0 suốt freeze.
• [ ] Dư ảnh luôn sau thân anh hùng; Low tier không tạo dư ảnh/trang sáng.
• [ ] Bóng Gương dùng đúng sprite anh hùng đang chơi với LUT mirror.