跳到主要内容

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 托管的官方包：

  • 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 物品包属于自定义物品（在 YML 中设置了 material: 的模型），可以使用 Lua 物品脚本。

资源包提醒​

FreeMinecraftModels 始终需要将其生成的资源包以某种方式送达客户端。

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