技术规范

Codex 宠物包格式

Codex 自定义宠物包是一个包含 pet.json 和 spritesheet.webp 的本地文件夹。

快速查阅

宠物目录~/.codex/pets/<pet-name>/
必需清单文件pet.json
必需精灵图spritesheet.webp
图集尺寸不强制限制
网格随包而定
单格尺寸由客户端/运行时推导
格式transparent WebP / RGBA

清单文件结构

{
  "id": "codie",
  "displayName": "Codie",
  "description": "一个为 Codex Pet 设计的小像素机器人伙伴。",
  "spritesheetPath": "spritesheet.webp"
}

动画行

每一行代表一种动画状态。标准布局有 9 行，对应 Codex 宠物的运行时状态。下表中的帧数是基于 Codie 参考包的建议值——你的宠物包在每一行可以使用更少或更多的帧。

行状态建议帧数
0idle (待机)6
1running-right (向右跑)8
2running-left (向左跑)8
3waving (挥手)4
4jumping (跳跃)5
5failed (失败)8
6waiting (等待)6
7running (跑动)6
8review (检查)6

验证规则