sprite-stacking là một agent skill mã nguồn mở của Daniel White. Nó biến bốn góc nhìn pixel art của một vật thể (trên, cạnh, trước và sau) thành một "sprite stack": một dải các lớp phẳng mà game vẽ chồng lên nhau để giả lập một vật thể 3D có thể xoay. Skill chạy được với Claude Code, Codex, Cursor, OpenCode, Gemini CLI và Pi. Repo được tạo ngày 20/11/2026 và có 187 sao khi chúng tôi kiểm tra ngày 21/11/2026. Giấy phép MIT.

Bài hướng dẫn này nói về sprite stacking là gì, skill thêm được gì, cách cài, cần đưa vào những gì và nó còn hạn chế ở đâu. Mọi lệnh bên dưới đều được chép từ README của repo hoặc từ file SKILL.md. Chúng tôi đọc các file vào ngày 21/11/2026 nhưng chưa tự chạy skill, nên kết quả mô tả ở đây là những gì tài liệu nói sẽ xảy ra.

Sprite stacking là gì

Sprite stack là một vật thể nhìn từ trên xuống, được cắt thành các lớp nằm ngang, giống một ổ bánh mì thái từ dưới sàn lên. Game vẽ các lớp từ dưới lên trên. Mỗi lớp được xoay cùng một góc, ép dẹt theo chiều dọc cho khớp với góc nghiêng của camera, và nâng cao hơn lớp trước 1 pixel. Kết quả trông như một mô hình voxel nhỏ xoay mượt mà, nhưng thực chất vẫn chỉ là vẽ 2D thông thường: không có engine 3D, không có mesh, và ở góc nào pixel cũng sắc nét.

README nói rõ kỹ thuật này không mới: "Sprite stacking is a long-standing indie game technique, not invented here." Thứ skill thêm vào là phần khắc từ bốn góc nhìn và một quy trình làm việc cho agent.

Phần mệt nhất thường là vẽ các lớp. Một chiếc xe 30 lớp là 30 tấm hình nhỏ phải khớp nhau. Skill bỏ qua bước đó: bạn (hoặc agent của bạn) vẽ bốn góc nhìn bình thường, rồi một script khắc ra các lớp từ đó.

Skill làm gì

README mô tả bốn bước:

  1. Góc nhìn: một tấm có góc nhìn trên, cạnh, trước và sau, chiếu trực giao, xếp trên một hàng.
  2. Khắc: một voxel chỉ được giữ lại ở chỗ cả bốn góc nhìn đều phủ lên.
  3. Lớp: khối đã khắc được cắt thành một dải các lớp phẳng, lớp mặt đất đầu tiên.
  4. Render: mỗi lớp được xoay, ép dẹt theo góc nghiêng và nâng lên 1 px.

Thư mục skill gồm:

  • SKILL.md: hướng dẫn mà agent đọc, gồm cách có một tấm bốn góc nhìn tốt, danh sách kiểm tra trước khi cắt, các flag của slicer, vòng lặp render và các thông số, danh sách "xong khi", và một bảng các lỗi từng gặp kèm cách sửa.
  • scripts/views_to_slices.py: slicer. Nó xóa nền, bỏ viền 1px quanh mỗi góc nhìn, gom mọi thứ về một bảng màu chung, khắc các lớp, và có thể xuất một ảnh kiểm tra cùng một trang xem độc lập.
  • scripts/viewer.html: trình xem trên trình duyệt, cũng mở được riêng và nhận các dải lớp được kéo thả vào.
  • references/engines.md: công thức ngắn cho web Canvas và React, Godot 4, Unity, và Phaser, Pygame hay bất cứ thứ gì khác.

Cài trong Claude Code hoặc Codex

Cách cài một dòng trong README dùng skills CLI, cần Node 22.20 trở lên:

npx skills add danielwh2/sprite-stacking

Lệnh này cài skill vào dự án hiện tại. Theo README, thêm -g để cài cho mọi dự án, và -a claude-code (hoặc codex, cursor, v.v.) để chọn agent.

Cách còn lại là chép thư mục skills/sprite-stacking từ repo vào thư mục skills của agent:

Agent Thư mục
Claude Code ~/.claude/skills/
Codex, Cursor, OpenCode, Gemini CLI, Pi ~/.agents/skills/

Slicer là một script Python, nên bạn cũng cần Python 3 với Pillow và NumPy. Lệnh trong README:

pip install pillow numpy

Cách dùng: nên nhờ agent điều gì

Bạn không cần gọi skill bằng tên. Sau khi cài, cứ nói điều bạn muốn và agent sẽ tự dùng nó. Các ví dụ trong README:

  • "Làm một chiếc xe pixel art xoay được."
  • "Làm sprite stack từ tấm 4 góc nhìn này và cho tôi một bản xoay bàn quay."
  • "Thêm một cái cây pixel art giả 3D vào game Godot của tôi."

SKILL.md bảo agent chọn hướng đi tùy vào thứ bạn đưa:

  • Một dải lớp PNG hoặc file xuất lớp từ MagicaVoxel: đi thẳng tới bước render.
  • Một tấm bốn góc nhìn: kiểm tra tấm, rồi khắc.
  • Chỉ có prompt hoặc ý tưởng: trước tiên tạo tấm bốn góc nhìn, rồi khắc và render.

Nếu bạn không có tấm nào, agent sẽ dùng công cụ tạo ảnh nếu có, với một prompt được viết sẵn trong SKILL.md. Nếu không có, nó tự vẽ bốn góc nhìn dưới dạng pixel art bằng một script Python ngắn. README nói đơn giản: "No image generator? The agent draws the views itself in a short Python script."

Trong một game có sẵn, SKILL.md bảo agent đọc phần render của bạn trước (engine, tỉ lệ pixel, cách vẽ và sắp xếp sprite) rồi đưa stack vào cho khớp, không bao giờ thêm canvas thứ hai hay pipeline render thứ hai.

Cần đầu vào gì

Tấm bốn góc nhìn có quy tắc chặt chẽ, và phần lớn kết quả xấu là do làm sai các quy tắc này. Theo SKILL.md:

  • Một hàng theo thứ tự TOP, SIDE, FRONT, BACK, trên nền trắng phẳng, có khoảng cách rõ giữa các góc nhìn.
  • TOP nhìn thẳng xuống, mặt trước của vật thể hướng xuống dưới. Ở SIDE, mặt trước hướng sang trái.
  • Hoàn toàn trực giao: không phối cảnh, không nghiêng, không góc 3/4.
  • Cùng tỉ lệ ở cả bốn góc nhìn: chiều dài TOP bằng chiều dài SIDE, chiều rộng TOP bằng chiều rộng FRONT và BACK, chiều cao SIDE bằng chiều cao FRONT và BACK.
  • Tô màu phẳng và viền sắc nét. Cạnh mềm kiểu airbrush và đường kẻ trong mảnh 1px sẽ bị nhòe khi các lớp xoay, và skill khuyên vẽ lại thay vì cố cứu.

Nó cũng đưa ra ba mức kích thước:

  • Chunky retro: 15–20 lớp, khoảng 25×48 px, hiển thị ở tỉ lệ 8–10×.
  • Detailed hi-bit: 26–44 lớp, từ 36×72 đến 46×107 px, đủ cho khe thông gió, logo và vành bánh có nan.
  • Showcase / video 1080p: 36–56 lớp, từ 30×30 đến 148×148 px, hiển thị ở tỉ lệ 4–6×.

Tự chạy slicer

Thường thì agent chạy slicer, nhưng bạn có thể tự chạy từ thư mục gốc của repo bằng lệnh trong README:

python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
  --slices 36 --preview check.png --html viewer.html

views.png là tấm bốn góc nhìn của bạn, còn slices.png là dải lớp mà nó xuất ra. Các flag README liệt kê:

  • --slices N: số lớp. 15–20 cho kiểu thô, 32–48 cho kiểu chi tiết.
  • --order reading: ép thứ tự TOP, SIDE, FRONT, BACK. Mặc định script ghép các góc nhìn theo tỉ lệ.
  • --round: khắc tháp, khinh khí cầu và chậu thành hình tròn thay vì vuông.
  • --side-nose right: dùng khi góc nhìn SIDE hướng sang phải.
  • --colours N: kích thước bảng màu chung; 0 giữ mọi màu.
  • --normals path.png: lưu thêm một dải lớp normal map tương ứng.
  • --emissive path.png: lưu thêm một mặt nạ phát sáng được phát hiện tự động (đèn pha, cửa sổ, neon).

SKILL.md liệt kê thêm vài flag nữa, trong đó có --top-nose (truyền down cho mọi thứ không phải xe cộ), --shade, --bg-tol và --dark-thresh.

check.png cho thấy bốn góc nhìn đã tách, bốn góc xoay và một góc nhìn tách lớp. Skill bảo agent xem ảnh này trước khi viết bất kỳ dòng code game nào.

Trình xem

--html xuất ra một trang độc lập. Theo README, nó có bàn quay, chế độ Scene với các đạo cụ sinh thủ tục, quét lớp, góc nhìn tách lớp, và chế độ Play để lái xe bằng WASD hoặc phím mũi tên. Ngoài ra còn có thời gian trong ngày, mặt trời kéo được kèm bóng đổ, mưa và tuyết, và một nút xuất ra sprite sheet PNG 16 hướng. Nút cuối này tiện nếu engine của bạn chỉ cần sprite theo hướng bình thường.

Đưa vào game

Vòng lặp render ở đâu cũng như nhau: với mỗi lớp từ mặt đất lên, xoay nó quanh tâm, nhân trục y với hệ số ép dẹt, nâng lên bằng chỉ số lớp nhân khoảng cách, làm tròn về pixel nguyên, rồi vẽ với lọc nearest-neighbour. SKILL.md đưa giá trị mặc định: khoảng cách 1.0 và ép dẹt 0.75 cho camera nhìn chéo từ trên xuống (1.0 là nhìn thẳng xuống). references/engines.md có sẵn một hàm Canvas 2D và một script Node2D cho Godot 4, cùng ghi chú cho Unity (mỗi lớp một SpriteRenderer, bộ lọc Point) và cho Phaser hay Pygame.

Hai mẹo từ skill quan trọng cho hiệu năng và hình ảnh. Sắp xếp cả stack theo điểm chạm đất và không bao giờ xen kẽ lớp của hai vật thể. Và "nướng" các stack tĩnh thành sprite thường khi game tải: skill chỉ ra rằng 200 cái cây, mỗi cây 30 lớp, sẽ là 6.000 lệnh vẽ mỗi khung hình.

Giới hạn

Các điểm này lấy từ danh sách kiểm tra của skill và bảng lỗi từng gặp:

  • Khoảng rỗng bị che sẽ bị lấp đầy. Bước khắc chỉ giữ phần mà cả bốn hình bóng đều phủ, nên thùng xe bán tải hay vòm rỗng mà không góc nhìn nào thấy sẽ ra đặc. Phần nhô ra mà nhìn từ cạnh thấy được khe sáng, như cánh gió sau nâng cao, thì vẫn giữ được. Khoảng rỗng phải sửa tay sau khi khắc.
  • Chi tiết tròn ra vuông, trừ khi góc nhìn trên có một hình tròn pixel, hoặc bạn truyền --round khi phần tròn hẹp hơn phần đế.
  • Chi tiết rộng 1px nhấp nháy khi stack xoay. Cột, dây thừng và ăng-ten cần rộng ít nhất 2px; slicer sẽ in cảnh báo.
  • Phần nhô ra thành gờ. Thứ gì chìa ra khỏi tường, như hộp hoa hay biển hiệu, sẽ khắc thành một cái gờ chạy dọc cả bức tường. Vẽ phẳng các chi tiết nhỏ.
  • Khe kín bị khắc đặc. Phần nền bị bao kín hoàn toàn bên trong một góc nhìn (giữa chân, vây hay dây) được coi là một phần của vật thể. Mọi khe hở phải thông ra mép ngoài của góc nhìn.
  • Vật thể lệch tâm sẽ lắc. Stack xoay quanh tâm khung bao của nó, nên hãy căn giữa vật thể trong các góc nhìn.
  • Chỉ dành cho pixel art. Kỹ thuật và slicer được làm cho sprite nhỏ, tô bóng phẳng. Đây không phải cách để có mô hình 3D thật cho game three.js hay Unity 3D.

Giấy phép

Repo dùng giấy phép MIT (copyright 2026 Daniel White), hiển thị trên GitHub và trong file LICENSE. Bạn có thể dùng, sửa và đưa vào dự án thương mại, miễn là giữ thông báo bản quyền và giấy phép đi kèm các bản sao của code. README không nói gì về giấy phép của những sprite bạn làm ra bằng nó.

Câu hỏi thường gặp

Sprite stacking là gì?

Một cách giả lập 3D trong game 2D. Vật thể được lưu dưới dạng một dải các lớp phẳng nhìn từ trên xuống, và game vẽ chúng từ dưới lên, mỗi lớp xoay cùng một góc và nâng lên 1 pixel. Nó trông như một mô hình voxel nhỏ đang xoay mà vẫn là pixel art sắc nét.

Skill sprite-stacking có miễn phí không?

Có. Đây là mã nguồn mở theo giấy phép MIT. Bạn chỉ cần Python 3 với Pillow và NumPy, cộng thêm Node 22.20 trở lên nếu cài bằng npx skills. Gói đăng ký hoặc chi phí API của AI agent là chuyện riêng.

Nó có chạy với Claude Code và Codex không?

Có. Cả hai đều được liệt kê trong README. Cài bằng npx skills add danielwh2/sprite-stacking (thêm -a claude-code hoặc -a codex để chọn agent), hoặc chép skills/sprite-stacking vào ~/.claude/skills/ cho Claude Code hay ~/.agents/skills/ cho Codex.

Tôi có cần công cụ tạo ảnh không?

Không. Nếu agent của bạn có, skill sẽ đưa cho nó một prompt để tạo tấm bốn góc nhìn. Nếu không, agent tự vẽ các góc nhìn bằng một script Python ngắn. Bạn cũng có thể đưa cho nó một tấm bạn tự vẽ, một dải lớp, hoặc file xuất lớp từ MagicaVoxel.

Tôi có dùng kết quả trong Godot, Unity hay Phaser được không?

Được. references/engines.md có script cho Godot 4, ghi chú cho Unity, một hàm Canvas 2D cho web và React, và vòng lặp chung cho Phaser và Pygame. Trình xem cũng xuất được sprite sheet PNG 16 hướng cho những engine chỉ cần sprite thường.

Vì sao một số phần của sprite ra đặc hoặc vuông?

Slicer chỉ giữ một voxel ở chỗ cả bốn góc nhìn đều phủ. Khoảng rỗng bị mọi góc nhìn che khuất sẽ bị lấp, chi tiết tròn cần một hình tròn ở góc nhìn trên hoặc flag --round, còn khe hở bị bao kín trong một góc nhìn sẽ ra đặc. Cách sửa có ở phần Giới hạn phía trên.

Bài hướng dẫn liên quan

Nguồn

Kiểm tra ngày 21/11/2026: README danielwh2/sprite-stacking, SKILL.md, references/engines.md, LICENSE và thông tin repo trên GitHub (tạo ngày 20/11/2026; 187 sao vào ngày 21/11/2026).

Bạn đã làm game có xe hay đạo cụ dùng sprite stacking? Gửi lên VibeGamer.