MegaBlock Survivors 安装设置

MegaBlock Survivors 的设置流程围绕 Nightbreak 管理的内容包构建，并通过 FreeMinecraftModels 提供可选的模型支持。

需求

• Java 21
• 基于 1.21 API 的 Paper/Spigot 兼容服务器

可选集成：

• FreeMinecraftModels 用于自定义怪物和武器模型（软依赖）

MegaBlock Survivors 创建的内容

启动时，MegaBlock Survivors 会初始化或使用以下路径：

plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt

配置

config.yml 包含：

键	类型	默认值	描述
setupDone	boolean	false	追踪首次设置引导是否已完成

首次设置提醒

当 setupDone 为 false 时，插件会在拥有 megablocksurvivors.* 权限的玩家加入时显示首次设置提醒。这将引导他们完成初始内容下载。

推荐的首次设置流程

1. 安装 MegaBlock Survivors 并首次启动服务器。
2. 使用 /nightbreaklogin <token> 关联你的 Nightbreak 账户。
3. 运行 /mbs downloadall 将所有可访问的 MegaBlock Survivors 内容包下载到 plugins/MegaBlockSurvivors/imports。
4. 随时运行 /mbs setup 来浏览、启用、禁用或更新单个内容包。
5. 下载内容后运行 /mbs reload 以加载新的地图和资源。

/nightbreaklogin <token> 是共享的 Nightbreak/MagmaCore 账户流程的一部分，不是 MegaBlock Survivors 的 plugin.yml 中声明的命令。

内容包

内容包通过 content_packages/ 文件夹中的 YAML 文件配置。每个包可以定义：

字段	类型	描述
isEnabled	boolean	内容包是否启用
name	string	内容包的显示名称
description	string list	描述行
downloadLink	string	手动下载地址
version	integer	包版本号
nightbreakSlug	string	用于自动下载的 Nightbreak 内容标识
schematicFiles	string list	包含的原理图文件
worldFolders	string list	包含的世界文件夹
worldContainerFolders	string list	包含的世界容器文件夹
modelFolders	string list	FreeMinecraftModels 的模型文件夹
markerFileName	string	用于检测包是否已安装的标记文件
category	enum	FREE、PREMIUM 或 RESOURCES
toggleable	boolean	是否可以开启/关闭此包

版本更新通知

当插件检测到版本更新（通过与 version.txt 比较）时，会在控制台和所有在线 OP 处通知版本变更。