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 Packs | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Module Packs | plugins/BetterStructures/modules/<folderNameV2> |
使用 /bs setup 来筛选和检查包,而不是依赖旧的静态列表。
包配置字段
每个包都由 plugins/BetterStructures/content_packages 中的一个配置文件描述。你很少需要手动编辑它们 —— 它们随插件一起分发,也是插件跟踪包状态的方式 —— 但各字段如下:
| 键 | 默认值 | 描述 |
|---|---|---|
isEnabled | true | 该包的内容是否处于激活状态。当你从设置菜单安装或卸载时会自动为你切换。 |
name | — | 设置菜单中显示的名称 |
description | — | 设置菜单中显示的描述行 |
downloadLink | — | 该包的下载来源 |
version | 0 | 本地内容版本,用于与远程版本比较以判断该包是否过期 |
folderNameV2 | — | 该包文件所在的子文件夹,根据类型位于 schematics 或 modules 之下 |
contentPackageType | STRUCTURE | STRUCTURE 或 MODULAR |
nightbreakSlug | — | 用于访问检查、下载以及作为 /bs forcereinstallcontent 选择器的 Nightbreak 标识符 |
安装或卸载 STRUCTURE 包时,还会翻转其文件夹内每个原理图配置的 isEnabled,然后触发一次重载。MODULAR 包仅在包级别进行开关切换。
包状态
根据包和你的令牌状态,BetterStructures 可以区分:
- 已安装的内容
- 已下载但未启用的内容
- 过期的内容
- 需要 Nightbreak 访问权限的内容
这意味着设置菜单现在是确认插件认为已安装内容的最佳方式。
手动导入备选方案
手动导入仍然使用:
plugins/BetterStructures/imports
保持包的 zip 文件完整,然后在需要时重新加载 BetterStructures。手动导入仍然受支持,但不再是主要的文档化工作流程。