FreeMinecraftModels 安装设置
FreeMinecraftModels 仍然支持手动导入 .bbmodel，但当前的设置流程已支持 Nightbreak 并以菜单驱动。
前置条件
- 服务器需运行 Java 21
- Minecraft 1.21.4 或更新版本：插件声明
api-version: 1.21.4，无法在更旧版本加载 - FreeMinecraftModels 已安装并至少启动过一次，以便生成其数据文件夹。MagmaCore 已内置在插件 jar 中，无需单独安装
- 一种向玩家分发生成的资源包的方式
ResourcePackManager 是推荐的分发途径，因为 FreeMinecraftModels 只负责生成资源包，并不会自行托管。
首次流程
| 命令 | 用途 |
|---|---|
/fmm setup | 仅玩家可用的内容管理 / 首次引导菜单（首次启动时玩家被引导去使用的命令） |
/fmm recommendedplugins | 浏览与 FreeMinecraftModels 搭配良好的配套插件 |
/fmm downloadall | 批量安装助手：下载最新的插件更新以及所有可访问的 Nightbreak 包 |
/fmm downloadallcontent | 可访问 Nightbreak 包的批量安装助手（仅内容） |
/fmm updatecontent | 已过期 Nightbreak 包的批量更新助手 |
/fmm downloadpluginupdate | 仅下载最新的插件 jar 更新 |
/fmm applypluginupdate | 无需重启服务器即可应用已下载的插件更新 |
/fmm forcereinstallcontent <package|all> | 修复助手：即使版本号显示最新，也重新下载已有内容 |
/nightbreaklogin [token] | 共享的 Nightbreak 账户关联：打印一个用于批准服务器的链接，或保存粘贴的令牌，需要 nightbreak.login 权限 |
/nightbreaklogout | 清除本服务器保存的 Nightbreak 令牌 |
如果 config.yml 中仍为 setupDone: false，拥有 freeminecraftmodels.* 权限的玩家每次登录约 10 秒后，若仍在线，就会收到提醒。打开 /fmm setup 会为整个服务器保存 setupDone: true 并停止后续提醒。消息也会提示 /fmm admin 和 /fmm。完成 /fmm initialize 中的一个选项同样会标记设置完成；这个标记不能证明内容包已安装或送达。
/fmm setup 工具栏中还有一个宠物按钮，用于在装饰性宠物和更多生物两种宠物模式之间切换，并把选择保存到 pets.yml。
推荐工作流程
- 安装 FreeMinecraftModels 并启动服务器一次。
- 使用
/nightbreaklogin将服务器关联到你的 Nightbreak 账户，然后在它打印的链接处批准。 - 打开
/fmm setup查看可用包及当前状态。 - 如果你想安装所有令牌可访问的官方包，使用
/fmm downloadall（这同时也会拉取最新的插件 jar 更新）。 - 之后使用
/fmm updatecontent来刷新过期的官方包。 - 等待初始化成功，并确认玩家收到生成的
output/FreeMinecraftModels.zip，通常通过 ResourcePackManager 分发。生成成功后，FMM 会通知已启用的 ResourcePackManager，但仅有这项通知不能证明资源包已送达客户端。
交互式内容包下载在内容变化后会重载 FMM。下载的插件 jar 会在重启后生效，也可以用 /fmm applypluginupdate 立即应用。/fmm reload 会在重建前验证自定义物品、附魔和道具配方；验证被拒绝时，当前目录仍保持有效。请检查结果，不要直接假定文件已应用。
如果你更希望让服务器自行获取更新，可在 config.yml 中设置 nightbreak.autoDownloadPluginUpdates: true（默认 false）。下载的插件和内容更新会在下次重启后生效。如需在不重启的情况下应用插件更新，请把 nightbreak.applyPluginUpdatesWithoutRestart 设为 when-empty 或 immediately（默认 never）。参见 配置。
手动模型导入
直接的模型导入仍可通过以下路径进行：
plugins/FreeMinecraftModels/imports
这种方式仍适用于：
- 本地开发
- 不打算从 Nightbreak 拉取的自定义模型
- 在运行
/fmm reload时，将.bbmodel内容转换为当前运行时格式
无论是手动导入还是下载官方包，最终都需要经过一次重载/导入步骤，才能重建运行时的模型列表和资源包。
将单独的 .bbmodel 直接放进 imports/。这条路径会把转换后的 .fmmodel 写入模型目录，并保留源导入文件，所以之后重载可能再次转换。它不会同时导入旁边单独的 .yml，也不会递归导入没有 pack.meta 的普通子文件夹。带配套设置或脚本的模型应使用当前的 models/ 和 scripts/ 目录，或正确打包的压缩文件；参见模型制作说明。
官方内容包
当前插件提供五个由 Nightbreak 管理的预制包：
Basic Furniture Pack（道具）BetterStructures Prop Pack（道具）EliteMobs Prop Pack（道具）Craftenmine's Weapons Item Pack（自定义物品）Craftenmine Tools Item Pack（自定义物品）
它们出现在 /fmm setup 中，可用 /fmm downloadall 批量下载，并用 /fmm updatecontent 更新。两个 Craftenmine 物品包是设置了 material: 的自定义物品，使用当前的物品定义与附魔格式。带装备物品脚本的旧包需要更新内容。
资源包提醒
FreeMinecraftModels 始终需要将其生成的资源包以某种方式送达客户端。
请参阅 资源包输出 了解当前的输出路径及与 ResourcePackManager 的集成。