手动导入与游戏内管理
Nightbreak 管理的插件现在优先使用游戏内设置和内容管理，但手动导入仍然作为备用方案存在。
推荐：游戏内管理
当您需要以下功能时，请使用设置菜单加上已关联的 Nightbreak 令牌：
- 访问感知的内容浏览
- 一键或菜单引导的安装
- 批量下载和更新命令
- 自动过时包检查
- 与当前代码库匹配的工作流程
以下插件的首选路径：
- EliteMobs
- BetterStructures
- FreeMinecraftModels
- EternalTD
- ResurrectionChest
- WorldCannon
这六个插件都运行共享导入器，因此这六个也都接受下面的手动备用方案。
备用方案：手动导入
手动导入在以下情况下仍然有用：
- 您已经下载了包的 zip 文件
- 您正在服务器之间移动文件
- 您想在测试期间脱离 Nightbreak 离线工作
- 包被有意在游戏内下载路径之外分发
Nightbreak 的批量下载也会进入插件的 imports 文件夹。区别在于游戏内路径会为您处理访问检查和下载步骤。
导入文件夹映射
| 插件 | 导入文件夹 |
|---|---|
| EliteMobs | plugins/EliteMobs/imports |
| BetterStructures | plugins/BetterStructures/imports |
| FreeMinecraftModels | plugins/FreeMinecraftModels/imports |
| EternalTD | plugins/EternalTD/imports |
| ResurrectionChest | plugins/ResurrectionChest/imports |
| WorldCannon | plugins/CannonRTP/imports |
WorldCannon 的插件文件夹名为 CannonRTP —— 这是该插件的内部名称，它的 imports 文件夹和已安装的内容都在这里。
手动导入规则
- 除非插件特定文档另有说明，否则保持下载的包为压缩状态。
- 将包放入正确的
imports文件夹。 - 如果插件特定文档要求，请重新加载或重启插件。
- 之后重新打开设置菜单以确认安装状态。
共享导入器可以处理：
- 放置在
imports中的.zip包 - 如果包含
pack.meta，则可处理某些已解压的文件夹 FreeMinecraftModels的.bbmodel文件
压缩包会被解压到 imports 内部的一个隐藏暂存文件夹中，并且只从那里安装。导入器会在成功或失败之后删除该暂存文件夹，因此正常的导入失败只会留下原始 zip 供重试，而不会在旁边留下一个可见的、解压了一半的包。
导入器接受什么
pack.meta 决定内容去向
一个包可以在顶层附带一个 pack.meta 文件，写明它所针对的插件平台 —— elitemobs、betterstructures、freeminecraftmodels、eternaltd、extractioncraft、resurrectionchest、megablocksurvivors 或 worldcannon（也接受 cannonrtp 或 world_cannon）。这个名称按不区分大小写的方式匹配，并会忽略首尾空白、行尾符以及开头的字节顺序标记（BOM），因此用 Windows 编辑器保存的文件也能正常工作。
如果压缩包中没有 pack.meta，它会被视为放入哪个插件的 imports 文件夹，就属于哪个插件的包。
如果 pack.meta 写的是导入器不认识的名称，该包会被拒绝，zip 会保留在 imports 中，方便你修正后重试。
顶层文件夹名称必须能被识别
导入器会按名称把包中的每个顶层文件夹路由到相应目标。有些名称对所有平台都适用：
| 文件夹 | 去向 |
|---|---|
worldcontainer | 服务器的世界容器（每个子文件夹会成为一个世界） |
models 或 modelengine | FreeMinecraftModels 的 models 文件夹；若只安装了 ModelEngine，则是 ModelEngine 的 blueprints 文件夹 |
scripts | plugins/FreeMinecraftModels/scripts |
freeminecraftmodels、elitemobs、betterstructures | 对应插件的数据文件夹（plugins/FreeMinecraftModels、plugins/EliteMobs 或 plugins/BetterStructures）。文件夹的结构应与数据文件夹相同，例如 freeminecraftmodels/enchantments/ |
pack.meta | 忽略 —— 它是元数据，不是内容 |
freeminecraftmodels/models/ 下的模型会进入 FreeMinecraftModels 实际读取的模型文件夹，包括旧安装中的 Models 文件夹。
其余所有顶层文件夹都按包所针对的平台解析。除非表中另有说明，每个文件夹都会进入该插件数据文件夹中的同名文件夹：
| 平台 | 属于该插件的文件夹 | 属于其他插件的文件夹 |
|---|---|---|
elitemobs | custombosses、customitems、customtreasurechests、content_packages（dungeonpackages 也会进入这里）、customevents、customspawns、customquests、customarenas、npcs、npc_scripts、behaviors、transport_routes、wormholes、powers、world_blueprints、resource_pack、enchantments | 无 |
betterstructures | content_packages、schematics、spawn_pools、components、modules、module_generators、treasures、generators | EliteMobs：custombosses、customitems、customtreasurechests、powers、enchantments |
freeminecraftmodels | content_packages、recipes、enchantments | EliteMobs：customitems，未启用 EliteMobs 时跳过 |
eternaltd | npcs、levels、waves、worlds | 无 |
resurrectionchest | content_packages | 无 |
worldcannon | content_packages、cannons（fun_rtps 也会进入这里），以及对应数据文件夹本身（plugins/CannonRTP）的 cannonrtp、worldcannon 或 world_cannon | 无 |
extractioncraft | content_packages、loot_pools、loot_tables | EliteMobs：customquests、npcs、custombosses、customitems、customtreasurechests、powers。BetterStructures：spawn_pools、components、modules、module_generators |
megablocksurvivors | content_packages、schematics、worlds、content_markers，以及对应数据文件夹本身（plugins/MegaBlockSurvivors）的 megablocksurvivors | 无 |
enchantments/ 文件夹存放附魔定义及其本地 Lua 效果，从不使用全局 scripts/ 路径。如需在其他平台的包中附带 FreeMinecraftModels 附魔，请使用 freeminecraftmodels/enchantments/。
如果某个顶层文件夹在该平台上无法被导入器识别，那么整个包都会被拒绝，而不是部分安装，压缩包也会被保留。如果你的包无法导入，控制台会指出是哪个文件夹有问题。
导入到其他插件的文件夹
插件会在启动或重载时读取其内容文件夹。当某个包把文件导入到其他插件的文件夹时：
- FreeMinecraftModels 会自动重载其导入的内容。
- BetterStructures 会在自身启动完成后重载新内容。如果 10 分钟后它仍在启动，控制台会提示你运行
/bs reload。 - 导入了 EliteMobs 内容的 BetterStructures 包会重载 EliteMobs。
其他情况下，请重载或重启拥有该文件夹的插件。
更新已加载的世界
替换已加载的世界前，导入器会将其中的玩家传送至另一个已加载世界的出生点，并请求服务器卸载目标世界。如果没有其他可用世界、传送失败或服务器拒绝卸载，导入会停止并保留压缩包。重试前，请将玩家移出并解决报告的问题。
导入中的已停用文件
所属插件会在导入前后检查已停用的配置格式。匹配的文件保存在 plugins/MagmaCore/outdated files/ 中，位于活动内容文件夹之外。如果旧包安装了已停用的内容，请下载更新版本。参见已停用的配置文件。
导入失败会回滚
如果回滚不完整，MagmaCore 会保留恢复目录，并记录其路径以及无法还原的目标。请保留这些恢复文件，解决报告的问题后再重试导入。
一次导入会作为单个事务来应用。已有文件在被替换之前会先备份，被替换的世界文件夹是被移到一旁而不是删除，并且中途任何失败都会回滚该包触及过的每一个目标位置。zip 会留在 imports 中，供解决错误后重试。如果回滚本身遇到文件系统错误，控制台会明确报告回滚未完成，并提示你在重试之前先检查日志中记录的目标位置。
只有当导入完全提交之后，压缩包才会被删除。如果你在一次重载之后看到某个包仍然留在 imports 里，那就是导入器在告诉你它没有安装成功 —— 请检查控制台查明原因。
重要区别
游戏内路径
- 令牌感知
- 可以显示锁定和过时的内容
- 批量操作后通常自动重新加载
- 反映当前预期的管理工作流程
手动路径
- 无需游戏内下载访问即可工作
- 需要您自己管理 zip 文件
- 可能仍需要插件重新加载
- 根据插件不同，可能会将内容留在已下载但未启用的状态
- 可能会暴露游戏内访问流程通常在安装时才会显示的包结构问题