给 Codex 加一只像素宠物：阿梓 Azi

小H发现最近Codex上新了一个宠物的功能，但是自带的宠物又有些普通了，于是决定找点神奇的人物做成小桌宠。

仓库地址：https://github.com/futureseek/codex-pet-azi

效果如下图，实际上可以通过角色就看到目前系统是什么样的一个状态，根据状态也有会不一样的动作（参考下面的几个动作状态）

效果简介

宠物包含 Codex 常用的动作状态，比如：

• idle：待机
• running-right：向右跑
• running-left：向左跑
• waving：挥手
• jumping：跳跃
• failed：失败/沮丧
• waiting：等待
• running：忙碌中
• review：检查/审阅

仓库里也放了动作展示图，打开 README 就能看到完整帧预览

仓库结构

下载仓库后，大致结构如下：

codex-pet-azi/
  README.md
  assets/
    contact-sheet.png
  azi/
    pet.json
    spritesheet.webp

真正需要安装到 Codex 里的，是 azi 这个文件夹。

其中：

pet.json 是宠物配置文件

spritesheet.webp 是宠物动作图集

如何安装到 Codex

安装方法很简单。

• 下载仓库可以直接从 GitHub 下载 zip，也可以使用 git clone：git clone https://github.com/futureseek/codex-pet-azi.git
• 复制宠物文件夹把仓库里的 azi 文件夹复制到 Codex 的 pets 目录。

Windows 下一般是：

C:\Users\<你的用户名>\.codex\pets\azi
复制完成后应该是这样：

C:\Users\<你的用户名>\.codex\pets\azi\pet.json
C:\Users\<你的用户名>\.codex\pets\azi\spritesheet.webp

macOS 或 Linux 下一般是：

~/.codex/pets/azi

• 重启 Codex：复制完成后，重启 Codex，或者刷新宠物列表。

如果安装成功，就可以在 Codex 里召出 Azi 了。

如果你也想自己做一只宠物

Azi 是用 Codex 的 hatch-pet 工作流做出来的。

大致流程是：

• 准备角色参考图，比如三视图、设定图或者清晰立绘。
• 使用 hatch-pet 生成宠物主视觉。
• 生成不同动作行，比如待机、跑动、挥手、跳跃等。
• 合成最终的 spritesheet.webp。
• 生成 pet.json。
• 把宠物包放进 .codex/pets/ 目录。
• 成品宠物一般只需要两个文件：pet.json 和 spritesheet.webp

如果只是分享给别人使用，直接分享整个宠物文件夹即可。

小结

Codex 的宠物功能虽然不是核心开发功能，但真的很有意思。

它让工具多了一点陪伴感，也让自己的工作环境更有个人风格。尤其是把一个角色变成会动的小像素宠物之后，写代码的时候旁边有个小家伙待着，感觉还挺可爱的。

这次我把 Azi 的成品仓库放在这里：https://github.com/futureseek/codex-pet-azi