FreeMinecraftModels 指令
config.yml 中的 registerCraftingRecipes 預設為 true。如需僅允許購買，請設為 false 並重新啟動：配方仍顯示在選單和商店中，但 Bukkit 合成配方會被移除。本頁的合成步驟要求此設定為 true。
使用 /freeminecraftmodels 或 /fmm。
設定與內容管理
| 指令 | 用途 |
|---|---|
/fmm | 為玩家開啟可合成物品選單（請參閱下方的 可合成物品選單） |
/fmm admin | 開啟管理員內容瀏覽器 — 瀏覽已安裝的包、資料夾、模型和自訂物品（權限：freeminecraftmodels.admin） |
/fmm setup | 開啟僅限玩家使用的內容管理／首次設定選單（玩家首次啟動時被引導去執行的指令） |
/fmm recommendedplugins | 顯示與 FreeMinecraftModels 搭配良好的搭檔外掛（為玩家開啟目錄選單，為主控台輸出清單） |
/fmm downloadall | 下載最新的外掛更新以及所有可用的官方內容。如果內容有變動，FMM 會重新載入以套用；下載的外掛 jar 仍需重啟伺服器。若外掛更新步驟因缺少 Nightbreak 權杖或驗證失敗而失敗，內容步驟會被完全略過 |
/fmm downloadallcontent | 下載所有可用的官方內容（僅內容，不更新外掛 jar），並在至少有一個套件變動時重新載入 |
/fmm updatecontent | 下載過時官方內容的更新，並在至少有一個套件變動時重新載入（別名：/fmm updateallcontent） |
/fmm downloadpluginupdate | 僅下載最新的外掛 jar 更新（在下次伺服器重啟後套用） |
/fmm forcereinstallcontent <package|all> | 修復指令 — 即使版本號顯示已是最新，仍重新下載你已擁有的內容。Tab 補全提供 all 以及每個 Nightbreak 套件的 slug。all 涵蓋所有被偵測為已下載的套件；若某個包的檔案完全遺失，請直接指定它的 slug。完成後會重新載入（權限：freeminecraftmodels.*） |
/fmm reload | 重新匯入內容並重新生成資源包輸出 |
/fmm version | 顯示外掛版本（無需權限 — 任何人都可以執行） |
/fmm stats | 顯示已載入的模型統計資訊 |
共享的 Nightbreak 指令
這些指令是由 MagmaCore 而非 FreeMinecraftModels 本身註冊的，因此它們是頂層指令，而不是 /fmm 的子指令。
| 指令 | 用途 |
|---|---|
/nightbreaklogin <token> | 為此伺服器儲存共享的 Nightbreak 帳號權杖，解鎖官方內容下載與外掛更新（權限：nightbreak.login，預設：op）。每台伺服器只會註冊一次 — 由最先載入的 Nightbreak 外掛擁有 |
/nightbreaklogout | 清除此伺服器已儲存的 Nightbreak 帳號權杖（權限：nightbreak.login，預設：op）。同時接受玩家與主控台 |
/freeminecraftmodelschangelog [dismiss|disable] | 顯示未讀的 FreeMinecraftModels 發行說明（外掛發行與被追蹤的內容套件）。dismiss 會把目前顯示的說明標記為已讀；disable 會永久隱藏對你的更新日誌提醒。僅限玩家且僅限管理員 — 玩家需要 freeminecraftmodels.*、其中一項 setup/admin 權限，或 OP。如果 /freeminecraftmodelschangelog 這個名稱已被其他外掛佔用，該指令會以帶命名空間的備援名稱註冊，例如 /freeminecraftmodels:freeminecraftmodelschangelog |
有未讀發行說明的管理員在加入時會在聊天欄收到一則附有可點擊 [VIEW CHANGELOG] 提示的提醒；摘要檢視提供 Dismiss These Updates 與 Never Show Changelogs 按鈕，功能與那兩個子指令相同。每位玩家的已讀狀態儲存在 plugins/FreeMinecraftModels/nightbreak-changelogs.yml。
模型生成與放置
| 指令 | 用途 |
|---|---|
/fmm spawn static <id> | 生成靜態模型 |
/fmm spawn dynamic <id> | 生成動態模型 |
/fmm spawn prop <id> | 建立持久化道具項目並生成。若該方塊上已載入同一模型的道具，會以 A prop of that model already exists on this block. 拒絕 |
/fmm itemify <id> <material> | 建立可放置物品，使用時會以指定模型生成道具 |
/fmm mount <id> | 使用偽裝的馬生成實驗性的可騎乘坐騎 |
/fmm giveitem <item> | 將自訂的 FMM 物品給予玩家（權限：freeminecraftmodels.admin） |
/fmm craftify <id> | 開啟互動式配方建構器 — 在 3×3 方格中放置材料，然後點擊輸出物品以儲存該道具的合成配方 |
玩家偽裝
| 指令 | 用途 |
|---|---|
/fmm disguise <modelID> [player] | 將玩家偽裝成已載入的模型。沒有目標參數時偽裝發送者。有目標時需要 freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others，可從主控台執行 |
/fmm undisguise [player] | 移除偽裝。沒有目標時取消發送者的偽裝。有目標時需要 freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others，可從主控台執行 |
/fmm disguiselist | 列出目前被偽裝的玩家及每位玩家所偽裝的模型（權限：freeminecraftmodels.disguise.others） |
偽裝行為：
- 偽裝會乾淨地取代該玩家先前的任何偽裝。
- 被偽裝的玩家對其他玩家是隱形的，所以只看得到模型。隱形效果即使在喝牛奶或其他清除效果的互動下也會持續存在。
- 第三方外掛可以透過公開的
DisguiseAPI來驅動偽裝（請參閱 API 與開發者指南）。
家具商店
| 指令 | 用途 |
|---|---|
/fmm shop | 開啟可選的 Vault 支援家具商店，玩家可以使用遊戲內貨幣購買可合成的道具（權限：freeminecraftmodels.shop，預設：true） |
商店預設為停用，僅在下列情況註冊：
shop_config.yml中enabled: true- 已安裝 Vault
- 已註冊相容 Vault 的經濟提供者
當以上任一項缺失時，/fmm shop 將不會被註冊（如果在執行階段強制停用，則會顯示可配置的「商店已停用」訊息）。請參閱 配置 以了解商店配置鍵和每個配方的 shopEnabled / shopPrice 欄位。
公用程式
| 指令 | 用途 |
|---|---|
/fmm hitbox visualize [duration] | 視覺化碰撞箱以便除錯 |
/fmm location | 診斷指令 — 回報已向 LocationAPI 註冊的地城偵測器和保護提供者數量，並在你當前位置測試這兩種判斷（權限：freeminecraftmodels.*） |
/fmm debug <bedrock|props> [on|off] | FMM 診斷日誌串流的執行階段切換。bedrock 切換用於診斷 Bedrock 顯示管線的 [FMM-BedrockDebug] 串流；props 切換道具堆疊掃描，讓每次區塊載入都把任何相距 0.1 方塊以內的兩個道具回報為 STACKED PROPS DETECTED。省略狀態參數會回報目前狀態而不做變更。on/true/enable/enabled 和 off/false/disable/disabled 都可接受。兩個切換在外掛重新載入時一律重設為 OFF — 刻意不設為配置鍵，以避免意外保持啟用。接受玩家與主控台執行（權限：freeminecraftmodels.*） |
/fmm packetdebug [ticks] | 一次性的封包負載診斷。取樣接下來 [ticks] 個模型時鐘 tick 的模型化實體封包流量（預設 1，上限 200），並回報每 tick 的邏輯封包數、含每位觀看者扇出的實際送達封包數／tick、單一玩家／tick 的最差值、封包類型分佈以及負載最重的觀看者。Tab 補全提供 1、5、20、60。請站在卡頓區域執行。封包數為精確值；位元組數字為估計值。若沒有取樣落入（未載入任何模型化實體，或 NMS 已停用）則會逾時並發出警告。接受玩家與主控台執行（權限：freeminecraftmodels.*） |
/fmm deleteall [radius] | 移除所有已載入的模型化實體和持久化道具。沒有參數時會清除全部；可選的 [radius]（僅限玩家）會將移除範圍限制在玩家周圍指定方塊數以內的實體 |
道具放置行為
當玩家右鍵點擊紙質道具物品（透過 /fmm itemify 建立或透過 /fmm craftify 配方合成）時，會發生下列情況：
- 物品消耗： 放置道具時會消耗紙質物品，除非玩家處於創造模式。
- 旋轉： 道具會朝向玩家的視角方向放置，並對齊到 10 度旋轉增量。這讓玩家只需在放置前調整視線方向，就能精確控制道具方向。
- 每個方塊每個模型只能有一個道具： 當該方塊上已載入同一模型的道具時，放置會被拒絕並顯示
A prop of that model already exists on this block.。被拒絕的放置不會消耗物品。 - 僅限主手： 只有互動事件的主手那一半會放置道具，因此單次右鍵不再會產生兩個道具。
- 重複清理： 在伺服器啟動時以及每次區塊載入時，FreeMinecraftModels 會掃描共用同一模型與方塊的道具盔甲座，保留其中一個並移除其餘的。移除會記錄為
[FMM Props] Removed N duplicate prop armor stand(s) ...。
可合成物品選單
不帶參數執行 /fmm 會為玩家開啟一個物品欄選單，顯示所有已設定配方的可合成物品。
- 選單中的每個物品代表一個可合成的 FMM 物品。
- 點擊物品會開啟詳細子選單，顯示空間 3x3 合成方格、箭頭和輸出物品 — 向玩家展示如何在工作台中合成。
- 需要
freeminecraftmodels.menu權限（預設：true，所有玩家皆可使用）。
管理員內容瀏覽器
執行 /fmm admin 會開啟一個物品欄選單，供伺服器管理員瀏覽：
- 已安裝的內容包
- 資料夾與個別模型
- 自訂物品（設定了
material:的模型）
需要 freeminecraftmodels.admin 權限（預設：op）。
配方建構器
/fmm craftify 指令讓你可以為任何道具模型建立原版工作台配方。
- 執行
/fmm craftify <model_id>開啟配方建構器 UI。 - 會開啟一個自訂物品欄，包含 3×3 合成方格和預先填入的輸出物品。
- 從你的物品欄將材料放入方格中，可隨意擺放圖案。
- 點擊輸出物品（該道具的紙質物品）以儲存配方。
- 粒子效果和音效會確認儲存。
- 配方會儲存到
plugins/FreeMinecraftModels/recipes/<model_id>.yml，並立即註冊。 - 玩家現在可以在任何工作台合成該道具物品。
- 按 Escape 取消儲存 — 材料會返回到你的物品欄。
- 對同一個模型再次執行 craftify 會覆蓋先前的配方。
- 配方在伺服器重啟和重新載入後仍會保留。
配方檔案格式
isEnabled: true
model_id: "wooden_chair"
shape:
- "L L"
- "LLL"
- "L L"
ingredients:
L: OAK_LOG
shopEnabled: true
shopPrice: 250.0
| 欄位 | 必填 | 說明 |
|---|---|---|
isEnabled | 是（預設 true） | 設為 false 可在不刪除檔案的情況下取消註冊該配方 |
model_id | 是 | 合成出的紙質物品所放置的模型。帶有弓／弩狀態後綴的模型 ID 會自動改寫為基礎模型 ID |
shape | 是 | 最多三列，每列最多三個字元。空格代表「空格位」 |
ingredients | 是 | 單一形狀字元對應到 Bukkit 材料名稱的映射。無法辨識的材料會被靜默捨棄 |
shopEnabled | 否（預設 true） | 該配方是否列在 /fmm shop 中 |
shopPrice | 否（預設為 shop_config.yml 的 defaultPrice） | 商店中的 Vault 貨幣售價 |
註冊的 Bukkit 配方鍵為 freeminecraftmodels:prop_recipe_<model_id>，輸出永遠是該模型的紙質放置物品。對同一個模型重新執行 /fmm craftify 會覆寫該檔案，並以相同的鍵重新註冊。
權限
在 plugin.yml 中註冊
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.* | OP | 萬用字元，授予 freeminecraftmodels.admin、freeminecraftmodels.deleteall、freeminecraftmodels.disguise.self、freeminecraftmodels.disguise.others 和 freeminecraftmodels.bypassregionprotection。該萬用字串同時也是下列指令所需的字面權限：/fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug、/fmm packetdebug、/fmm location、/fmm setup, /fmm initialize、/fmm recommendedplugins、/fmm downloadall、/fmm downloadallcontent、/fmm updatecontent、/fmm downloadpluginupdate 和 /fmm forcereinstallcontent |
freeminecraftmodels.admin | OP | 存取 /fmm admin（管理員內容瀏覽器）和 /fmm giveitem |
freeminecraftmodels.deleteall | OP | 萬用字元的子權限；存取 /fmm deleteall |
freeminecraftmodels.disguise.self | OP | 允許 /fmm disguise 和 /fmm undisguise 僅以發送者為目標 |
freeminecraftmodels.disguise.others | OP | 允許 /fmm disguise <model> <player>、/fmm undisguise <player> 和 /fmm disguiselist |
freeminecraftmodels.bypassregionprotection | OP | 即使 preventPropPlacementInProtectedRegions 已啟用，仍允許在任何其他外掛原本會阻擋一般方塊放置的地方放置道具並與之互動 |
freeminecraftmodels.menu | true | 存取 /fmm 可合成物品選單（所有玩家皆可使用） |
freeminecraftmodels.shop | true | 存取 /fmm shop（商店啟用時所有玩家皆可使用） |
指定目標玩家的 disguise 和 undisguise 命令同時需要 freeminecraftmodels.disguise.self 和 freeminecraftmodels.disguise.others。disguiselist 只需要 .others。
由 MagmaCore 註冊
| 權限 | 預設 | 說明 |
|---|---|---|
nightbreak.login | OP | 共享的 /nightbreaklogin 和 /nightbreaklogout 指令所需。由最先載入的 Nightbreak 外掛在每台伺服器上註冊一次 |
發送者注意事項
setup、spawn、itemify、mount、giveitem、craftify、hitbox visualize、location、admin和shop是僅限玩家的指令。/freeminecraftmodelschangelog也僅限玩家。recommendedplugins、downloadall、downloadallcontent、updatecontent、downloadpluginupdate、forcereinstallcontent、packetdebug、debug、deleteall、/nightbreaklogin和/nightbreaklogout接受玩家與主控台執行（deleteall的半徑參數僅限玩家）。disguise和undisguise接受目標玩家，只要有提供目標就可以從主控台執行。version沒有權限限制，任何人（玩家或主控台）皆可執行。/fmm initialize為擁有freeminecraftmodels.*權限的玩家開啟首次設定選單。日常內容管理使用/fmm setup。