技術リファレンス
Codex ペットパッケージ形式
Codex カスタムペットパッケージは、pet.json と spritesheet.webp を含むローカルフォルダです。
クイックファクト
| Package folder | ~/.codex/pets/<pet-name>/ |
|---|---|
| Required manifest | pet.json |
| Required spritesheet | spritesheet.webp |
| Atlas size | Not enforced |
| Grid | Varies by pack |
| Cell size | Derived by client/runtime |
| Format | transparent WebP / RGBA |
マニフェストの形式
{
"id": "codie",
"displayName": "Codie",
"description": "A tiny pixel robot companion for Codex Pet.",
"spritesheetPath": "spritesheet.webp",
"spriteVersionNumber": 2
}アニメーション行
V1 は標準アニメーション 9 行です。V2 はその 9 行に加え、16 の視線方向を表す行 9–10 を追加します。どちらも 8 列、セルは 192x208 です。
| Row | State | Recommended frames |
|---|---|---|
| 0 | idle | 6 |
| 1 | running-right | 8 |
| 2 | running-left | 8 |
| 3 | waving | 4 |
| 4 | jumping | 5 |
| 5 | failed | 8 |
| 6 | waiting | 6 |
| 7 | running | 6 |
| 8 | review | 6 |
| 9 | look-directions-a (V2) | 8 |
| 10 | look-directions-b (V2) | 8 |
検証ルール
- スプライトシートは読み取り可能な透過 PNG または WebP 画像であること。
- V1 は 1536x1872、V2 は 1536x2288 で、pet.json に spriteVersionNumber: 2 が必要です。
- 各アクション行には、少なくとも 1 つの空でないフレームが必要です。再生は列 0 から始まる連続した空でないフレームを使用し、末尾の空のセルは無視されます。
- グリッド線、ラベル、フレーム番号が含まれていないこと。
- すべての行でペットのアイデンティティが一貫していること。