FreeMinecraftModels 安装设置
FreeMinecraftModels 仍然支持手动导入 .bbmodel，但当前的设置流程已支持 Nightbreak 并以菜单驱动。
前置条件
- 服务器需运行 Java 21
- FreeMinecraftModels 已安装并至少启动过一次，以便生成其数据文件夹
- 一种向玩家分发生成的资源包的方式
ResourcePackManager 是推荐的分发途径，因为 FreeMinecraftModels 只负责生成资源包，并不会自行托管。
首次流程
| 命令 | 用途 |
|---|---|
/fmm setup | 仅玩家可用的内容管理 / 首次引导菜单（首次启动时玩家被引导去使用的命令） |
/fmm recommendedplugins | 浏览与 FreeMinecraftModels 搭配良好的配套插件 |
/fmm downloadall | 批量安装助手：下载最新的插件更新以及所有可访问的 Nightbreak 包 |
/fmm downloadallcontent | 可访问 Nightbreak 包的批量安装助手（仅内容） |
/fmm updatecontent | 已过期 Nightbreak 包的批量更新助手 |
/fmm downloadpluginupdate | 仅下载最新的插件 jar 更新 |
/nightbreaklogin <token> | 共享的 Nightbreak 令牌注册 |
如果 config.yml 中仍为 setupDone: false，拥有 freeminecraftmodels.* 权限的玩家在登录时会收到一次性提醒，指引其前往 /fmm setup（打开它会永久关闭该消息）。该提醒还会一并提示 /fmm admin 和 /fmm。
推荐工作流程
- 安装 FreeMinecraftModels 并启动服务器一次。
- 使用
/nightbreaklogin <token>关联 Nightbreak 令牌。 - 打开
/fmm setup查看可用包及当前状态。 - 如果你想安装所有令牌可访问的官方包，使用
/fmm downloadall（这同时也会拉取最新的插件 jar 更新）。 - 之后使用
/fmm updatecontent来刷新过期的官方包。 - 确保玩家能收到生成的
output/FreeMinecraftModels.zip资源包，通常通过 ResourcePackManager 分发。
如果你更希望让服务器自行获取更新，可在 config.yml 中设置 nightbreak.autoDownloadPluginUpdates: true（默认 false）。下载的插件和内容更新会在下次重启后生效。参见 配置。
手动模型导入
直接的模型导入仍可通过以下路径进行：
plugins/FreeMinecraftModels/imports
这种方式仍适用于：
- 本地开发
- 不打算从 Nightbreak 拉取的自定义模型
- 在运行
/fmm reload时，将.bbmodel内容转换为当前运行时格式
无论是手动导入还是下载官方包，最终都需要经过一次重载/导入步骤，才能重建运行时的模型列表和资源包。
官方内容包
当前插件预装了五个 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: 的模型），可以使用 Lua 物品脚本。
资源包提醒
FreeMinecraftModels 始终需要将其生成的资源包以某种方式送达客户端。
请参阅 资源包输出 了解当前的输出路径及与 ResourcePackManager 的集成。