FreeMinecraftModels 指令
使用 /freeminecraftmodels 或 /fmm。
設定與內容管理
| 指令 | 用途 |
|---|---|
/fmm | 為玩家開啟可合成物品選單（請參閱下方的 可合成物品選單） |
/fmm admin | 開啟管理員內容瀏覽器 — 瀏覽已安裝的包、資料夾、模型和自訂物品（權限：freeminecraftmodels.admin） |
/fmm initialize | 開啟僅限玩家使用的首次設定流程 |
/fmm setup | 開啟僅限玩家使用的內容管理選單 |
/fmm downloadall | 下載所有目前可存取的官方內容 |
/fmm updatecontent | 下載過時官方內容的更新 |
/fmm reload | 重新匯入內容並重新生成資源包輸出 |
/fmm version | 顯示外掛版本（無需權限 — 任何人都可以執行） |
/fmm stats | 顯示已載入的模型統計資訊 |
模型生成與放置
| 指令 | 用途 |
|---|---|
/fmm spawn static <id> | 生成靜態模型 |
/fmm spawn dynamic <id> | 生成動態模型 |
/fmm spawn prop <id> | 建立持久化道具項目並生成 |
/fmm itemify <id> <material> | 建立可放置物品，使用時會以指定模型生成道具 |
/fmm mount <id> | 使用偽裝的馬生成實驗性的可騎乘坐騎 |
/fmm giveitem <item> | 將自訂的 FMM 物品給予玩家（權限：freeminecraftmodels.admin） |
/fmm craftify <id> | 開啟互動式配方建構器 — 在 3×3 方格中放置材料，然後點擊輸出物品以儲存該道具的合成配方 |
玩家偽裝
| 指令 | 用途 |
|---|---|
/fmm disguise <modelID> [player] | 將玩家偽裝成已載入的模型。沒有目標參數時偽裝發送者。有目標時需要 freeminecraftmodels.disguise.others，可從主控台執行 |
/fmm undisguise [player] | 移除偽裝。沒有目標時取消發送者的偽裝。有目標時需要 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 [on|off] | 用於診斷 Bedrock 顯示管線的 [FMM-BedrockDebug] 日誌串流執行階段切換。省略狀態參數會回報目前是否啟用日誌記錄。每次外掛重新載入都會重設為 OFF — 刻意不設為配置鍵，以避免意外保持啟用。接受玩家與主控台執行（權限：freeminecraftmodels.*） |
/fmm deleteall | 移除目前已載入的所有模型化實體 |
道具放置行為
當玩家右鍵點擊紙質道具物品（透過 /fmm itemify 建立或透過 /fmm craftify 配方合成）時，會發生下列情況：
- 物品消耗： 放置道具時會消耗紙質物品，除非玩家處於創造模式。
- 旋轉： 道具會朝向玩家的視角方向放置，並對齊到 10 度旋轉增量。這讓玩家只需在放置前調整視線方向，就能精確控制道具方向。
可合成物品選單
不帶參數執行 /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 會覆蓋先前的配方。
- 配方在伺服器重啟和重新載入後仍會保留。
儲存的配方檔案包含 shopEnabled（預設 true）和 shopPrice（預設來自 shop_config.yml）欄位，用以控制該配方如何呈現在 /fmm shop。
權限
在 plugin.yml 中註冊
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.* | OP | 萬用字元，授予 freeminecraftmodels.admin、freeminecraftmodels.disguise.self 和 freeminecraftmodels.disguise.others。該萬用字串同時也是下列指令所需的字面權限：/fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug bedrock、/fmm location、/fmm setup、/fmm initialize、/fmm downloadall 和 /fmm updatecontent |
freeminecraftmodels.admin | OP | 存取 /fmm admin（管理員內容瀏覽器）和 /fmm giveitem |
freeminecraftmodels.disguise.self | OP | 允許 /fmm disguise 和 /fmm undisguise 僅以發送者為目標 |
freeminecraftmodels.disguise.others | OP | 允許 /fmm disguise <model> <player>、/fmm undisguise <player> 和 /fmm disguiselist |
freeminecraftmodels.menu | true | 存取 /fmm 可合成物品選單（所有玩家皆可使用） |
freeminecraftmodels.shop | true | 存取 /fmm shop（商店啟用時所有玩家皆可使用） |
由指令強制執行
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.deleteall | OP | 存取 /fmm deleteall（在執行時檢查，未在 plugin.yml 中註冊） |
initialize、setup、spawn、itemify、mount、giveitem、craftify、hitbox visualize、location和shop是僅限玩家的指令。disguise和undisguise接受目標玩家，只要有提供目標就可以從主控台執行。version沒有權限限制，任何人（玩家或主控台）皆可執行。