手动导入与游戏内管理

Nightbreak 管理的插件现在优先使用游戏内设置和内容管理，但手动导入仍然作为备用方案存在。

备用方案：手动导入

手动导入在以下情况下仍然有用：

您已经下载了包的 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 内部的一个隐藏暂存文件夹中，并且只从那里安装。FMM 会在成功或失败之后清理该暂存文件夹，因此正常的导入失败只会留下原始 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`
`pack.meta`	忽略 —— 它是元数据，不是内容

其余一切都按平台解析（例如 EliteMobs 的 custombosses、customitems 和 content_packages；BetterStructures 的 schematics、spawn_pools 和 components）。

如果某个顶层文件夹在该平台上无法被导入器识别，那么整个包都会被拒绝，而不是部分安装，压缩包也会被保留。如果你的包无法导入，控制台会指出是哪个文件夹有问题。

导入失败会回滚

一次导入会作为单个事务来应用。已有文件在被替换之前会先备份，被替换的世界文件夹是被移到一旁而不是删除，并且中途任何失败都会回滚该包触及过的每一个目标位置。zip 会留在 imports 中，因此重试是安全的。如果回滚本身遇到文件系统错误，控制台会明确报告回滚未完成，并提示你在重试之前先检查日志中记录的目标位置。

只有当导入完全提交之后，压缩包才会被删除。如果你在一次重载之后看到某个包仍然留在 imports 里，那就是导入器在告诉你它没有安装成功 —— 请检查控制台查明原因。

重要区别

游戏内路径

令牌感知
可以显示锁定和过时的内容
批量操作后通常自动重新加载
反映当前预期的管理工作流程

手动路径

无需游戏内下载访问即可工作
需要您自己管理 zip 文件
可能仍需要插件重新加载
根据插件不同，可能会将内容留在已下载但未启用的状态
可能会暴露游戏内访问流程通常在安装时才会显示的包结构问题

推荐：游戏内管理​

备用方案：手动导入​

导入文件夹映射​

手动导入规则​

导入器接受什么​

pack.meta 决定内容去向​

顶层文件夹名称必须能被识别​

导入失败会回滚​

重要区别​

游戏内路径​

手动路径​

推荐：游戏内管理