Roxy-Inspired Codex Desktop Pet

An animated, fan-made desktop pet for the Codex Windows app. It includes coordinated jumping, hair and skirt motion, glowing hearts, a pulsing staff gem, shy/happy expressions, and the spoken encouragement "今天也要加油哦！" when the pointer enters the pet and triggers its jump interaction.

Quick install on Windows

1. Download the latest release ZIP and extract it.
2. Double-click install.cmd.
3. Fully quit and reopen Codex.
4. Open Settings > Pets and choose Roxy Inspired Mage.

The installer copies the pet to:

%USERPROFILE%\.codex\pets\roxy-inspired-mage

It backs up an existing installation before replacing it. The installer also enables the lightweight voice companion at Windows sign-in. It watches only the bounds of the small Codex pet window and does not capture keyboard input, screenshots, or network data. It waits for Codex to exit before persisting the maximum supported pet width of 224 px, avoiding configuration conflicts with the running app.

Uninstall

Double-click uninstall.cmd, then restart Codex. The uninstaller only removes the roxy-inspired-mage directory under your Codex pets folder.

Build the spritesheet

The prebuilt spritesheet is included, so Python is not needed for installation. To regenerate it, install Pillow and run:

python -m pip install Pillow
python tools/Build-RoxyAnimatedPet.py `
  --source assets/roxy-inspired-cutout.png `
  --sheet pet/spritesheet.png `
  --preview docs/animation-preview.jpg `
  --gif docs/animation-preview.gif

Codex sprite version 2 uses a 1536 x 2288 sheet containing an 8 x 11 grid of 192 x 208 frames. Animation frame counts are constrained by the Codex desktop pet player.

Codex custom-pet metadata does not currently provide a sound-event field. The included voice companion therefore detects the same pointer-entry interaction that triggers the jump and plays the bundled local WAV file. It does not modify the Codex application package.

To use a personal voice clip, name it encouragement.mp3 and place it beside the installed Voice-Companion.ps1. The MP3 is preferred over the bundled WAV and remains local; do not redistribute audio unless you have permission.

Project layout

assets/   Source cutout used by the animation builder
docs/     Animated preview
pet/      Files installed into the Codex pets directory
tools/    Deterministic Pillow-based animation builder

License and attribution

The source code is licensed under the MIT License. The character-inspired artwork is unofficial fan art and is not covered by the MIT License. See ASSET_NOTICE.md before redistributing or using it.

This project is not affiliated with or endorsed by OpenAI, Codex, the creators of Mushoku Tensei, or their rights holders.