danielwh2/sprite-stacking
游戏把四向像素视图雕刻成可旋转的伪 3D 精灵切片,并附带网页查看器的 Agent 技能。
这是一个 Agent 技能包 · 1 个技能看技能清单和安装方法 →项目介绍
Sprite stacking 是独立游戏圈沿用已久的做法:把一张 2D 图像切成薄层,旋转视角时各层略微错位,像素画就有了可以转动的伪 3D 效果。这个仓库把这套流程做成 Agent 技能,Claude Code、Codex、Cursor、OpenCode、Gemini CLI、Pi 这类编程 Agent 可以读取顶、侧、前、后四张正交视图,生成切片条带和旋转转盘。
关键一步是雕刻:只有四个视图都覆盖到的体素才会保留,这样结果与原始视图表保持一致;随后体量被切成平层,渲染时对每层做旋转、俯仰压扁和 1 像素抬升。仓库同时提供切片脚本和独立 HTML 查看器。
快速使用
需要 Python 3 以及 Pillow、NumPy。用 skills CLI 把技能装进当前项目(需 Node 22.20 及以上):
npx skills add danielwh2/sprite-stacking
也可以直接把 skills/sprite-stacking 复制到 Agent 的技能目录:Claude Code 用 ~/.claude/skills/,Codex、Cursor、OpenCode、Gemini CLI、Pi 用 ~/.agents/skills/。然后对 Agent 说类似「Sprite stack this 4-view sheet and give me a turntable」的话即可。
如果直接对四视图表运行切片脚本:
python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
--slices 36 --preview check.png --html viewer.html
这会输出切片条带、预览图和独立查看器页面。没有现成的四视图表时,README 说明 Agent 可以用一段简短的 Python 脚本自行画出各视图。
常用参数
--slices N控制层数:粗颗粒精灵约 15-20,精细精灵约 32-48。--order reading强制按 TOP、SIDE、FRONT、BACK 顺序;默认按比例匹配视图。--round让塔、气球、罐子等物体按圆形雕刻而非方形。--side-nose right声明侧视图朝右。--colours N设定共享调色板大小,0保留全部颜色。--normals和--emissive分别导出配套的法线贴图条带和自动检测的自发光遮罩条带。
生成的查看器包含转盘、场景、切片扫描、爆炸和播放模式,还有昼夜光照、天气以及 16 方向烘焙精灵表导出。skills/sprite-stacking/scripts/viewer.html 也能单独打开并接受拖入的切片条带。
使用约束
这是 Agent 技能加 Python 脚本,不是独立的游戏引擎插件。切片脚本依赖 Python 3、Pillow 和 NumPy;npx skills add 方式需要 Node 22.20 及以上。输入视图要求是同一行的四张正交视图,默认按比例匹配,形状特殊的图可能需要 --order reading。查看器的性能数字来自项目自述的 Chrome 场景,并非独立基准测试。项目采用 MIT 许可证。
HotRepo 点评
HotRepo 的新项目快照在 2026-11-21 记录到 107 星、12 个 fork,统计窗口从 2026-11-20 起算至次日,未记录到全语言日榜名次。与一般的 sprite stacking 演示相比,它的差异点在四视图雕刻与 Agent 工作流的结合,而随附的切片脚本、命令行参数和查看器让技能有可以实际操作的对象,而不只是提示词包装。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- Hugo-Dz/spritefusion-sprite-normals从像素精灵图和动画序列帧生成法线贴图,让 2D 美术能响应动态光照。
- 0x0funky/agent-sprite-forge把一张审核通过的 AI 静帧,经由编码智能体变成带质检、循环和打包的 2D 游戏精灵集与地图。
- patch-gg/pixelfx用代码实现的 244 个像素风特效库,可用于浏览器游戏和各类引擎,并附带用 Claude Code 自制特效的技能。
- kociden/sakurai-skill将樱井政博 257 个游戏制作视频字幕提炼为游戏策划与评审用的 Claude Code 技能。
- op7418/guizang-game-skill面向 Claude Code、Codex 的 Agent Skill,按完整流程让 AI 做一个可在浏览器里玩的 3D 动作游戏。