Creation

How to create a custom Codex Pet

A good Codex Pet starts with a simple readable character, then becomes a validated 8x9 spritesheet package.

Steps

1. Choose a compact pet concept or provide a clear reference image.
2. Generate the base pet and use it as the visual source of truth.
3. Generate all animation rows and review the contact sheet.
4. Validate the atlas and package pet.json with spritesheet.webp.
5. Install the folder under ~/.codex/pets/<pet-name>/ and restart Codex.

QA checklist

• The pet identity stays consistent across every row.
• Unused cells are transparent.
• No grid lines, labels, or detached effects remain in the atlas.

Technical details: read the Codex Pet package spec.