概览
宠物是一种动画精灵：通过连续播放图片帧，让小角色动起来。提交并通过审核后，它就能出现在社区宠物库中，供其他人使用。
提交方式有两种。最方便的是提供 Petdex 链接；如果你自己托管文件，也可以通过 GitHub 提交精灵图集和 sprite.json。既可以提交已有的 Petdex 宠物，也可以制作原创角色。
两种方式都需要先登录 PicoPixel。
打开提交页面
- 打开 PicoPixel 应用。
- 使用 Google 或 GitHub 登录。如果还未登录，提交前也会出现登录提示。
- 点击左侧边栏底部的账号。
- 选择 Your account。
- 打开 Submit Sprite。
页面上提供以下两种提交方式。
提交内容前必须登录 PicoPixel 账号。
通过 Petdex 提交
这是推荐方式，只需提供一个链接。Petdex 是独立的宠物平台，可以浏览、创建和托管宠物。每个条目都有类似 https://petdex.crafter.run/pets/<pet-id> 的分享链接。
- 在 Petdex 上找到或创建宠物，复制其链接。
- 在 Submit Sprite 页面选择 Submit via Petdex。
- 将链接粘贴到 Petdex URL 字段。
- 如有补充说明，填写可选的 Notes 字段。
- 提交。
页面上的 RECOMMENDED 和 FASTEST 标记指的就是这种方式，只需一个 Petdex 链接即可提交。
通过 GitHub 提交
如果你自己托管精灵文件，可以使用此方式：
- 将精灵图集和对应的
sprite.json放入公开的 GitHub 仓库。 - 在 Submit Sprite 页面选择 Submit via GitHub。
- 粘贴仓库链接（
https://github.com/...）。 - 填写 Credits / Author，提供作者署名。
- 按需填写 Notes，然后提交。
图集和 sprite.json 需要符合下一节介绍的格式。
制作原创宠物
除了使用已有的 Petdex 宠物，你也可以制作原创角色。OpenAI Codex 或 AI 图像生成工具，都可以帮助你从零制作精灵图集。
**精灵图集（spritesheet，也称 atlas）**是一张 PNG 或 WebP 图片，将所有动画帧排列在尺寸一致的网格中。每行放置一种动画，每一格的宽高都必须相同。
所有帧的尺寸必须完全一致。网格不规则会导致切帧错误，出现动画跳动或画面损坏。
sprite.json 描述图集布局和动画状态，主要包含：
- atlas：网格信息，包括
columns、rows、frameWidth和frameHeight。 - states：动画状态数组。每个状态包含
id、label、所在row、frames数量，以及可选的durationMs、group和caption。
常见状态标识有 idle、wave、jump、run-right、run-left、running、waiting、failed 和 review。精灵至少需要两个状态，因此至少准备一段 idle 动画和另一种动作。
建议先生成尺寸一致的帧，按每行一种动画排入网格，再用 sprite.json 描述布局和状态，最后通过 Petdex 或 GitHub 提交。
关于精灵、动画模式和跨项目复用，请参阅精灵指南。
提交后如何处理？
PicoPixel 团队会审核你的宠物，必要时联系你补充信息。通过审核后，作品会出现在宠物库中，并显示你的署名，社区用户即可浏览和使用。
