跳到主要内容

模型加载

EmoteLab 支持两类模型：

  • 内置模型：随 EmoteLab 安装一起提供的模型。这些模型可立即使用，所需文件已预先配置完成。

  • 本地模型（第三方模型）：您将模型放入电脑指定文件夹后由您自行添加的模型。这些模型可能来自其他来源，或由您自己创建。

所有模型都会在 EmoteLab 启动时自动被发现，并显示在主界面的 Models 列表中。

加载模型​

第 1 步：找到 Models 列表​

打开 EmoteLab 后，查看编辑器窗口左侧。您会看到一个标注为 Models 的区域。该列表会显示 EmoteLab 在您的系统中找到的所有可用模型。

Models List

第 2 步：浏览可用模型​

Models 列表会为每个模型显示若干信息：

Model List Entry

  • 预览图标：展示模型外观的小预览图（如果有提供预览图）
  • 模型名称：模型的名称
  • 模型类型标识：显示该模型是内置模型还是本地模型的标签
  • 许可按钮：点击可查看该模型的许可信息与署名/归属详情

您可以滚动列表查看所有可用模型。列表会按模型名称的字母顺序进行排序。

第 3 步：选择要加载的模型​

Select a Model to Load

要加载模型，只需在 Models 列表中 点击该模型。被选中的模型会高亮显示，随后会自动开始加载流程。

第 4 步：等待模型加载完成​

Wait for the Model to Load

在加载过程中，编辑器界面会暂时被禁用，以避免在模型加载期间进行操作。加载通常只需几秒钟，但包含大量贴图的大型模型可能需要更长时间。加载完成后，界面会重新启用。

第 5 步：确认模型已成功加载​

加载完成后，您应当看到：

  • 模型显示在视口中
  • 角色自定义选项变为可用
  • 动画列表已填充该模型的动画

卸载模型​

Unload a Model

要从视口中移除当前已加载的模型，请使用 Models 列表下方的 Unload Current Model 按钮。

备注

同一时间只能加载一个模型。如果您在列表中点击了另一个模型，当前模型会自动卸载并替换为新模型。

添加新模型​

内置模型​

内置模型会随 EmoteLab 预装提供。当您更新 EmoteLab 时，更新中包含的新内置模型会自动出现在 Models 列表中。

本地模型​

本地模型是由您自行添加到 EmoteLab 的模型。它们可能是您下载的、购买的，或使用 Spine 等兼容软件创建的模型。

本地模型必须放置在您电脑上的指定文件夹中。

%USERPROFILE%\AppData\LocalLow\GlycoProduction\EmoteLab\SpineModels\

模型文件夹结构​

每个本地模型都必须位于 SpineModels 目录下的独立文件夹中。如果 SpineModels 文件夹不存在，EmoteLab 会在首次运行时自动创建。文件夹结构应如下所示：

SpineModels/
  └── ModelName/
      ├── ModelName.json          (required - skeleton file)
      ├── ModelName.atlas.txt     (required - atlas file)
      ├── texture1.png                (required - texture images)
      ├── texture2.png                (required - texture images)
      └── ...                         (additional texture files)

添加本地模型​

要将本地模型添加到 EmoteLab：

  1. 准备模型文件

    • 确保包含骨骼文件（.json）、图集文件（.atlas.txt）以及全部贴图文件（.png）
    • 可选文件包括预览图标（icon.png）和许可文件（LICENSE.txt 或 LICENSE.md）
    • 确保所有文件都在同一个文件夹中
    • 文件夹名不需要与模型名一致，但建议使用清晰、易理解的命名

  2. 将模型文件夹复制到本地模型目录

    • 进入 SpineModels 文件夹
    • 将包含所有必需文件的模型文件夹复制到 SpineModels 文件夹中

  3. 重启 EmoteLab

    • EmoteLab 启动时会自动扫描新模型
    • 新模型应当会出现在 Models 列表中
模型命名要求
  • 骨骼文件必须命名为 [ModelName].json，其中 [ModelName] 是将会在 EmoteLab 中显示的名称
  • 图集文件必须命名为 [ModelName].atlas.txt，其中 [ModelName] 必须与骨骼文件名一致（不含扩展名）
  • 文件夹名可以与模型名不同，但建议使用相同名称
  • 在某些操作系统上文件名区分大小写，请确保大小写一致

故障排除​

本地模型未出现在列表中​

  • 检查文件夹位置：确保模型文件夹位于正确的 SpineModels 目录中
  • 检查文件名：确认骨骼文件命名为 [ModelName].json，图集文件命名为 [ModelName].atlas.txt
  • 检查文件格式：确保骨骼文件为 JSON 格式（而不是二进制 .skel.bytes 格式）
  • 重启 EmoteLab：关闭并重新打开 EmoteLab 以触发重新扫描
  • 查看错误信息：检查控制台或日志文件中的错误提示，以定位问题原因

本地模型加载失败​

  • 检查必需文件：确保所有必需文件（骨骼、图集、贴图）都存在
  • 检查贴图文件：确认图集文件引用的所有贴图文件都存在，并且位于同一文件夹中
  • 检查文件完整性：确保文件未损坏且不缺失
  • 检查文件权限：在某些系统中，文件权限可能会阻止读取
  • 尝试其他模型：用内置模型测试，以判断问题是否仅发生在该本地模型上
  • 大型模型：含有大量高分辨率贴图的超大模型可能需要更久才能加载，请耐心等待