CPCodex Pets

Spritesheet preview

Preview a Codex pet spritesheet URL and pet.json before install.

Paste a browser-accessible WebP or PNG spritesheet URL, then inspect the full 9-state atlas, scale, pin, and mouse-follow behavior. Use the manifest checker to confirm pet.json points spritesheetPath at the image before you copy the package into Codex.

Manifest check

Use preview when the package shape is uncertain.

The preview tool is the safest place to check a Codex pet before install. The image should load as a 1536 by 1872 atlas, and pet.json should keep spritesheetPath aligned with the actual spritesheet file or URL. If the preview fails here, fix the package before copying it into Codex.

ImageSpritesheet URL loads

Use a browser-accessible WebP or PNG URL and confirm the 9-state rows render before relying on the package.

Manifestpet.json points to the image

The manifest id, display name, and spritesheetPath should describe the same pet package that you plan to install.

InstallOnly copy verified files

After preview passes, move pet.json and spritesheet.webp into the matching ~/.codex/pets/<pet-id>/ folder.

How to use

How to use the Codex pet preview tool

  1. 01

    Load a spritesheet

    Paste a public WebP or PNG spritesheet URL, or start with one of the bundled example Codex pets.

  2. 02

    Check the animation rows

    Use the 9-state grid first, then switch the large preview when you need to inspect one animation row in detail.

  3. 03

    Tune the display

    Adjust scale, pin mode, draggable floating behavior, and desktop mouse follow so you can test how the pet will feel inside Codex.

  4. 04

    Validate the manifest

    Paste pet.json into the checker before installing so missing fields, atlas dimensions, or frame counts are caught early.