跳至主要内容

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 整合。