FreeMinecraftModels 設定
FreeMinecraftModels 仍然支援手動匯入 .bbmodel，但當前的設定流程是支援 Nightbreak 並由選單驅動的。
必要條件
- 適用於伺服器的 Java 21 運行環境
- 安裝並啟動過一次 FreeMinecraftModels，使其能夠生成資料夾
- 將生成的資源包傳遞給玩家的方式
ResourcePackManager 是推薦的傳遞路徑，因為 FreeMinecraftModels 只負責生成資源包，並不會自行託管。
首次流程
| 指令 | 用途 |
|---|---|
/fmm initialize | 僅限玩家使用的首次引導選單 |
/fmm setup | 僅限玩家使用的內容管理選單 |
/fmm downloadall | 批次安裝可存取 Nightbreak 包的輔助指令 |
/fmm updatecontent | 批次更新過時 Nightbreak 包的輔助指令 |
/nightbreaklogin <token> | 共用的 Nightbreak token 註冊指令 |
如果 config.yml 中 setupDone: false 仍然存在，擁有 freeminecraftmodels.* 的玩家登入時會收到提醒，要求執行 /fmm initialize。
建議流程
- 安裝 FreeMinecraftModels 並啟動伺服器一次。
- 執行
/fmm initialize。 - 使用
/nightbreaklogin <token>連結 Nightbreak token。 - 開啟
/fmm setup以檢視可用的內容包及當前狀態。 - 如果你想安裝你的 token 可以存取的所有官方包，使用
/fmm downloadall。 - 之後使用
/fmm updatecontent來更新過時的官方包。 - 確保玩家收到生成的
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 的兩個物品包是自訂物品（設定了 material: 的模型），符合使用 Lua 物品腳本的條件。
資源包提醒
FreeMinecraftModels 始終需要將其生成的資源包輸出以某種方式傳遞到客戶端。
請參閱 資源包輸出 以了解當前的輸出路徑與 ResourcePackManager 整合方式。