跳到主要内容

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。

推荐工作流​

  1. 安装 FreeMinecraftModels，并启动服务器一次。
  2. 运行 /fmm initialize。
  3. 使用 /nightbreaklogin <token> 绑定 Nightbreak 令牌。
  4. 打开 /fmm setup，检查可用包和当前状态。
  5. 如果你想安装令牌可访问的所有官方包，使用 /fmm downloadall。
  6. 之后使用 /fmm updatecontent 来更新过期的官方包。
  7. 确保玩家能够收到生成的 output/FreeMinecraftModels.zip，通常通过 ResourcePackManager 完成。

手动导入模型​

直接导入模型仍然通过以下路径进行：

plugins/FreeMinecraftModels/imports

这个路径仍然适用于：

  • 本地开发
  • 不通过 Nightbreak 获取的自定义模型
  • 在运行 /fmm reload 时，把 .bbmodel 内容转换为当前运行时格式

手动导入和官方包下载最终都依赖一次重新加载/导入流程，然后运行时模型列表和资源包才会被重新构建。

官方内容包​

当前插件附带两个由 Nightbreak 管理的预制内容包：

  • BetterStructures Prop Pack
  • EliteMobs Prop Pack

它们会显示在 /fmm setup 中，可以用 /fmm downloadall 批量下载，也可以用 /fmm updatecontent 更新。

资源包提醒​

FreeMinecraftModels 始终需要以某种方式把生成后的资源包输出传递给客户端。

请参阅 资源包输出，了解当前输出路径以及与 ResourcePackManager 的集成方式。