套件

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

为了在您的团队或多个项目中保持资产的有序和可重用,您可以将实例分组并将其转换为可重用的 套件。 套件使构建世界的整体过程更加快速和符合人体工程学,它们还帮助维护一致性、减少重复、促进协作和版本控制:

  • 轻松地 更新所有副本 到最新版本,或仅 更新特定副本
  • 设置套件为在有新版本时 自动更新
  • 为合作者提供 编辑使用 权限,以访问套件的内容。
  • 查看套件的完整版本历史,比较版本,并恢复旧版本。

最高效的工作流程是 创建一个套件,与任何合作者 共享 它,并 设置为自动更新。 而且您不必等待模型“完成”才能在套件中使用它。即使套件只是一个简单形状上面的占位符,您也可以使用它来 灰框您的环境,然后当您发布更详细的版本时,这些占位符副本会自动更新。

创建套件

您可以从任何单一对象或任何单一父对象和子对象分支创建套件。如果您想为单个对象创建一个套件,请先将其添加到 Model 分组中,以便您稍后可以在套件中添加、移除或缩放子对象,而不会破坏该套件。

要创建一个套件:

  1. 资源管理器 窗口或 3D 视口中,右键单击您想要转换为套件的对象,然后在上下文菜单中选择 转换为套件

  2. 在新窗口中,填写套件详细信息。特别是,如果您在 中工作,请将 所有权 设置为您有权限创建/编辑组游戏的适当组。

  3. 点击 提交

  4. 转换完成后,对象在 资源管理器 窗口中会收到一个“链环”符号,以识别它作为套件。此外,您可以看到一个新的 PackageLink 对象作为其父对象。

    资源管理器窗口中的一棵枫树模型,旁边有套件图标。
  5. 可选
    选择 PackageLink 对象并在 属性 窗口中启用 AutoUpdate。注意图标的变化,表明该套件已设置为自动更新。

插入套件

要插入一个当前场所中尚不存在的套件,您必须 最初工具箱 插入它:

  • 库存我的套件 中查看您发布到或从 创作者商店 获取的套件,以及朋友拥有并授权您 使用 的套件。
  • 创作小组套件 中查看由您的 小组 成员(包括您自己)发布的套件。
工具箱的特写视图,显示库存选项卡和资产下拉菜单。
工具箱 ⟩ 库存 ⟩ 我的套件
工具箱的特写视图,突出显示创作选项卡。
工具箱 ⟩ 创作 ⟩ 小组套件

一旦您将套件插入已发布场所的数据模型中,它将出现在 资产管理器 中,即使您随后删除了所有副本,它也会保留在其中。

修改套件

您可以像编辑其他对象一样编辑套件及其子对象。修改套件会禁用 自动更新,直到您 发布恢复 这些更改。

大多数编辑会将套件标记为已修改,尽管以下更改 被认为是套件修改:

一旦被修改,具有未发布修改的套件将在 资源管理器 窗口中获得一个修改图标:

资源管理器窗口,具有可识别未发布包更改的图标。

添加或更新配置

您可以在套件的根部包含 实例属性 来自定义其行为。当您发布一个套件时,当前的属性/值集合将成为该套件的 默认配置。在任何给定的套件 副本 上,那些属性值可以按实例更改,并且那些更改通过 粗体斜体 被标记。在套件副本被 更新 时,修改的配置值将被保留,而其他属性将被更新为最新的默认值。

属性窗口的属性部分显示一个属性值被修改且通过粗体斜体标记。

嵌套套件

您可以将套件嵌套在其他套件内,以维护和协作复杂层次结构,例如一系列可以独立修改的车辆机械。

如果您修改了嵌套套件,则将嵌套套件 父套件视为已修改。在您被允许发布对其 套件的更改之前,必须先 发布更改 到任何 嵌套 套件,因为发布父套件会将其标记为当前/未修改,并与嵌套套件的修改发生冲突。

套件脚本

每个 未修改 套件中的脚本都是只读的,并在顶部显示通知,并带有超链接用于解锁脚本。

一个脚本选项卡,有一个黄色通知,您可以点击它以修改处于未修改状态的套件中的脚本。

点击超链接:

  • 无论您是否编辑脚本,都会将套件标记为已修改。
  • 从套件中的 其他 脚本中移除通知/超链接。

一旦套件被发布并移动到 未修改 状态,其下的脚本变为只读状态,并带有修改的超链接。

发布套件更改

您可以将对套件的任何更改发布为新版本,使您的更新对整个场所和所有游戏中其他套件副本可用。在发布场所之前并 要求发布一个已修改的套件,因为修改版本将与场所一起保存,以备将来迭代使用。

要将更改发布到套件:

  1. 资源管理器 窗口或 3D 视口中,右键单击已修改的副本并选择 发布到套件

  2. 如果套件副本已开启 自动更新,则在您打开包含它们的场所时,它会立即拉取更新版本。其他副本会得到一个“下载”符号,表示有更新可用。您可以 单独更新批量更新 所有副本。

    旁边有潜在更新的套件的图标。
  3. 可选
    添加您更改的描述:

    1. 右键单击套件并选择 套件详情
    2. 资产配置 窗口中,选择 版本
    3. 在您最近的更改下,选择 添加
    4. 描述您的更改,然后单击 提交 按钮。

更新过时副本

您可以将过时的套件副本更新为最新版本,或者继续使用旧版本。

  1. 资源管理器 窗口中,通过“下载”符号找到过时的副本。您也可以在 3D 视口中选择过时的副本。

    旁边有潜在更新的套件的图标。
  2. 右键单击一个过时的副本并选择 获取最新套件。您还可以选择多个套件,右键单击并选择 获取所选套件的最新版本

批量更新

大量使用套件可能会导致游戏中多个场所的许多套件副本。除了 单独同步自动更新,您还可以通过 批量更新 更新所有套件副本。

  1. 推荐
    关闭其他开放任何游戏场所的 Studio 实例;这可以防止另一个未保存的地方覆盖您的更新。
  2. 资源管理器 窗口或 3D 视口中,右键单击所需的套件并选择 全部更新
  3. 选择游戏中的所有场所或某些子集场所,然后单击 更新

自动更新

为了使同步更容易,您可以设置套件副本在发布新版本时自动更新。套件副本的自动更新将在 Studio 中打开场所时进行。

  1. 资源管理器 窗口中,展开套件的层次树并选择其 PackageLink 对象。

    资源管理器窗口中一个套件的特写视图,其 PackageLink 对象被突出显示。
  2. 属性 窗口中,启用 AutoUpdate 属性。如果您有 嵌套套件,此属性仅适用于最高层的父套件,这意味着自动更新仅在 套件被更新时发生。

共享和访问级别

您可以授予朋友、游戏、小组或特定小组用户角色的权限,以便他们可以在其创作中自由使用您的套件。有关资产访问的更多信息,请参见 资产隐私

要更改合作者(例如朋友或小组)的包权限:

  1. 资源管理器 窗口、工具箱资产管理器 中,右键单击所需的套件,并选择 包选项 ⟩ 套件详情

  2. 资产配置 窗口中,选择 权限

  3. 使用搜索栏,输入并选择您想授予使用您套件权限的合作者,然后选择权限级别。

    权限描述
    使用和查看该合作者可以使用和查看(但不能编辑)当前和以前的套件版本。一旦您赋予合作者此能力,您无法撤销他们对已插入游戏副本的访问;撤销访问防止重新插入或套件更新,但他们数据模型中的包副本仍然完整。
    编辑该合作者可以使用、查看和编辑当前和以前的套件版本,包括发布对此的更改。

恢复套件更改

您可以一次性 恢复未发布的更改,或者将套件恢复到以前的 版本,或者恢复对特定 配置 的更改,而不是逐个撤销整系列的套件更改。

恢复未发布的更改

要撤销一整系列 未发布 的更改:

  1. 资源管理器 窗口中,通过包图标上的点查找已修改的副本。您也可以在 3D 视口中选择已修改的副本。

    资源管理器窗口,具有可识别未发布包更改的图标。
  2. 右键单击单个修改的副本并选择 撤销对套件的更改,或者选择多个副本(至少有一个已修改),右键单击并选择 撤销对所选套件的更改

恢复到发布的版本

要将套件恢复到 以前发布的 版本:

  1. 资源管理器 窗口、工具箱资产管理器 中,右键单击所需的套件并选择 包选项 ⟩ 套件详情
  2. 资产配置 窗口中,选择 版本。窗口显示每个已发布版本的详细信息,包括出版的日期和时间,以及对更改的任何描述。
  3. 单击您要恢复的版本旁边的对勾,然后单击 提交

恢复配置

要将任何 配置 属性恢复为其默认值,请从 属性 窗口中的 属性 部分的选项菜单中选择 重置

属性窗口的属性部分,属性的选项菜单已展开。

比较套件版本

当一个套件有多个版本时,您可以使用差异查看器比较版本之间的更改。该工具有一个套件层次菜单,使用相应的图标指示版本之间所有添加、删除或修改的实例,包括以下功能:

  • 视觉概览 显示在不同相机位置下 3D 渲染的视觉差异。它是根对象是 3D 对象(模型、部件)的套件的默认视图,当前仅适用于根对象。

  • 属性 显示属性和属性的更改。它是根对象是非 3D 对象(脚本、灯光、2D 对象)的套件的默认视图,并且适用于套件中的所有实例。

  • 脚本 显示逐行脚本差异。它适用于包含脚本的套件,无论脚本是否是根对象。

要比较套件版本:

  1. 资源管理器 或 3D 视口中,右键单击目标套件并选择 包选项 ⟩ 比较套件版本

  2. 该窗口默认比较您本地副本与最新版本之间的更改。使用两个下拉菜单比较不同版本。

    示例差异查看器的特写视图。比较设置被突出显示。
  3. 选择版本后:

    1. 如适用,要比较根模型的视觉渲染,请选择 视觉概览 选项卡,并调整相机控制以获取所需角度。控制在各个视图之间是同步的:

      • 使用左键单击平移相机。
      • 使用右键单击旋转相机。
      • 使用鼠标滚轮进行放大和缩小。
      • 使用键盘快捷键 F 重新居中。
    2. 若要比较实例的属性和属性,选择该实例并选择 属性 选项卡。

    3. 要比较作为脚本或包含脚本的套件的脚本差异,请使用 脚本 选项卡。

©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。