跳到主要内容

BetterStructures 设置

BetterStructures 仍然支持手动导入,但当前推荐的工作流程是 Nightbreak 优先且在游戏内操作。

要求

  • WorldEdit 或 FAWE 兼容的原理图支持
  • 当前构建线所需的 Java 21 运行时

推荐工作流程

  1. 安装 BetterStructures 和 WorldEdit,然后启动服务器一次。
  2. 运行 /bs initialize
  3. 使用 /nightbreaklogin <token> 链接 Nightbreak 令牌。
  4. 打开 /bs setup 浏览结构包和模块包。
  5. 使用 /bs downloadall 进行快速引导(它会抓取待处理的插件更新和所有内容)。
  6. 当有包更新可用时,使用 /bs updatecontent

首次设置菜单

/bs initialize 会打开一个小型的引导菜单。在其中任一选项被选择之前,每个持有 betterstructures.* 的玩家都会在加入十秒后收到一条提醒消息。这三个选项都会通过在 config.yml 中写入 setupDone: true 来把设置标记为已完成。

选项作用
Recommended Setup(推荐设置)把设置标记为已完成,并打印三步流程:在 nightbreak.io/account 获取令牌、用 /nightbreaklogin <token> 绑定它,然后打开 /bs setup
Manual Setup(手动设置)把设置标记为已完成,并把内容管理交给你自己,同时指向 /bs setupimports 文件夹。
Use Current Content(使用当前内容)关闭该提示并保留已安装的内容,然后执行一次重载。如果没有安装任何内容,它会告知你并指向 /bs setup

如果既没有安装 WorldEdit 也没有安装 FastAsyncWorldEdit,第三个格子会被替换成一条警告,提示你在继续之前先安装其中之一。

设置菜单

/bs setup 会打开一个分页菜单,其中的包被分为两个筛选项:Structure Packs(结构包)和 Module Packs(模块包)。每个包都会显示它是已安装、已下载但未启用、已过期,还是需要 Nightbreak 访问权限,点击它即可安装/更新。

除了包之外,菜单还会显示内置于 BetterStructures 的共享 MagmaCore 控制项:

  • Plugin Update(插件更新)—— 显示是否有更新的 BetterStructures 版本可用,并允许你下载它(重启后应用)。该检查会在启动时自动运行,并大约每小时刷新一次,因此刚启动的服务器可能会短暂显示 "Plugin Update Pending"。
  • Recommended Plugins(推荐插件)—— 打开配套插件推荐视图(与 /bs recommendedplugins 相同)。当列出的所有推荐项都已安装后,该图标会变绿。
  • Download All Content(下载全部内容)—— 追加在包列表之后的批量入口,等同于 /bs downloadall
  • Automatic Updates(自动更新)—— 控制 BetterStructures 是否在启动时自动下载插件和内容更新的工具栏开关。该开关默认关闭,由 config.yml 中的 nightbreak.autoDownloadPluginUpdates 键支持。已下载的插件更新仍需重启才能应用。
  • Installation tips(安装提示)—— 信息按钮,会把设置指南、账户令牌页面、支持 Discord 以及可点击的设置命令打印到聊天栏中。

在内容重载进行期间,/bs setup 会被拒绝执行,因为该菜单读取的正是重载工作线程正在重建的那些注册表。请等待重载报告成功后再打开它。

如果某个包的文件损坏或被部分删除,/bs setup 不会修复它们 —— 它比较的是版本,会认为该包已是最新。此时请改用 /bs forcereinstallcontent <package|all>

手动导入备选方案

手动导入仍然通过以下方式工作:

plugins/BetterStructures/imports

保持包的 zip 文件完整,然后在需要时运行 /bs reload/bs reload 会把该文件夹中的所有内容作为重载的一部分导入,因此你无需重启就能让放进去的包生效。

请注意,把文件留在 imports 中会拖慢启动:当该文件夹非空时,BetterStructures 会先等待其 softdepend 中列出的插件完成初始化再启动,因为把内容导入另一个插件的数据文件夹意味着那个插件必须被重新加载。一旦该文件夹重新变空,BetterStructures 就会不再等待、直接初始化。

参见共享指南:手动导入 vs 游戏内管理