技術リファレンス
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"
}アニメーション行
各行は一つのアニメーション状態を表します。標準レイアウトは、Codex ペットの実行状態に合わせた 9 行で構成されています。以下のフレーム数は Codie リファレンスパックに基づいた推奨値であり、パックによっては行あたりのフレーム数がこれより少ない、あるいは多い場合があります。
| 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 |
検証ルール
- spritesheet.webp は読み取り可能な透過 WebP 画像であること。
- アトラスの寸法は管理者レビューで確認されますが、自動的に拒否されることはありません。
- 各アクション行には、少なくとも 1 つの空でないフレームが必要です。再生は列 0 から始まる連続した空でないフレームを使用し、末尾の空のセルは無視されます。
- グリッド線、ラベル、フレーム番号が含まれていないこと。
- すべての行でペットのアイデンティティが一貫していること。