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 <id> | 將玩家偽裝為已載入的模型 |
/fmm undisguise | 移除玩家的偽裝 |
/fmm hitbox visualize [duration] | 視覺化碰撞箱以進行除錯 |
/fmm deleteall | 移除所有目前載入的模型實體 |
道具放置行為
當玩家使用紙張道具物品（透過 /fmm itemify 建立或透過 /fmm craftify 配方合成）右鍵點擊時，適用以下規則：
- 物品消耗： 放置道具時紙張物品會被消耗，除非玩家處於創造模式。
- 旋轉： 道具放置時面向玩家的方向，以 10 度為增量對齊旋轉。這讓玩家只需在放置前調整視角方向，就能精細控制道具的朝向。
可合成物品選單
不帶參數執行 /fmm 會為玩家開啟一個物品欄選單，顯示所有已配置配方的可合成物品。
- 選單中的每個物品代表一個可合成的 FMM 物品。
- 點擊物品會開啟一個詳細子選單，顯示空間 3x3 合成方格、箭頭和輸出物品 — 向玩家展示如何在工作台中合成。
- 需要
freeminecraftmodels.menu權限（預設：true，所有玩家可用）。
管理員內容瀏覽器
執行 /fmm admin 會為伺服器管理員開啟一個物品欄選單，用於瀏覽：
- 已安裝的內容包
- 資料夾和個別模型
- 自訂物品（YML 設定中有
material:的模型）
需要 freeminecraftmodels.admin 權限（預設：op）。
配方建構器
/fmm craftify 指令讓你為任何道具模型建立原版工作台配方。
- 執行
/fmm craftify <model_id>開啟配方建構器介面。 - 會開啟一個自訂物品欄，包含 3×3 合成方格和預填的輸出物品。
- 從你的物品欄中將材料放入方格中，使用你想要的任何圖案。
- 點擊輸出物品（道具的紙張物品）以儲存配方。
- 粒子效果和音效確認儲存成功。
- 配方會儲存到
plugins/FreeMinecraftModels/recipes/<model_id>.yml並立即註冊。 - 玩家現在可以在任何工作台中合成該道具物品。
- 按 Escape 鍵取消而不儲存 — 材料會返回到你的物品欄。
- 對同一模型再次執行 craftify 會覆蓋先前的配方。
- 配方在伺服器重啟和重新載入後持續有效。
權限
已在 plugin.yml 中註冊
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.* | OP | 大多數管理和生成指令 |
freeminecraftmodels.admin | OP | 存取 /fmm admin 內容瀏覽器和 /fmm giveitem |
freeminecraftmodels.menu | true | 存取 /fmm 可合成物品選單（所有玩家可用） |
由指令強制執行
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.deleteall | OP | 存取 /fmm deleteall（在運行時由指令檢查，未在 plugin.yml 中註冊） |
initialize、setup、spawn、itemify、disguise、undisguise、mount、giveitem、craftify和hitbox visualize是僅限玩家的指令。version沒有權限限制，任何人（玩家或控制台）都可以執行。