BetterStructures 设置
BetterStructures 仍然支持手动导入，但当前推荐的工作流程是 Nightbreak 优先且在游戏内操作。
要求
- WorldEdit 或 FAWE 兼容的原理图支持
- 当前构建线所需的 Java 21 运行时
推荐工作流程
- 安装 BetterStructures 和 WorldEdit，然后启动服务器一次。
- 运行
/bs initialize。 - 使用
/nightbreaklogin <token>链接 Nightbreak 令牌。 - 打开
/bs setup浏览结构包和模块包。 - 使用
/bs downloadall进行快速引导（它会抓取待处理的插件更新和所有内容）。 - 当有包更新可用时，使用
/bs updatecontent。
首次设置菜单
/bs initialize 会打开一个小型的引导菜单。在其中任一选项被选择之前，每个持有 betterstructures.* 的玩家都会在加入十秒后收到一条提醒消息。这三个选项都会通过在 config.yml 中写入 setupDone: true 来把设置标记为已完成。
| 选项 | 作用 |
|---|---|
| Recommended Setup（推荐设置） | 把设置标记为已完成，并打印三步流程：在 nightbreak.io/account 获取令牌、用 /nightbreaklogin <token> 绑定它，然后打开 /bs setup。 |
| Manual Setup（手动设置） | 把设置标记为已完成，并把内容管理交给你自己，同时指向 /bs setup 和 imports 文件夹。 |
| Use Current Content（使用当前内容） | 关闭提示并保留当前内容。如果原理图注册表非空，就执行重载；否则会报告没有已安装的内容，并指向 /bs setup。这项检查不统计模块。 |
如果既没有安装 WorldEdit 也没有安装 FastAsyncWorldEdit，第三个格子会被替换成一条警告，提示你在继续之前先安装其中之一。
设置菜单
/bs setup 会打开一个分页菜单，提供 Structure Packs（结构包）和 Module Packs（模块包）两个筛选项。每个包都会显示已安装、已下载但未启用、已过期或需要 Nightbreak 访问权限等状态。点击时的操作取决于状态：下载、安装、更新、卸载或显示访问信息。
除了包之外，菜单还会显示内置于 BetterStructures 的共享 MagmaCore 控制项：
- Plugin Update（插件更新）—— 显示是否有更新的 BetterStructures 版本可用，并允许你下载它。重启后会应用该更新；如果运行
/bs applypluginupdate，或在config.yml中把nightbreak.applyPluginUpdatesWithoutRestart设为when-empty或immediately，则会更早应用。该检查会在启动时自动运行，并大约每小时刷新一次，因此刚启动的服务器可能会短暂显示 "Plugin Update Pending"。 - Recommended Plugins（推荐插件）—— 打开配套插件推荐视图（与
/bs recommendedplugins相同）。当列出的所有推荐项都已安装后，该图标会变绿。 - Download All Content（下载全部内容）—— 追加在包列表之后的批量入口，等同于
/bs downloadall。 - Automatic Updates（自动更新）—— 控制 BetterStructures 是否在启动时自动下载插件和内容更新。该开关默认关闭，对应
config.yml中的nightbreak.autoDownloadPluginUpdates。自动下载的内容会暂存到下次重启时应用，不会触发即时重载。已下载的插件更新也通过重启应用，除非nightbreak.applyPluginUpdatesWithoutRestart设为when-empty或immediately（参见 配置）。 - Installation tips（安装提示）—— 信息按钮，会把设置指南、账户令牌页面、支持 Discord 以及可点击的设置命令打印到聊天栏中。
在内容重载进行期间，/bs setup 会被拒绝执行，因为该菜单读取的正是重载工作线程正在重建的那些注册表。请等待重载报告成功后再打开它。
菜单不检查文件完整性。只要路径存在且版本匹配，损坏或被部分删除的包仍可能显示为最新。使用 /bs forcereinstallcontent <package|all> 修复；如果整个包文件夹都已丢失，请直接指定 slug。卸载会保留磁盘上的文件。卸载会把包的 isEnabled 设为 false 并重载，重载时会跳过该包文件夹内（包括子文件夹）的所有原理图和模块。
手动导入备选方案
手动导入仍然通过以下方式工作：
plugins/BetterStructures/imports
保持包的 zip 文件完整，然后在需要时运行 /bs reload。/bs reload 会把该文件夹中的所有内容作为重载的一部分导入，因此你无需重启就能让放进去的包生效。
请注意，把文件留在 imports 中会拖慢启动：当该文件夹非空时，BetterStructures 会先等待其 softdepend 中列出的插件完成初始化再启动，因为把内容导入另一个插件的数据文件夹意味着那个插件必须被重新加载。一旦该文件夹重新变空，BetterStructures 就会不再等待、直接初始化。
参见共享指南：手动导入 vs 游戏内管理。