Creator guide

How to create a Codex pet

A good package is easy to check. Keep the pet simple, put the metadata in pet.json, and export one spritesheet.webp file.

1. Prepare the character

Start with a character that still reads at a small size. A clear shape matters more than tiny details.

2. Build the spritesheet

Export spritesheet.webp as an 8 column by 9 row sheet. Each row is one animation state, and each row should contain 8 frames of the same action.

3. Write pet.json

Add id, displayName, description, and spritesheetPath. The description appears on the pet page, so write one plain sentence.

4. Upload and check

Upload pet.json and spritesheet.webp together. Check the preview before sharing the page.

Publish your pet

Put your pet on a page people can use.

Upload pet.json and spritesheet.webp together. The page shows the preview, file links, package download, creator name, and related pets.