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 token 註冊指令 |
如果 config.yml 中 setupDone: false 仍然存在，擁有 freeminecraftmodels.* 的玩家登入時會收到一次性提醒，引導他們執行 /fmm setup（開啟後會永久解除該訊息）。此提醒也會帶出 /fmm admin 和 /fmm。
建議流程
- 安裝 FreeMinecraftModels 並啟動伺服器一次。
- 使用
/nightbreaklogin <token>連結 Nightbreak token。 - 開啟
/fmm setup以檢視可用的內容包及當前狀態。 - 如果你想安裝你的 token 可以存取的所有官方包，使用
/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 整合方式。