FreeMinecraftModels 內容包
官方 FMM 內容現在以受管理的 Nightbreak 套件形式提供。
當前官方套件
當前的外掛定義了五個預製官方套件,混合了道具與物品內容:
| 套件 | 類型 | 配置檔名 | 資料夾名稱 | Nightbreak slug |
|---|---|---|---|---|
Basic Furniture Pack | 道具 | basic_furniture_pack | Basic Furniture Pack | basic-furniture-pack |
BetterStructures Prop Pack | 道具 | betterstructures_prop_pack | bs prop pack | betterstructures-prop-pack |
EliteMobs Prop Pack | 道具 | elitemobs_prop_pack | em_dungeon_prop_pack | elitemobs-prop-pack |
Craftenmine's Weapons Item Pack | 自訂物品 | craftenmines_weapons_item_pack | fmm_craftenmine_weapons_items_pack | craftenmines-weapons-item-pack |
Craftenmine Tools Item Pack | 自訂物品 | craftenmine_tools_item_pack | fmm_craftenmine_tools_items_pack | craftenmine-tools-item-pack |
配置檔名是 plugins/FreeMinecraftModels/content_packages/ 下的 .yml 項目。資料夾名稱是套件模型實際存放於 models/ 或 models_disabled/ 內的目錄,也是預設的內容/腳本檔案前綴。
每個套件在 content_packages 中都有一個本機資料夾名稱、Nightbreak slug、版本欄位以及啟用/停用狀態。Craftenmine 的兩個物品包提供自訂物品(設定了 material: 的模型),可使用完整的 Lua 物品腳本介面。
設定選單管理的內容
/fmm setup 是當前套件狀態的主要依據。該選單可以區分:
- 已安裝的套件
- 已下載但目前停用的套件
- 過時的套件
- 需要 Nightbreak 存取權的套件
設定選單也會觸發背景刷新套件版本與存取檢查,所以選單是驗證當前套件狀態的正確位置。
資料夾行為
外掛對已啟用和已停用的內容使用基於套件狀態的資料夾移動:
- 已啟用的模型資料夾位於
models/<folderName> - 已停用的模型資料夾位於
models_disabled/<folderName> - 已啟用的腳本檔案位於
scripts/ - 已停用的腳本檔案位於
scripts_disabled/
這表示一個套件可以完全下載到磁碟上,但並未在執行階段模型清單中啟用。當套件被安裝或卸載時,其模型資料夾與任何匹配的腳本檔案會一起被移動。
檔案前綴
每個內容包設定都有一個 contentFilePrefixes 欄位和一個 scriptFilePrefixes 欄位(兩者預設都使用該套件的 folderName)。檔名以任何 contentFilePrefixes 開頭的內容檔,以及 scripts/ 資料夾中檔名以任何 scriptFilePrefixes 開頭的腳本檔,會被視為該套件的一部分,並在安裝/卸載期間隨之移動。
下載與安裝生命週期
這是兩個不同的步驟:
- 下載套件內容。
下載會放入
plugins/FreeMinecraftModels/imports,然後觸發重新載入/匯入流程。 - 保持套件啟用或停用。
設定選單透過在
models與models_disabled之間移動套件資料夾來安裝與卸載套件。
批次操作遵循相同的模式:
/fmm downloadall下載每個可存取且缺失或過時的套件/fmm updatecontent只更新過時的套件
兩個批次指令在成功下載後都會自動重新載入 FreeMinecraftModels,使新下載的內容立即可用。
管理員內容瀏覽器
/fmm admin 會開啟遊戲內物品欄 GUI,讓管理員一目了然地瀏覽所有已安裝的內容。瀏覽器會顯示:
- 所有已安裝的套件(分別顯示道具與物品數量)
- 未打包的模型資料夾(分別顯示道具與物品數量)
- 個別道具(YML 設定中未設定
material:的模型) - 自訂物品(YML 設定中設定了
material:的模型)
道具與物品會以不同方式顯示:道具使用黃色樣式與紙質圖示,而自訂物品使用紫色樣式並顯示其配置的材質。在 YML 設定中設定了 material: 的模型只會作為自訂物品出現,絕不會同時作為道具與物品。
點擊管理員瀏覽器中的任何項目會給玩家一份該物品的副本。對於自訂物品,給予的物品包含配置的材質、附魔、物品說明以及 fmm_item_id PDC 標籤。這是不需要知道確切模型 ID 或指令語法就能取得道具、自訂物品或模型物品以供測試與建構的最快方式。