FreeMinecraftModels 設定
FreeMinecraftModels 仍然支援手動匯入 .bbmodel，但當前的設定流程是支援 Nightbreak 並由選單驅動的。
必要條件
- 適用於伺服器的 Java 21 運行環境
- Minecraft 1.21.4 或更新版本：外掛宣告
api-version: 1.21.4，無法在較舊版本載入 - 安裝並啟動過一次 FreeMinecraftModels，使其能夠生成資料夾。MagmaCore 已內附在外掛 jar 中，因此不需要另外安裝
- 將生成的資源包傳遞給玩家的方式
ResourcePackManager 是推薦的傳遞路徑，因為 FreeMinecraftModels 只負責生成資源包，並不會自行託管。
首次流程
| 指令 | 用途 |
|---|---|
/fmm setup | 僅限玩家使用的內容管理／首次引導選單（玩家首次啟動時被引導去執行的指令） |
/fmm recommendedplugins | 瀏覽與 FreeMinecraftModels 搭配良好的搭檔外掛 |
/fmm downloadall | 批次安裝輔助指令：下載最新的外掛更新加上所有可存取的 Nightbreak 包 |
/fmm downloadallcontent | 可存取 Nightbreak 包的批次安裝輔助指令（僅內容） |
/fmm updatecontent | 過時 Nightbreak 包的批次更新輔助指令 |
/fmm downloadpluginupdate | 僅下載最新的外掛 jar 更新 |
/fmm applypluginupdate | 不重新啟動伺服器即套用已下載的外掛更新 |
/fmm forcereinstallcontent <package|all> | 修復用指令：即使版本號顯示最新，也重新下載既有內容 |
/nightbreaklogin [token] | 共用的 Nightbreak 帳號連結指令：顯示一個用來核准伺服器的連結，或儲存貼上的 token，需要 nightbreak.login 權限 |
/nightbreaklogout | 清除本伺服器儲存的 Nightbreak token |
如果 config.yml 仍為 setupDone: false，擁有 freeminecraftmodels.* 的玩家每次登入約 10 秒後，若仍在線上，就會收到提醒。開啟 /fmm setup 會為整個伺服器儲存 setupDone: true，並停止後續提醒。訊息也會提示 /fmm admin 和 /fmm。完成 /fmm initialize 中的一個選項同樣會標記設定完成；這個標記不代表內容包已安裝或送達。
/fmm setup 工具列還有一個 Pets 按鈕，用來在裝飾性寵物與更多生物之間切換寵物模式，並將選擇儲存到 pets.yml。
建議流程
- 安裝 FreeMinecraftModels 並啟動伺服器一次。
- 使用
/nightbreaklogin將伺服器連結到你的 Nightbreak 帳號，然後在它顯示的連結中核准。 - 開啟
/fmm setup以檢視可用的內容包及當前狀態。 - 如果你想安裝 token 可存取的所有官方包，使用
/fmm downloadall（也會取得最新的外掛 jar 更新）。 - 之後使用
/fmm updatecontent更新過時的官方包。 - 等待初始化成功，並確認玩家收到生成的
output/FreeMinecraftModels.zip，通常透過 ResourcePackManager 傳遞。生成成功後，FMM 會通知已啟用的 ResourcePackManager，但這項通知本身不能證明資源包已送達用戶端。
互動式內容包下載會在內容變更後重新載入 FMM。下載的外掛 jar 會在重新啟動後生效，或以 /fmm applypluginupdate 立即生效。/fmm reload 會在重建前驗證自訂物品、附魔與道具配方；驗證遭拒時，目前的內容清單保持有效。請確認結果，不要直接假定檔案已套用。
如果你比較想讓伺服器自行取得更新，請在 config.yml 中設定 nightbreak.autoDownloadPluginUpdates: true（預設 false）。下載的外掛和內容更新會在下次重啟後套用。若要不重啟就套用外掛更新，請將 nightbreak.applyPluginUpdatesWithoutRestart 設為 when-empty 或 immediately（預設 never）。請參閱 配置。
手動模型匯入
直接的模型匯入仍可透過下列路徑進行：
plugins/FreeMinecraftModels/imports
該路徑對於下列情況仍然有用：
- 本機開發
- 不從 Nightbreak 拉取的自訂模型
- 當你執行
/fmm reload時，將.bbmodel內容轉換為當前的運行時格式
手動匯入和官方包下載最終都需要依賴一次重新載入／匯入流程，運行時模型清單和資源包才會重建。
將單獨的 .bbmodel 直接放入 imports/。這條路徑會將轉換後的 .fmmodel 寫入模型目錄，並保留來源匯入檔，因此之後重新載入可能再次轉換。它不會一併匯入旁邊單獨的 .yml，也不會遞迴匯入沒有 pack.meta 的一般子資料夾。帶有配套設定或腳本的模型應使用目前的 models/ 與 scripts/ 目錄，或正確封裝的壓縮檔；請參閱模型製作說明。
官方內容包
當前的外掛內建五個由 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: 的自訂物品，使用目前的物品定義與附魔格式。帶有裝備物品腳本的舊包需要更新內容。
資源包提醒
FreeMinecraftModels 始終需要將其生成的資源包輸出以某種方式傳遞到客戶端。
請參閱 資源包輸出 以了解當前的輸出路徑與 ResourcePackManager 整合方式。