跳至主要内容

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 的整合方式。