EliteMobs 设置
本指南适用于当前的 EliteMobs 10 代码线。
要求
- Minecraft 1.21.4 或更新版本（
plugin.yml声明了api-version: 1.21.4） - Java 21+
- Spigot、Paper 或兼容的分支
当前描述文件要求至少 Minecraft 1.21.4。EliteMobs 也有低于 1.21.0 就禁用插件的内部检查，但这项旧检查不代表当前 JAR 支持 1.21.0–1.21.3。运行较旧的 Minecraft 时，请使用与服务器兼容的历史构建。
FreeMinecraftModels 是可选的，但魔杖、法杖、它们的附魔以及法师职业都需要它。没有它时，EliteMobs 会在启动时记录一条警告，这些功能也无法使用。
首次启动
启动服务器一次，如果 EliteMobs 在首次启动时更新了服务器端的生命值上限设置，则重新启动一次。
启动时，EliteMobs 会从 spigot.yml 中读取 settings.attribute.maxHealth.max。如果该值缺失、不是有限数值或低于 2048，EliteMobs 会把它提升到 2048 并替你保存 spigot.yml。精英怪的生命值缩放需要这个上限空间，因此在该值被写入之后请重启服务器。如果保存失败，控制台会提示你手动提高该值。
推荐工作流程
- 安装 EliteMobs 并启动服务器一次。
- 以管理员身份在游戏内运行
/em initialize并选择预设。 - 使用
/nightbreaklogin <token>关联 Nightbreak 令牌。 - 打开
/em setup。 - 如果你想快速引入官方内容，使用
/em downloadall。 - 当已安装的包被标记为过时时，使用
/em updatecontent。
initialize vs setup
/em initialize是首次引导流程。/em setup是持续使用的内容管理界面。
不要将它们视为可互换的。
/em initialize 会询问什么
首次引导菜单提供信息按钮和三个预设。每个预设都会将设置标记为已完成，显示后续消息，再重载插件。“推荐”和“仅内容”提供账号设置、/em setup、内容浏览、wiki 设置指南和 Discord 的入口。“无成长体系”显示自己的警告和支持说明。
| 预设 | 效果 |
|---|---|
| 推荐 | 自然精英怪生成开启、技能系统开启、EliteMobs 战利品开启、行动事件和定时事件开启 |
| 仅内容 | 自然精英怪生成关闭、行动事件和定时事件关闭、技能系统开启、EliteMobs 战利品开启；已编写的内容，如已安装副本、Boss 和 NPC，仍可使用 |
| 无成长体系（不推荐） | 自然精英怪生成关闭、技能系统关闭、EliteMobs 战利品关闭、行动事件和定时事件关闭。面向那些只想在诸如 BetterStructures 之类插件旁边使用 EliteMobs 内容的服务器 |
每个预设都会写入全部五项设置：MobCombatSettings.yml 中的 doNaturalEliteMobSpawning、skills.yml 中的 skillSystemEnabled、ItemSettings.yml 中的 doEliteMobsLoot，以及 events.yml 中的 actionEventsEnabled 和 timedEventsEnabled。之后切换预设会再次设置它们，因此先选“无成长体系”再选“推荐”，会重新开启技能、战利品和事件。其他设置保持不变。
两个菜单命令都需要玩家执行：elitemobs.initialize 权限用于打开首次引导，elitemobs.setup 权限用于打开内容管理。预设本身不会下载内容。
/em setup 会显示什么
/em setup 使用 MagmaCore 共享设置菜单。它列出已注册 EliteMobs 内容包及其安装/更新状态，添加插件更新和推荐插件条目，并将自动更新控件放在工具栏：
- 插件更新 —— 下载更新的 EliteMobs jar，并按
nightbreak.applyPluginUpdatesWithoutRestart的设置应用（默认：重启后） - 推荐插件 —— 带安装链接的配套插件，也可以通过
/em recommendedplugins查看 - 自动更新开关 —— 在
config.yml中写入nightbreak.autoDownloadPluginUpdates，控制启动时下载插件和内容更新
它还会加入一个"下载全部内容"条目以及三个筛选器：副本、事件和自定义模型。元包会隐藏其子包，以保持列表的可读性。
内容命令
| 命令 | 作用 |
|---|---|
/em downloadall | 检查/下载插件更新，然后请求缺失或过时的包；每次内容下载都检查账号访问权 |
/em downloadallcontent | 请求缺失或过时的包并检查账号访问权，不更新插件 |
/em updatecontent（别名 /em updateallcontent） | 仅限已安装且已过时的包 |
/em downloadpluginupdate | 仅下载 EliteMobs jar |
/em applypluginupdate | 立即应用已下载的 EliteMobs jar，无需重启 |
/em forcereinstallcontent <package|all> | 按准确的 Nightbreak 包 slug 重新下载，即使已是最新；all 选择检测到的已下载/已安装/过时包。指定 slug 可以修复完全缺失的文件 |
/em setup toggle <package> | 使用包配置文件名，根据当前设置状态安装、卸载、下载/更新，或显示访问说明 |
手动内容下载命令会重载 EliteMobs，以导入已完成的下载。启动时自动下载的内容会等待下次重启后应用。自动插件下载（nightbreak.autoDownloadPluginUpdates: true）需要有效的账号令牌和处于激活状态的赞助者会员资格。
已下载的插件 jar 会在下次重启后使用，除非 config.yml 中的 nightbreak.applyPluginUpdatesWithoutRestart 设为 when-empty 或 immediately。/em applypluginupdate 可按需切换到已下载的 jar。切换会重载 EliteMobs 及依赖它的 MagmaGuy 插件，并结束正在进行的 Boss 战、竞技场和副本实例。若有其他作者的插件将 EliteMobs 列为依赖或软依赖，切换会被阻止，此时请重启服务器。完整行为请参阅免重启应用更新。
手动导入
手动导入仍然使用：
plugins/EliteMobs/imports
该路径仍然有效，但 Nightbreak 感知的设置流程现在是主要的文档化路径。
参见：