FreeMinecraftModels 指令
config.yml 中的 registerCraftingRecipes 預設為 true。如需僅允許購買，請設為 false 並重新啟動：有效且啟用的項目仍保留在商店目錄中，但會從 Bukkit 合成及玩家的 /fmm 可合成物品選單移除。本頁的合成步驟要求此設定為 true。
使用 /freeminecraftmodels 或 /fmm。
設定與內容管理
| 指令 | 用途 |
|---|---|
/fmm | 為玩家開啟可合成物品選單（請參閱下方的 可合成物品選單） |
/fmm admin | 開啟管理員內容瀏覽器 — 瀏覽已安裝的包、資料夾、模型和自訂物品（權限：freeminecraftmodels.admin） |
/fmm setup | 開啟僅限玩家使用的內容管理／首次設定選單（玩家首次啟動時被引導去執行的指令） |
/fmm recommendedplugins | 顯示與 FreeMinecraftModels 搭配良好的搭檔外掛（為玩家開啟目錄選單，為主控台輸出清單） |
/fmm downloadall | 下載最新的外掛更新以及所有可用的官方內容。如果內容有變動，FMM 會重新載入以套用。下載的外掛 jar 會在重啟後、執行 /fmm applypluginupdate 後，或依 nightbreak.applyPluginUpdatesWithoutRestart 的設定生效。若外掛更新步驟因缺少 Nightbreak 權杖或驗證失敗而失敗，內容步驟會被完全略過 |
/fmm downloadallcontent | 下載所有可用的官方內容（僅內容，不更新外掛 jar），並在至少有一個套件變動時重新載入 |
/fmm updatecontent | 下載過時官方內容的更新，並在至少有一個套件變動時重新載入（別名：/fmm updateallcontent） |
/fmm downloadpluginupdate | 僅下載最新的外掛 jar 更新。除非你執行 /fmm applypluginupdate 或設定 nightbreak.applyPluginUpdatesWithoutRestart，否則會在下次重啟後生效 |
/fmm applypluginupdate | 不重啟伺服器即套用已下載的外掛更新。FMM 以及所有相依或軟相依於它的已啟用 MagmaGuy 外掛會被停用，jar 會被替換，然後再次載入並啟用。若沒有等待中的較新更新，或有其他作者的外掛相依於 FMM，此指令會被拒絕。若新的 jar 無法啟用，會重新載入先前的 jar，更新則保留至下次重啟時套用。玩家與主控台皆可執行（權限：freeminecraftmodels.*） |
/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.io 連結；帶權杖時則儲存該權杖（權限：nightbreak.login，預設：op）。每台伺服器只會註冊一次 — 由最先載入的 Nightbreak 外掛擁有 |
/nightbreaklogout | 清除此伺服器已儲存的 Nightbreak 帳號權杖（權限：nightbreak.login，預設：op）。同時接受玩家與主控台 |
/nightbreak plugins | 顯示 Nightbreak 外掛目錄，玩家看到的是選單，主控台則是聊天清單（權限：nightbreak.plugins，預設：op）。與 /nightbreaklogin 一樣，每台伺服器只會註冊一次。請參閱 Nightbreak 設定與內容管理 |
/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> | 透過最遠 300 格的方塊射線偵測，在瞄準方塊的上方生成靜態模型 |
/fmm spawn dynamic <id> | 使用相同的 300 格射線偵測，在瞄準方塊的上方生成由隱藏的豬承載的模型 |
/fmm spawn prop <id> | 在玩家目前位置生成持久化道具。若該方塊上已載入同一模型的道具，會以 A prop of that model already exists on this block. 拒絕 |
/fmm itemify <id> <material> | 使用指定的 Bukkit 材料建立放置物品。請使用大寫列舉名稱，例如 PAPER。若模型的道具 .yml 設有 name 與 lore，物品就會採用它們。這不會建立定義好的手持物品 |
/fmm mount <id> [scale] | 生成實驗性的可騎乘坐騎：一匹已馴服、裝上馬鞍並穿戴該模型的馬，由你騎乘並操控。選用的縮放值須大於 0 且最大為 16，用於調整馬及其模型的大小；Tab 補全會提供 1.0、2.0 和 3.0。請參閱可騎乘的自訂模型 |
/fmm giveitem <item> | 將已註冊的自訂 FMM 物品給予玩家；物品 ID 不區分大小寫（權限：freeminecraftmodels.admin） |
/fmm craftify <id> | 開啟互動式配方建構器 — 在 3×3 方格中放置材料，然後點擊輸出物品以儲存該道具的合成配方 |
直接生成指令不會執行放置物品的保護與可用空間檢查。使用 itemify 和 giveitem 時請預留物品欄空位：這些指令會忽略裝不下的物品，不會將剩餘物品掉落到地上。
玩家偽裝
| 指令 | 用途 |
|---|---|
/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 pets | 開啟你的寵物選單，可在其中帶寵物同行或讓牠們回家（權限：freeminecraftmodels.pets） |
/fmm petadmin mode [creatures|cosmetic] | 顯示寵物模式，或切換模式並儲存到 pets.yml（權限：freeminecraftmodels.pets.admin） |
/fmm petadmin list | 列出已載入的寵物物種及其檔案、模型、本體、馴服食物與繁殖食物（權限：freeminecraftmodels.pets.admin） |
/fmm petadmin spawn <species> | 在你注視的方塊（最遠 12 格）上方生成該物種的野生寵物。僅在 CREATURES 模式下可用（權限：freeminecraftmodels.pets.admin） |
/fmm petadmin give <species> | 將該物種的一隻成年寵物加入你自己的寵物收藏（權限：freeminecraftmodels.pets.admin） |
/fmm petmigrate [species] | 立即讓一個夜間遷徙群飛過你的上空，不論時間或天空狀況（權限：freeminecraftmodels.pets.admin） |
物種檔案、pets.yml 和兩種寵物模式請參閱寵物。
家具商店
| 指令 | 用途 |
|---|---|
/fmm shop | 開啟可選的 Vault 支援家具商店，玩家可以使用遊戲內貨幣購買可合成的道具（權限：freeminecraftmodels.shop，預設：true） |
商店預設為停用，僅在下列情況註冊：
shop_config.yml中enabled: true- 已安裝 Vault
- 已註冊相容 Vault 的經濟提供者
當以上任一項缺失時，/fmm shop 不會註冊。啟用商店但缺少 Vault 或經濟支援時會記錄警告。已註冊的處理器在商店設定或快取的連接狀態顯示停用時，可以回傳設定的停用訊息；它不會持續偵測經濟提供者是否被移除。商店設定鍵和每個配方的 shopEnabled / shopPrice 欄位請參閱配置。
公用程式
| 指令 | 用途 |
|---|---|
/fmm hitbox visualize [duration] | 顯示同一世界中距離小於 10 格的模型碰撞箱，並顯示其底層實體。時間以 tick 為單位，預設為 100（五秒）；非正數或非數字的值使用 100，大於 1200 的值使用 1200 |
/fmm location | 回報已註冊的地城偵測器與保護提供者，並查詢目前位置的 is_in_dungeon / is_protected。這些位置判斷不是考量玩家身分的道具放置權限檢查（權限：freeminecraftmodels.*） |
/fmm debug <bedrock|props> [on|off] | 切換 [FMM-BedrockDebug] 日誌，或在清理掃描中偵測相距 0.1 格以內的道具對並回報 STACKED PROPS DETECTED。未指定狀態時，會回報該開關目前是否開啟。也接受 true/enable/enabled 和 false/disable/disabled。玩家與主控台皆可執行（權限：freeminecraftmodels.*） |
/fmm packetdebug [ticks] | 按指定的模型時鐘 tick 數取樣模型化實體的封包流量，預設為 1，數值限制在 1–200，無效整數使用 1。回報每 tick 邏輯與實際送達的封包數、依觀看者擴散的數量、負載最高的玩家／tick、封包類型及負載最重的觀看者。Tab 補全提供 1、5、20、60。請在受影響區域執行。受監測流量的計數是精確的，位元組數是估計值。同一時間只會執行一次取樣。400 個伺服器 tick 內沒有新樣本時會警告。玩家與主控台皆可執行（權限：freeminecraftmodels.*） |
/fmm filmic [on|off] | 暫時開啟或關閉電影模式，用於以 ReplayMod 錄製影片。開啟後，每位玩家都會收到其已載入區塊中的所有已載入模型，即使不在視線內也一樣，而且模型會持續播放動畫。不建議在錄影以外的情況使用： 它會耗費大量頻寬與伺服器效能。它絕不會修改 config.yml；此設定會持續到伺服器重啟，或直到 config.yml 中的 filmicMode 被變更且 FMM 重新載入為止。不帶參數時，會回報目前狀態，以及該狀態來自指令還是 config.yml。玩家與主控台皆可執行（權限：freeminecraftmodels.*） |
/fmm boneglide [ticks] | 暫時設定 riddenBoneInterpolationTicks，也就是 Java 用戶端將騎乘中的模型骨骼滑行到下一個姿勢所需的 tick 數。0 表示直接吸附。接受 0 到 59，並可用 Tab 補全 0 到 3。不帶參數時，會回報目前的值。它絕不會修改 config.yml；FMM 重新載入時會恢復 config.yml 中的值。玩家與主控台皆可執行（權限：freeminecraftmodels.*） |
/fmm deleteall [radius] | 移除所有世界中目前已載入的模型化實體，並永久移除已載入的道具。不掃描未載入的道具。正整數半徑僅供玩家使用，將移除範圍限制為該玩家所在世界及指定距離內 |
除錯開關不會儲存至磁碟，但 /fmm reload 也不會重設它們。收集完證據後請明確關閉日誌；重新啟動伺服器時，兩個開關會初始化為關閉。
道具放置行為
玩家右鍵使用透過 itemify、合成或商店取得的模型放置物品時，適用下列規則。定義好的手持物品不由這個處理器處理。
- 物品消耗： 放置成功後消耗一個物品，創造模式除外。
- 目標： 點擊方塊時使用互動事件中的方塊與面；點擊空氣時進行最遠五格的射線偵測。自由放置道具使用面的中心，體素化道具使用相鄰方塊及對齊網格的占用範圍。
- 旋轉： 道具從放置點朝向玩家的位置，而不只是跟隨玩家視角的水平角度。自由放置以 10 度對齊，體素化放置以 90 度對齊。
- 每個方塊每個模型只能有一個道具： 當該方塊上已載入同一模型的道具時，放置會被拒絕並顯示
A prop of that model already exists on this block.。被拒絕的放置不會消耗物品。 - 主手與冷卻： 只有主手互動可以放置道具。每次嘗試都有 500 毫秒冷卻，包括隨後未通過驗證的嘗試。
- 保護與空間： 設定的保護查詢會檢查相鄰格。體素化道具還會檢查旋轉後整個占用範圍內的可用空間與保護。繞過權限會略過保護查詢。關於整合及碰撞涵蓋範圍的限制，請參閱配置。
- 重複清理： 啟動時、實體載入事件發生時以及直接生成道具前，FMM 會掃描同一模型、同一方塊的道具盔甲座，保留一個並移除其餘的。移除記錄為
[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 合成方格和預先填入的輸出物品。
- 從你的物品欄將材料放入方格中，可隨意擺放圖案。
- 點擊輸出物品（該道具的紙質物品）以儲存配方。
- 儲存成功後會播放粒子、音效並顯示成功訊息。儲存或註冊失敗時，選單保持開啟，材料留在方格中，並向玩家顯示錯誤。FMM 會嘗試還原先前註冊的配方；若還原也失敗，請檢查主控台。
- 配方儲存到
plugins/FreeMinecraftModels/recipes/<model_id>.yml；是否向 Bukkit 註冊取決於registerCraftingRecipes。 - 註冊成功且啟用了合成時，玩家可以在工作台合成紙質道具物品。
- 儲存前按 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 |
shape | 是 | 最多三列，每列最多三個字元。空格代表「空格位」 |
ingredients | 是 | 單一形狀字元對應到 Bukkit 材料名稱的映射。無法辨識的材料會被靜默捨棄 |
shopEnabled | 否（預設 true） | 該配方是否列在 /fmm shop 中 |
shopPrice | 否（預設為 shop_config.yml 的 defaultPrice） | 商店中的 Vault 貨幣售價 |
Bukkit 配方鍵為 freeminecraftmodels:prop_recipe_<model_id>，輸出一律是模型的紙質放置物品，不是具有指定材料和附魔的自訂手持物品。重新執行 /fmm craftify 會取代檔案，並在啟用合成時嘗試以相同鍵註冊。
FMM 會讀取 recipes/ 底下（包括子資料夾）的所有 .yml，並將它們載入為單一目錄。每個 model_id 只能有一個啟用的配方檔案。同一 model_id 若有第二個啟用的檔案，或有檔案存在 YAML 語法錯誤，/fmm reload 會被拒絕並保留目前的配方，同時提示執行者查看主控台。在啟動時，同樣的問題只會讓配方目錄被拒絕：FMM 仍會完成啟動，但在您修正該檔案並執行 /fmm reload 之前，不會有任何道具配方或家具商店項目。請在主控台查看 Prop recipe catalog rejected、Duplicate recipe model 或 Cannot prepare prop recipes。
權限
在 plugin.yml 中註冊
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.* | OP | 萬用字元，授予 freeminecraftmodels.admin、freeminecraftmodels.deleteall、freeminecraftmodels.disguise.self、freeminecraftmodels.disguise.others、freeminecraftmodels.bypassregionprotection 和 freeminecraftmodels.pets.admin。該萬用字串同時也是下列指令所需的字面權限：/fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug、/fmm packetdebug、/fmm filmic、/fmm boneglide、/fmm location、/fmm setup、/fmm initialize、/fmm recommendedplugins、/fmm downloadall、/fmm downloadallcontent、/fmm updatecontent、/fmm downloadpluginupdate、/fmm applypluginupdate 和 /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 | 略過 FMM 的道具放置與互動保護查詢，包括 preventPropPlacementInProtectedRegions。可用空間檢查仍然生效 |
freeminecraftmodels.menu | true | 存取 /fmm 可合成物品選單（所有玩家皆可使用） |
freeminecraftmodels.shop | true | 存取 /fmm shop（商店啟用時所有玩家皆可使用） |
指定目標玩家的 disguise 和 undisguise 命令同時需要 freeminecraftmodels.disguise.self 和 freeminecraftmodels.disguise.others。disguiselist 只需要 .others。
寵物權限
| 權限 | 預設 | 說明 |
|---|---|---|
freeminecraftmodels.pets | true | 存取 /fmm pets（所有玩家皆可使用） |
freeminecraftmodels.pets.admin | OP | 萬用字元的子權限；存取 /fmm petadmin 和 /fmm petmigrate |
由 MagmaCore 註冊
| 權限 | 預設 | 說明 |
|---|---|---|
nightbreak.login | OP | 共享的 /nightbreaklogin 和 /nightbreaklogout 指令所需。由最先載入的 Nightbreak 外掛在每台伺服器上註冊一次 |
nightbreak.plugins | OP | 共享的 /nightbreak plugins 指令所需。由最先載入的 Nightbreak 外掛在每台伺服器上註冊一次 |
發送者注意事項
initialize、setup、spawn、itemify、mount、giveitem、craftify、hitbox visualize、location、admin、shop、pets、petadmin和petmigrate是僅限玩家的指令。/freeminecraftmodelschangelog也僅限玩家。reload、stats、recommendedplugins、downloadall、downloadallcontent、updatecontent、downloadpluginupdate、applypluginupdate、forcereinstallcontent、packetdebug、debug、filmic、boneglide、deleteall、/nightbreaklogin、/nightbreaklogout和/nightbreak plugins接受玩家與主控台執行（deleteall的半徑參數僅限玩家）。disguise和undisguise接受目標玩家，只要有提供目標就可以從主控台執行。version沒有權限限制，任何人（玩家或主控台）皆可執行。/fmm initialize為擁有freeminecraftmodels.*權限的玩家開啟首次設定選單。日常內容管理使用/fmm setup。