跳到主要内容

总体要求

本指南介绍创建可在 EmoteLab 中正常工作的模型所需的基础要求。在开始制作模型之前，理解这些要求非常重要。

信息

您需要使用 Spine 来创建与 EmoteLab 兼容的模型。本指南不是 Spine 教程，并默认您对 Spine 具有非常基础的了解。

Spine 版本要求​

需要 Spine Editor 版本 4.3.39-beta 或更高。模型必须使用 Spine Editor 4.3 或更高版本导出。

必需文件​

每个模型都必须在同一文件夹中包含以下文件：

ModelFolder/
  ├── ModelName.json          (required - skeleton file)
  ├── ModelName.atlas.txt     (required - atlas file)
  ├── texture1.png            (required - texture images)
  ├── texture2.png            (required - texture images)
  ├── icon.png                (optional)
  ├── LICENSE.txt             (optional, or LICENSE.md)
  └── ...                     (additional texture files as needed)

Skeleton 文件格式​

  • 格式：仅支持 JSON
  • 扩展名：.json
  • 不支持二进制格式：本地模型不支持 .skel.bytes 格式
  • 文件命名：必须命名为 [ModelName].json，其中 [ModelName] 为模型名称

Atlas 文件格式​

  • 扩展名：.atlas.txt
  • 格式：标准 Spine atlas 文本格式
  • 文件命名：必须命名为 [ModelName].atlas.txt，其中 [ModelName] 必须与 skeleton 文件名一致

贴图文件格式​

  • 扩展名：.png（小写）
  • 颜色模式：RGBA，straight alpha
  • 命名：贴图文件名必须与 atlas 文件中指定的名称完全一致
  • 区分大小写：在某些操作系统中，文件名区分大小写

可选文件​

您可以包含以下可选文件来增强模型体验：

  1. 预览图标：icon.png

    • 显示在 Models 列表中
    • 推荐尺寸：128x128 像素或正方形比例
    • 若未提供，将显示默认图标

  2. 许可文件：LICENSE.txt 或 LICENSE.md

    • 包含许可与署名/归属信息
    • 用户可通过许可按钮查看
    • 对模型分发非常重要

模型内容要求​

基础组件​

您的模型必须包含：

  1. Skeleton：用于定义模型结构的骨骼层级
  2. Slots：图片的挂载点
  3. Skins：附件集合
  4. Animations：动画数据
  5. Atlas：贴图组织信息
  6. Textures：用于显示外观的图像文件

模型复杂度注意事项​

虽然没有硬性限制，但建议考虑：

  • 性能：非常复杂的模型可能影响性能
  • 文件大小：大贴图会增加加载时间
  • 组织结构：组织良好的模型更易维护与迭代