FreeMinecraftModels 安装设置
FreeMinecraftModels 仍然支持手动导入 .bbmodel 文件，但当前的设置流程是基于 Nightbreak 的菜单驱动方式。
前置条件
- 服务器需要 Java 21 运行时
- 安装 FreeMinecraftModels 并启动一次以生成数据文件夹
- 需要一种将生成的资源包传递给玩家的方式
推荐使用 ResourcePackManager 作为分发方式，因为 FreeMinecraftModels 只负责生成资源包，不会自行托管。
首次设置流程
| 命令 | 用途 |
|---|---|
/fmm initialize | 仅限玩家的首次引导菜单 |
/fmm setup | 仅限玩家的内容管理菜单 |
/fmm downloadall | 批量安装可访问的 Nightbreak 包 |
/fmm updatecontent | 批量更新过期的 Nightbreak 包 |
/nightbreaklogin <token> | 共享 Nightbreak 令牌注册 |
如果 config.yml 中仍然是 setupDone: false，拥有 freeminecraftmodels.* 权限的玩家会收到登录提醒，提示他们运行 /fmm initialize。
推荐工作流程
- 安装 FreeMinecraftModels 并启动服务器一次。
- 运行
/fmm initialize。 - 使用
/nightbreaklogin <token>链接 Nightbreak 令牌。 - 打开
/fmm setup检查可用的包和当前状态。 - 如果要安装令牌可访问的所有官方包，使用
/fmm downloadall。 - 之后使用
/fmm updatecontent刷新过期的官方包。 - 确保玩家收到生成的
output/FreeMinecraftModels.zip资源包，通常通过 ResourcePackManager 实现。
手动模型导入
直接模型导入仍然可以通过以下路径进行：
plugins/FreeMinecraftModels/imports
该路径仍然适用于：
- 本地开发
- 不从 Nightbreak 拉取的自定义模型
- 运行
/fmm reload时将.bbmodel内容转换为当前运行时格式
手动导入和官方包下载都需要在重新加载/导入之后，运行时模型列表和资源包才会重新构建。
官方内容包
当前插件附带两个预制的 Nightbreak 托管包：
BetterStructures Prop PackEliteMobs Prop Pack
这些会显示在 /fmm setup 中，可以使用 /fmm downloadall 批量下载，也可以使用 /fmm updatecontent 更新。
资源包提醒
FreeMinecraftModels 始终需要将其生成的资源包输出以某种方式传递到客户端。
有关当前输出路径和 ResourcePackManager 集成的详细信息，请参阅资源包输出。