Browser tool
Free Codex Pet Validator
The Codex Pet Lab validator reads files locally. It does not upload your pet unless you explicitly submit it for community review.
What structural validation checks
- pet.json is valid JSON
- id is a lowercase slug
- displayName and description are present
- spritesheetPath is spritesheet.webp
- spriteVersionNumber is supported
- WebP dimensions match the selected version
V2 requirements
- 1536×2288 atlas
- 8 columns and 11 rows
- 192×208 cells
- 16 look-direction cells in rows 9–10
What requires visual QA
Structural validation cannot prove that animations are smooth, backgrounds are fully transparent, direction semantics are correct, or the character identity remains stable. Use contact sheets and motion previews for those checks.
Validate from the command line
npx codexpetlab validate ./my-pet.codex-pet.zip