トラブルシューティング
Codex ペットの問題を修正する
インストールに関する問題の多くは、フォルダの配置、ファイルの欠落、または期待されるアトラスと一致しないスプライトシートに起因します。
カスタムペットが Codex に表示されないのはなぜですか？
フォルダが ~/.codex/pets/<pet-name>/ にあり、pet.json と spritesheet.webp が含まれていることを確認してください。
アニメーションが正しく表示されないのはなぜですか？
スプライトシートが読み取れない、透過していない、または現在の Codex ランタイムが綺麗にアニメーション化できない配置になっている可能性があります。
ペットをインストールした後に Codex を再起動する必要がありますか？
はい。新しいペットフォルダを配置したり、新しいスキルをインストールしたりした後は、Codex を再起動してください。
macOS で Codex ペットのアニメーションが止まるのはなぜですか？
macOS の「視差効果を減らす」設定により、デスクトップアニメーションが停止または抑制される場合があります。ペットは表示されるのに動かない場合は、視差効果を減らすガイドを確認してください。
インストールパスが正しいか確認するには？
ホームフォルダを開き、ペットパッケージが ~/.codex/pets/<pet-name>/ にあり、pet.json と spritesheet.webp がその直下にあることを確認してください。
Compare your package with the format spec. 視差効果を減らすガイドを見る