豆豆桌宠 DIY

互动式帮助文档

从素材到 .petpack，一页走完

按制作流程整理必填项、素材规格、行为绑定和导出检查。适合第一次制作，也适合导出失败时快速定位问题。

开始查看流程 排查导出问题

四步完成宠物包

基础信息、动画素材、互动行为、检查导出。

必需动画
至少 1 个有效动画
免费尺寸
单帧不超过 128x128
帧率范围
1-30 FPS

输入关键词后会高亮匹配的帮助卡片。

Workflow

推荐制作流程

01

填写基础信息

名字、作者和版本是导出的核心元数据。版本号请使用 `1.0.0` 这种格式。

02

上传动画素材

可以上传多张 PNG 帧、横向 sprite sheet，也可以上传 WebM。上传后先看右侧预览。

03

配置互动行为

把动画绑定到待机、鼠标或应用识别触发条件；窗口与桌面边缘归入待机互动。

04

检查并导出

导出前查看错误和警告。错误必须修复，警告可以根据表现决定是否处理。

Assets

素材规格

单帧 PNG

  • 透明背景 PNG，所有帧宽高保持一致。
  • 免费基础版单帧建议不超过 128x128。
  • 像素风素材请避免抗锯齿模糊。

Sprite Sheet

1234

横向排列，宽度 = 单帧宽度 x 帧数，高度 = 单帧高度。

WebM

  • 仅支持 .webm 文件，适合长循环或高帧率动画。
  • 导出时会写入 videos 目录，并在 manifest 中标记 format: webm。
  • PNG 帧、Sheet 和 WebM 可以在同一个宠物包内混用。

动画字段示例

"idle": {
  "file": "sprites/idle.png",
  "frames": 4,
  "fps": 8,
  "loop": true
}

Behavior

行为绑定怎么理解

待机互动

适合绑定呼吸、眨眼、发呆、伸懒腰、任务栏边缘、窗口边缘和桌面边缘等宠物自主行为。窗口与桌面边缘归入待机互动。

Export

导出前检查

完成上面的检查后再导出。

FAQ

常见问题

通常是检查结果里仍有错误。先补齐名字、作者、版本，再确认动画素材尺寸一致。