一个使用现有 4×7 像素帧重新编排的 Codex 动态宠物。项目采用最近邻整数缩放、帧排序和画布内位移来表现走路、跳跃、等待、失败、工作与检查动作。

动画示例

右行	跳跃	工作

特性

• 8×11 图集，单格 192×208，成品 1536×2288
• 9 个标准状态和 16 个方向槽位
• 无损 WebP、透明背景、透明区域 RGB 为零
• 完全可复现构建与本地验证

仓库结构

assets/                         原始 64×112 素材
dist/stardew-blue-chicken/      可直接安装的宠物包
previews/                       动画与 QA 预览
scripts/build_pet.py            从原素材重建图集
scripts/validate_pet.py         独立格式验证器
tests/                          自动化测试
.github/                        CI、Issue 与 PR 模板

快速开始

需要 Python 3.10+。

python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
python -m pip install -r requirements.txt
python scripts/build_pet.py
python scripts/validate_pet.py
python -m unittest discover -s tests -v

安装到 Codex

将 dist/stardew-blue-chicken 整个目录复制到：

~/.codex/pets/stardew-blue-chicken/

最终应为：

~/.codex/pets/stardew-blue-chicken/pet.json
~/.codex/pets/stardew-blue-chicken/spritesheet.webp

刷新或重启 Codex 后选择“星露谷蓝色小鸡”。

素材保真策略

构建脚本只会：

1. 按 16×16 切分原始素材；
2. 使用最近邻算法放大 8 倍；
3. 将完整帧放到透明的 192×208 单元格；
4. 通过顺序和位置变化形成动画。

由于原素材只提供有限朝向，16 个方向槽位会复用最接近的原始朝向，而不是凭空绘制中间角度。

仓库地址