ClaudeMap

sprite-stacking

把四张像素画视图刻成体素体积、渲染成可旋转的假 3D 精灵的 agent skill——附独立查看器与 PNG 导出

技能与命令skillpixel artfake 3dpythongamedev

sprite-stacking 是一个实现经典独立游戏渲染技巧(堆叠平面层伪造深度)的 agent skill。流水线取四张正交视图(顶、侧、前、后,一行排布),只在四个视图都覆盖的位置保留体素,把体积自底向上切成一排平面层,再把每层旋转、按俯仰压缩并抬升一像素来渲染。skill 自带切片 CLI(views_to_slices.py),旗标涵盖层数(15-20 厚块、32-48 细致)、视图顺序(按比例自动匹配或强制阅读序)、塔与气球等圆形雕刻、侧视图朝向与共享调色板大小;viewer.html 是独立页面,带转台、切片扫描、爆炸视图、拖拽环绕与 16 方向 PNG 导出,也接受拖入的切片条。agent 没有图像生成器时会自己写一小段 Python 脚本画四视图。请求示例:可旋转的像素小车、从 4 视图图出转台、给 Godot 游戏加一棵假 3D 树。需要带 Pillow 与 NumPy 的 Python 3;走 skills CLI 需要 Node 22.20 或更新。README 明言 sprite stacking 是由来已久的既有技巧——本 skill 的贡献是四视图雕刻与 agent 工作流。作者 Daniel White。

它做什么

  • 四视图流水线:正交的顶/侧/前/后视图雕刻体素体积(仅保留四视图都覆盖的位置),再自底向上切成可渲染的切片条
  • views_to_slices.py CLI:--slices N 控制层数(15-20 厚块、32-48 细致)、--order reading 强制顺序、--round 圆形雕刻、--side-nose 侧向、--colours N 共享调色板
  • 独立 viewer.html:转台、切片扫描、爆炸视图、拖拽环绕与 16 方向 PNG 导出;可直接打开或接受拖入的切片条
  • agent 优先工作流:没有图像生成器也能用——agent 自己写一小段 Python 画四视图,再跑切片器
  • 徽标注明的宿主广度:Claude Code、Codex、Cursor、OpenCode、Gemini CLI 与 Pi;分别拷入 ~/.claude/skills/ 或 ~/.agents/skills/

什么时候用

适合游戏、玩具页面或素材包需要从几张像素视图得到可旋转的假 3D 道具,或想让 agent 端到端产出 sprite-stack 素材而不依赖图像模型的场景。真 3D 管线或写实渲染请绕行——它刻意做的是假深度。

如何上手

经 skills CLI 安装(装入当前项目;-g 全局、-a <agent> 选宿主;需 Node 22.20+):

npx skills add danielwh2/sprite-stacking

或把 skills/sprite-stacking 拷进宿主的 skills 目录:

Claude Code:~/.claude/skills/
Codex、Cursor、OpenCode、Gemini CLI、Pi:~/.agents/skills/

依赖:带 Pillow 与 NumPy 的 python3(pip install pillow numpy)。

直接运行切片器:

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

注意事项

渲染对每一层做旋转加压缩,--slices 越大要渲染的层就越多;README 示例用 36。视图顺序默认按比例匹配,可用 --order reading 强制 TOP、SIDE、FRONT、BACK。README 把 sprite stacking 记作既有技巧,本仓范围限定为四视图雕刻加 agent 工作流。贡献自检:python3 tests/check.py 输出 ok。MIT 许可。撰稿时 69 星(2026-11-21)。

代码仓库

danielwh2/sprite-stacking

收录日期

地图上的相关资源

  • SureForge

    技能

    纯指令式 skill:让 agent 先调研再提问、先规划再动手、先验证再说「做完了」。

    • workflow
    • verification
    • quality
    • skill
  • 归藏的 Agent Skill:把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐,全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
  • 一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片,把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap