工坊手册

主题

资源包 ​

资源包是一个包含多种类型文件、由其他开发者分享的游戏资产集合。

作者可以把作品中的资源导出成资源包，再在其他作品中导入复用。

入口 ​

点击文件管理器界面底部的【资源包管理】中可以进入资源包管理器界面。

资源包的创建与导出 ​

  1. 进入资源包管理器后，选择【导出资源包】。

  2. 在已上传的自定义文件中，选择需要加入资源包的文件，支持多选多个类型的资源。

  3. 在右侧更改资源包的名称和类型，用于标识资源包的用途。

  4. 保存资源包后，可以继续配置和修改资源包的内容和信息。确认导出后，即可导出可分享的资源包。

资源包分享 ​

如果你是资源包制作方，可以在【导出资源包】里选中之前导出的资源包，点击右下角的详情符号，进入资源包管理界面，再点击右下角导入左侧的省略号。

操作说明
复制分享码获得该资源包的分享码，分享给其他玩家使用
复制并导出复制该资源包的配置创建一个新的资源包项目；由于资源包不能直接修改，可使用这个方法重新创建并在原基础上修改
删除永久删除该资源包

分享码使用规则

  • 生成分享码存在 1 分钟冷却时间
  • 一个分享码的使用时长为 24h。
  • 一个分享码最多可以被使用 50 次。
  • 已获得资源包的玩家无法重复获得相同的分享资源包。
  • 获取分享资源包后，是否能正常使用仍受资源类型、编辑器能力和互通规则影响

其他用户获得分享码后，可以通过分享码获取对应资源包，再按正常资源包导入流程使用。

资源包导入 ​

如果你是资源包使用方，在资源包管理器中点击左侧【获取的资源包】，选择【输入分享码】，通过对应的分享码获得其他开发者分享的资源包。

选项说明
仅保存资源包将被收录在【获取的资源包】中，一个账号最多可同时拥有 200 个资源包，获取的资源包可以删除
保存并导入导入的资源包将可以在文件管理中作为已导入资源使用；导入资源跟随草稿，不可被删除

用户导入资源包后，资源会进入当前作品，并按资源类型出现在对应的管理器入口中。

重复导入同一个资源包时：

  • 不会创建第二个同名资源包分类
  • 会在已有分类下补充新增资源
  • 不会删除之前已经导入的旧资源
  • 部分类型的重复资源由用户选择：
处理方式说明
替换用新内容替换地图内已有内容
保留保留地图内已有内容
另存为作为新资源导入地图

编辑个人资源包 ​

用户可以修改：

  • 资源包封面
  • 资源包名称
  • 资源包分类
  • 资源包内资源内容

编辑的是云端保存的个人资源包，不会直接修改已经导入到作品中的资源。

资源类型与支持范围 ​

不同资源类型的支持范围不同。

资源类型世界编辑器说明
图片支持导出 / 导入美术资产，可双端互通
音频支持导出 / 导入美术资产，可双端互通
模型支持导出 / 导入美术资产，可双端互通，需注意编辑器差异
动作支持导出 / 导入美术资产，可双端互通，需注意动作类型限制
特效支持导出 / 导入美术资产，可双端互通
皮肤支持导出 / 导入美术资产，可双端互通
预设支持导出 / 导入各编辑器独立的地图数据，不等同纯美术资产
画布支持导出 / 导入各编辑器独立的地图数据，不等同纯美术资产
脚本支持 Lua 文件导出 / 导入世界编辑器脚本能力

纹理对外称为“皮肤”。

编辑器互通规则 ​

只有纯美术资产包支持在世界编辑器和原点编辑器之间互通使用。

纯美术资产通常包括：

  • 图片
  • 音频
  • 模型
  • 动作
  • 特效
  • 皮肤

以下内容不支持双端互通使用：

  • 预设
  • 画布
  • Lua 脚本
  • 蛋码触发器组
  • 依赖地图对象、场景节点、变量或表格的数据

可以这样理解：

text
美术资产更偏文件复用。
预设、画布、脚本、触发器组为地图数据，暂不支持双端互通使用。

如果资源包在另一个编辑器中不可见或不可用，通常是资源类型、编辑器能力或互通规则限制导致。

公开 / 受限状态说明 ​

世界编辑器中的部分资源存在公开 / 受限状态：

  • 公开资源可按规则被其他用户使用
  • 受限资源可能影响资源包导出、分享、上架或导入后的使用

预设、画布与触发器组规则 ​

预设和画布、触发器组是独立的地图数据，不等同纯美术资产。

导出预设或画布时，资源包中会生成对应的独立资源。它们可能依赖其他资源，也可能依赖当前作品中的对象、节点或配置。

用户编辑个人资源包时，如果遇到同 ID 的预设或画布，可以选择：

处理方式说明
替换用新内容替换资源包内已有内容
保留保留资源包内已有内容
另存为作为新资源加入资源包

PC 端可导出的依赖资源默认加入，用户可在确认窗口中选择是否一并导出

脚本与触发器组规则 ​

世界编辑器支持将 Lua 工程中的完整 .lua 文件导出为资源包内容。

需要注意：

  • 只支持完整 .lua 文件
  • 不支持导出代码片段或单个函数
  • 不自动检查脚本依赖
  • 不自动修改脚本引用路径
  • 导入时会写入目标作品的 Lua 工程
  • 导入时按资源包记录的相对路径还原文件位置
  • 如果目标位置已有同路径同名脚本，需要进行冲突处理