技术规范

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",
  "spriteVersionNumber": 2
}

动画行

V1 使用 9 行标准动画；V2 保留这 9 行，并新增第 9–10 行用于 16 个查看方向。两个版本均为 8 列、单格 192x208。

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

验证规则