Codex Pet Lab v0.9

CUSTOM PET WORKBENCH

Turn a sprite atlas into a real Codex companion.

Validate the official atlas contract, preview every state, edit metadata, and export an install-ready local pet package.

Explore original concepts
v1 1536×1872 v2 1536×2288 20 MiB max PNG/WebP
Nebby original pet concept
Nebby Original concept · not an atlas

START WITH A PERSONALITY

An original anime character shelf

These are identity presets for planning. A preset only becomes installable after a real animated atlas passes validation.

PRIVATE LOCAL CHARACTER PACKS

Bring your own characters

Import licensed or personal character packs on this device. Files are stored in this browser only and are never added to the public repository.

⌁
Choose a completed pet folderThe folder must contain pet.json and its referenced PNG/WebP spritesheet.
No local character packs yet.

VALIDATE · PREVIEW · PACKAGE

Pet studio

1 Atlas 2 Identity 3 Export
01

Sprite atlas

Drop a transparent PNG or WebP here.

○

File typePNG / WebP

○

Atlas size1536×1872 / 1536×2288

○

File weight≤ 20 MiB

○

TransparencyTransparent background required

○

Unused cellsMust remain fully transparent

02

Animation preview

Waiting for a valid atlas

Selected pet concept
Frame
— / —
03

Pet identity

Metadata saved in pet.json.

pet.json

            
04

Export package

No upload: processing stays in your browser.

📁 nebby ├─ pet.json └─ spritesheet.webp

Add a valid atlas to unlock export.

Install on Windows

After export, run this from the repository root:

.\scripts\install-pet.ps1 -SourceDir "C:\path\to\nebby"
01

Local by design

Your sprite atlas never leaves the browser.

02

Real contract checks

Dimensions, alpha, empty slots, metadata, and v2 format are checked.

03

Open and bilingual

MIT-licensed, English-first, with complete Simplified Chinese UI and docs.