跳到正文

互动式帮助文档

# 从素材到 .petpack，一页走完

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

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

## 四步完成宠物包

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

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

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

Workflow

## 推荐制作流程

01

### 填写基础信息

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

02

### 上传动画素材

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

03

### 配置互动行为

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

04

### 检查并导出

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

Assets

## 素材规格

### 单帧 PNG

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

### Sprite Sheet

1 2 3 4

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

### WebM

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

### 动画字段示例

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

Behavior

## 行为绑定怎么理解

### 待机互动

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

### 鼠标互动

适合绑定追鼠标、被点击、快速点击后的反应动画。

### 应用识别

MAX 创作者可为 Chrome、VS Code、Steam 等应用绑定专属反应。

Export

## 导出前检查

名字、作者、版本已填写 至少有一个动画包含有效素材 所有帧尺寸一致 行为绑定没有指向不存在的动画 右侧检查结果没有错误
完成上面的检查后再导出。

FAQ

## 常见问题

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

未登录时单帧尺寸限制为 128x128。登录后可使用更高分辨率，MAX 创作者还可以使用更多帧和行为槽位。

待机和睡眠通常 4-8 FPS，移动或反应动画可用 8-12 FPS。最高支持 30 FPS。