跳至主要内容

FreeMinecraftModels 內容包

官方 FMM 內容現在以受管理的 Nightbreak 包形式公開。

當前官方包​

當前外掛定義了三個預製的官方包：

  • Basic Furniture Pack
  • BetterStructures Prop Pack
  • EliteMobs Prop Pack

每個包都有一個本地資料夾名稱、一個 Nightbreak slug、一個版本欄位，以及 content_packages 中的啟用/停用狀態。

設定選單管理的內容​

/fmm setup 是包狀態的當前真實來源。選單可以區分：

  • 已安裝的包
  • 已下載但目前停用的包
  • 過期的包
  • 需要 Nightbreak 存取權的包

設定選單還會觸發包版本和存取檢查的背景更新，因此選單是驗證當前包狀態的正確位置。

資料夾行為​

外掛使用包狀態資料夾移動來處理啟用和停用的內容：

  • 啟用的模型資料夾位於 models/<folderName>
  • 停用的模型資料夾位於 models_disabled/<folderName>
  • 啟用的腳本檔案位於 scripts/
  • 停用的腳本檔案位於 scripts_disabled/

這意味著一個包可以完全下載到磁碟上，但不在運行時模型列表中處於活動狀態。當包被安裝或解除安裝時，其模型資料夾和任何匹配的腳本檔案會一起移動。

檔案前綴​

每個內容包設定都有一個 contentFilePrefixes 欄位和一個 scriptFilePrefixes 欄位（預設都使用包的 folderName）。名稱以任何 contentFilePrefixes 開頭的內容檔案和 scripts/ 資料夾中名稱以任何 scriptFilePrefixes 開頭的腳本檔案被視為該包的一部分，在安裝/解除安裝時會一起移動。

下載和安裝生命週期​

有兩個不同的步驟：

  1. 下載包內容。 下載內容進入 plugins/FreeMinecraftModels/imports，然後觸發重新載入/匯入過程。
  2. 保持包啟用或停用。 設定選單透過在 models 和 models_disabled 之間移動資料夾來安裝和解除安裝包。

批量操作遵循相同的模式：

  • /fmm downloadall 下載所有遺失或過期的可存取包
  • /fmm updatecontent 僅更新過期的包

兩個批量指令在成功下載後都會自動重新載入 FreeMinecraftModels，使新下載的內容立即可用。

管理員內容瀏覽器​

/fmm admin 開啟一個遊戲內物品欄 GUI，讓管理員一覽所有已安裝的內容。瀏覽器顯示：

  • 所有已安裝的包（分別顯示道具和物品數量）
  • 未打包的模型資料夾（分別顯示道具和物品數量）
  • 個別道具（YML 設定中沒有 material: 的模型）
  • 自訂物品（YML 設定中有 material: 的模型）

道具和物品以不同方式顯示：道具使用黃色樣式和紙張圖示，而自訂物品使用紫色樣式並顯示其配置的材料。YML 設定中有 material: 的模型只會作為自訂物品出現，不會同時作為道具和物品出現。

點擊管理員瀏覽器中的任何條目都會給予玩家該物品的副本。對於自訂物品，給予的物品包括配置的材料、附魔、說明文字和 fmm_item_id PDC 標籤。這是獲取道具、自訂物品或模型物品以進行測試和建造的最快方式，無需知道確切的模型 ID 或指令語法。