Nightbreak 设置与内容管理
本页是 Nightbreak 托管插件共用的设置指南。
它直接适用于：
- EliteMobs
- BetterStructures
- FreeMinecraftModels
- EternalTD
这些插件现在共享相同的整体生命周期：
- 安装插件以及任何必需的硬依赖。
- 启动服务器一次，以生成文件和菜单。
- 如果插件提供首次设置命令，先运行该命令。
- 使用
/nightbreaklogin <token>绑定 Nightbreak 令牌。 - 使用插件设置菜单浏览、安装、启用、禁用和更新内容。
- 如果你想更快完成初始部署，可使用插件的批量下载或批量更新命令。
MagmaCore 实际共享了什么
MagmaCore 是 Nightbreak 托管流程背后的共享层。它提供：
- 共享的
/nightbreaklogin <token>命令 - 存储在
plugins/MagmaCore/nightbreak.yml中的共享令牌 - 插件设置菜单所使用的共享菜单基础能力
- Nightbreak 访问、版本和下载检查的共享逻辑
- 会把文件下载到所属插件
imports文件夹中的共享批量下载逻辑
像 /em initialize 或 /bs setup 这样的插件专属命令，仍然由各插件自行实现。MagmaCore 提供的是这些命令所依赖的共享系统。
共享的首次设置模式
当前大多数 Nightbreak 托管插件都提供：
| 插件 | 首次设置命令 | 设置菜单 | 批量安装 | 批量更新 |
|---|---|---|---|---|
| EliteMobs | /em initialize | /em setup | /em downloadall | /em updatecontent |
| BetterStructures | /bs initialize | /bs setup | /bs downloadall | /bs updatecontent |
| FreeMinecraftModels | /fmm initialize | /fmm setup | /fmm downloadall | /fmm updatecontent |
| EternalTD | /etd initialize | /etd setup | /etd downloadall | /etd updatecontent |
initialize 是首次使用时的引导流程。它不能替代插件自己的设置菜单或内容管理命令。
MagmaCore 还带有一套独立的插件启动初始化系统，但那与本页记录的、面向玩家的 initialize 命令不是同一回事。
推荐的服主操作流程
1. 先安装插件
将插件 jar 和任何必需的硬依赖放入 plugins/，然后先启动服务器一次。
2. 运行首次设置流程
如果插件提供 initialize 命令，优先先运行它。当前菜单的设计目标是：
- 标记首次设置已完成
- 引导你完成 Nightbreak 账号绑定
- 指向当前的设置菜单
- 说明何时仍然适合使用手动导入
首次菜单行为本身是共享的，但具体命令名和后续逻辑仍然因插件而异。
3. 绑定你的 Nightbreak 账号
前往 Nightbreak 账号页面，获取服务器令牌，然后运行：
/nightbreaklogin <token>
该令牌通过 MagmaCore 共享，因此同一台服务器上，一个已绑定的令牌可供所有兼容的 MagmaGuy 插件复用。
4. 日常内容管理使用设置菜单
设置菜单是以下状态的当前事实来源：
- 包状态
- 访问权限状态
- 已安装与仅下载的内容
- 需要修复的部分安装内容
- 已过期内容
- 按类别筛选的内容
如果你已绑定令牌，推荐通过设置菜单来安装和更新内容。
5. 需要速度时使用批量安装或更新
如果你想快速部署服务器，使用 downloadall。如果你想更新所有过期内容，使用 updatecontent。
共享批量下载器只会尝试处理满足以下条件的 Nightbreak 托管包：
- 具有 Nightbreak slug
- 已绑定令牌有权限访问
- 尚未下载，或已被标记为过期
当前大多数插件在批量下载成功后都会自动重载。
共享概念
已下载 与 已安装
一个内容包可以已经存在于本地，但尚未启用。其具体含义会因插件略有不同，但设置菜单显示的状态比 imports 中是否存在 zip 更重要。
批量下载的内容也会先进入插件的 imports 文件夹，然后再完成插件自己的导入或重载步骤。
基于访问权限的内容
设置菜单现在可以区分以下状态：
- 你的令牌可访问的内容
- 需要购买或解锁的内容
- 已安装
- 仅部分安装
- 已下载但被禁用
- 已过期
手动导入仍然可用
Nightbreak 托管插件依然支持手动导入流程。手动导入现在是备用方案，而不是默认方案。请参见手动导入与游戏内管理。
不使用此流程的插件
并非本 Wiki 中的每个插件都使用 Nightbreak 托管的可下载内容。
- BetterFood 不使用 Nightbreak 包管理
- ResurrectionChest 不使用 Nightbreak 包管理
- WorldCannon 不使用 Nightbreak 包管理
- ResourcePackManager 管理的是资源包，而不是 Nightbreak DLC 包