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 包