跳到主要内容

BetterStructures 内容包

BetterStructures 现在将官方内容作为托管包处理,而不是纯手动导入工作流程。

主要命令

命令用途
/bs initialize首次设置流程
/bs setup浏览和管理包状态
/bs downloadall下载插件更新(如有)以及所有可用内容,然后重新加载
/bs downloadallcontent仅下载所有可用内容(不更新插件)
/bs updatecontent更新过期内容(别名:/bs updateallcontent
/bs forcereinstallcontent <package|all>即使已安装的版本已经是最新的也重新下载内容 —— 用于修复损坏或被部分删除的内容包
/bs recommendedplugins列出与 BetterStructures 配合良好的配套插件
/nightbreaklogin <token>共享 Nightbreak 令牌注册

这些内容命令来自内置于 BetterStructures 的共享 MagmaCore Nightbreak 系统,因此整套生命周期(令牌检查、访问检查、下载、自动重新加载)在所有 MagmaGuy 插件中都是一致的。

包类型

每个包都会声明一个 contentPackageType,设置菜单会为每种类型提供一个筛选项:

contentPackageType设置菜单筛选项文件落入
STRUCTURE(默认)Structure Packsplugins/BetterStructures/schematics/<folderNameV2>
MODULARModule Packsplugins/BetterStructures/modules/<folderNameV2>

使用 /bs setup 来筛选和检查包,而不是依赖旧的静态列表。

包配置字段

每个包都由 plugins/BetterStructures/content_packages 中的一个配置文件描述。你很少需要手动编辑它们 —— 它们随插件一起分发,也是插件跟踪包状态的方式 —— 但各字段如下:

默认值描述
isEnabledtrue该包的内容是否处于激活状态。当你从设置菜单安装或卸载时会自动为你切换。
name设置菜单中显示的名称
description设置菜单中显示的描述行
downloadLink该包的下载来源
version0本地内容版本,用于与远程版本比较以判断该包是否过期
folderNameV2该包文件所在的子文件夹,根据类型位于 schematicsmodules 之下
contentPackageTypeSTRUCTURESTRUCTUREMODULAR
nightbreakSlug用于访问检查、下载以及作为 /bs forcereinstallcontent 选择器的 Nightbreak 标识符

安装或卸载 STRUCTURE 包时,还会翻转其文件夹内每个原理图配置的 isEnabled,然后触发一次重载。MODULAR 包仅在包级别进行开关切换。

包状态

根据包和你的令牌状态,BetterStructures 可以区分:

  • 已安装的内容
  • 已下载但未启用的内容
  • 过期的内容
  • 需要 Nightbreak 访问权限的内容

这意味着设置菜单现在是确认插件认为已安装内容的最佳方式。

手动导入备选方案

手动导入仍然使用:

plugins/BetterStructures/imports

保持包的 zip 文件完整,然后在需要时重新加载 BetterStructures。手动导入仍然受支持,但不再是主要的文档化工作流程。