搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

danielwh2/sprite-stacking

游戏

把四向像素视图雕刻成可旋转的伪 3D 精灵切片,并附带网页查看器的 Agent 技能。

这是一个 Agent 技能包 · 1 个技能看技能清单和安装方法 →
263
21
HTML
MIT
今天创建

项目介绍

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 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. Hugo-Dz/spritefusion-sprite-normals从像素精灵图和动画序列帧生成法线贴图,让 2D 美术能响应动态光照。Rust658
  2. 0x0funky/agent-sprite-forge把一张审核通过的 AI 静帧,经由编码智能体变成带质检、循环和打包的 2D 游戏精灵集与地图。Python4,734
  3. patch-gg/pixelfx用代码实现的 244 个像素风特效库,可用于浏览器游戏和各类引擎,并附带用 Claude Code 自制特效的技能。JavaScript5,014
  4. kociden/sakurai-skill将樱井政博 257 个游戏制作视频字幕提炼为游戏策划与评审用的 Claude Code 技能。Python103
  5. op7418/guizang-game-skill面向 Claude Code、Codex 的 Agent Skill,按完整流程让 AI 做一个可在浏览器里玩的 3D 动作游戏。JavaScript109