跳至主要內容

FreeMinecraftModels 配置

模型的 YAML 設定會在重新載入內容時統一準備。編輯道具的 YAML 後,請先成功重新載入,再建立新道具。請讓每個模型 YAML 在所有模型資料夾中都使用唯一的檔名。當兩個檔案的檔名相同(不區分大小寫)時,即使位於不同子資料夾,FMM 也只會載入絕對路徑排序在最前面的那個,並以 Duplicate content filename 警告略過其他檔案。若被略過的副本所有數值都與已載入的檔案相同,則會直接略過而不發出警告。

此頁面涵蓋當前 config.yml 與 shop_config.yml 中會對設定、渲染、玩家互動以及可選家具商店產生實質影響的設定。pets.yml 中的寵物設定請見寵物。

檔案位置​

plugins/FreeMinecraftModels/config.yml
plugins/FreeMinecraftModels/shop_config.yml
plugins/FreeMinecraftModels/pets.yml

shop_config.yml 會在首次執行時生成;商店本身在你選擇啟用前都會保持停用。pets.yml 會在首次執行時以 COSMETIC 模式生成,此模式下只有玩家擁有的寵物存在。寵物所執行的 Lua 模組位於 plugins/FreeMinecraftModels/pet_behaviors/;請參閱寵物行為模組。

最低伺服器版本

plugin.yml 宣告 api-version: 1.21.4,因此 Minecraft 1.21.4 是支援的最低伺服器版本。對更舊版本線的支援已移除;舊有的渲染/輸出分支雖仍存在於程式碼中,但在能夠載入此外掛的伺服器上已經不可能被觸及。

config.yml 設定​

setupDone​

  • 預設:false
  • 控制首次設定引導是否視為完成
  • 此值為 false 時,擁有 freeminecraftmodels.* 的玩家每次登入約10秒後,若仍在線上,就會收到提醒
  • 開啟 /fmm setup 會為整個伺服器儲存 true 並停止後續提醒。選擇 /fmm initialize 的完成項目也會儲存此值;它不能證明資源包已安裝或已傳送至用戶端

nightbreak.autoDownloadPluginUpdates​

  • 預設:false
  • 共用的 MagmaCore 設定(位於 config.yml 的 nightbreak: 區段下)
  • 為 true 時,FreeMinecraftModels 會在啟動時自動下載可用的外掛 jar 更新以及內容更新檔案
  • 下載的外掛和內容更新會在伺服器重啟後套用,除非 nightbreak.applyPluginUpdatesWithoutRestart 更早套用外掛更新
  • 自動下載外掛需要有效的 Nightbreak 帳號權杖以及有效的支持者 Patreon 會籍。若兩者不齊備,請將此值保持為 false,改用遊戲內的更新按鈕
  • 自動內容更新針對已安裝的內容包,並延後重新載入。這不等於用 /fmm downloadall 安裝所有可存取的內容包。可透過 /fmm setup 或手動切換

nightbreak.applyPluginUpdatesWithoutRestart​

  • 預設:never
  • 共用的 MagmaCore 設定(位於 config.yml 的 nightbreak: 區段下)。它決定已下載的外掛更新何時在不重啟的情況下套用
  • never:更新會等到下次重啟。你仍可用 /fmm applypluginupdate 手動套用
  • when-empty:在下次沒有玩家在線時套用更新。FMM 每 30 秒檢查一次
  • immediately:更新下載完成後立即套用
  • 其他任何值都視為 never
  • 套用更新會停用 FreeMinecraftModels 以及所有相依於它的 MagmaGuy 外掛,替換 jar,然後再次載入並啟用它們。這些外掛重新載入時,進行中的 Boss、競技場與地城實例都會結束
  • 若有其他作者的外掛相依於 FreeMinecraftModels,則無法進行替換,更新會等到重啟時套用。若新的 jar 無法啟用,會重新載入先前的 jar,更新則保留至下次重啟時套用。請參閱指令

useDisplayEntitiesWhenPossible​

  • 預設:true
  • 告訴 FreeMinecraftModels 在伺服器與客戶端路徑支援時優先使用 display entity 渲染
  • 設為 false 會讓 Java 用戶端以盔甲座渲染骨骼。保留的 1.19.4 之前的舊分支不代表支援舊伺服器
  • 啟用 Bedrock 模型且原生自訂實體橋接可用時,Bedrock 玩家會使用該顯示方式。否則,其骨骼渲染路徑使用盔甲座。此設定不會強制每位玩家使用相同後端

maxModelViewDistance​

  • 預設:60
  • 設定一般觀看距離上限。在模型稀少的世界中,小於10格的近距離例外會略過距離與遮蔽檢查,因此低於10的值在這些世界中不是嚴格上限
  • 較低的值可以減少在模型密集區域的封包與客戶端渲染負擔
  • 已經看得到某個模型的玩家,會持續看到它,直到模型超出此距離 4 格為止,因此沿著邊緣移動的模型不會忽隱忽現
  • 個別實體可以在執行階段透過 ModeledEntity.setViewDistanceOverride(int) 覆寫此值 — 請參閱 API 指南

maxInteractionAndAttackDistance​

  • 預設:3
  • 適用於靜態與動態模型化實體
  • 用於執行階段互動與命中偵測檢查

maxInteractionAndAttackDistanceForProps​

  • 預設:6
  • 適用於道具實體
  • 此值與靜態/動態實體的互動距離分開

sendCustomModelsToBedrockClientsV2​

  • 預設:true
  • 控制 FreeMinecraftModels 是否嘗試將自訂模型傳送給 Bedrock 客戶端
  • 此鍵取代了較舊的 sendCustomModelsToBedrockClients(其預設為 false)。重新命名為 V2 會翻轉預設值,使 Bedrock 玩家預設就能看到模型;如果你之前曾明確設定舊鍵,可以刪除它,新的 V2 鍵會接管
  • 如果停用,Bedrock 玩家會回退到底層的原版實體(如果存在),偽裝對他們不會渲染
  • 如果啟用,請確保你的 Bedrock/Geyser/Floodgate 資源包路徑確實已為這些客戶端準備好
  • Bedrock 診斷日誌並非設定鍵。請用 /fmm debug bedrock on|off 切換,並在收集證據後明確關閉。/fmm reload 不會重設此旗標,重新啟動伺服器才會。請參閱指令

skipUnchangedBoneUpdates​

  • 預設:true
  • 為 true 時,若追蹤的轉換沒有超出比較容差,便略過骨骼的移動與中繼資料更新。展示實體骨骼追蹤位置、旋轉和縮放;盔甲座骨骼追蹤位置和旋轉
  • 靜止骨骼通常略過這些更新,但染色等明確標記為已變更的狀態會強制重新傳送
  • 定期完整同步仍會修正用戶端偏差;此選項不會抑制所有類型的模型封包
  • 只有為了除錯而想恢復舊的「每 tick 一律重送每個骨骼」行為時,才把它設為 false

useDeltaMetadataPackets​

  • 預設:true
  • 為 true 時,display-entity 模型骨骼的每 tick 中繼資料封包只會傳送有變動的值(骨骼的轉換),而不是每 tick 重新序列化整個 item-display 資料塊(物品模型 + 自訂模型資料)
  • 玩家第一次看到某個模型時以及週期性重新同步時,仍會傳送完整狀態
  • 設為 false 可為了除錯或比較而恢復舊的「每 tick 完整快照」行為

displayBonesRideTheirEntity​

  • 預設:true
  • 為 true 時,動態模型的展示實體骨骼會在 Java 用戶端上作為乘客騎在它的實體上。用戶端會從它用於該實體及其乘客的同一個平滑後位置來放置每根骨骼,因此坐騎、騎乘者與移動中的模型會保持在一起,而不是落在後面,骨骼也不會傳送位置封包
  • 這適用於 /fmm mount 這類坐騎,以及其隱藏實體透過 modelViewersTrackHiddenBodies 被追蹤的模型。只有在每位 Java 觀看者的用戶端都追蹤該實體時,骨骼才會騎乘。模型最遠可顯示到 maxModelViewDistance(預設 60 格),而 Spigot 預設追蹤動物和怪物到 48 格,因此 FreeMinecraftModels 會讓伺服器追蹤該實體到觀看距離再加 6 格(預設 66 格),並在模型被移除時將實體原本的追蹤範圍還給它。若某位玩家的用戶端仍未追蹤該實體(例如因為他自己的視野距離較短),該玩家就看不到這個模型,因此一位遠處的玩家無法讓其他所有觀看者都回到逐骨骼傳送。透過 API 指定了自己觀看距離的模型會略過這項檢查。當外掛對某位觀看者隱藏該實體時,以及模型死亡期間,骨骼仍會回到逐骨骼傳送
  • Bedrock 玩家不受影響
  • 設為 false 可讓每個模型維持逐骨骼傳送,與以前相同

riddenBoneInterpolationTicks​

  • 預設:1
  • Java 用戶端需要幾個 tick,才將一根騎乘中的骨骼滑行到它的下一個動畫姿勢。0 表示每個 tick 都直接吸附。1 表示在一個 tick 內滑行,這也會讓旋轉更平滑
  • 只有騎在實體上的骨骼才會使用它;請參閱 displayBonesRideTheirEntity
  • /fmm boneglide <ticks> 可在 FMM 重新載入之前變更它,不必編輯此檔案。請參閱指令

riddenBoneUpdateIntervalTicks​

  • 預設:2
  • 當模型只播放其移動循環動畫(idle、idle.long、walk,或騎乘或游泳動畫;請參閱狀態動畫)時,騎乘中的骨骼每隔幾個 tick 向 Java 用戶端傳送一次它的動畫姿勢。1 表示每個 tick 都傳送。2 表示每隔一個 tick 傳送一次,用戶端會滑行跨越這兩個 tick,這會讓有動畫的模型傳送的封包減半,而緩慢的動作看起來不變。小於 1 的值視為 1
  • 攻擊和其他所有動畫仍會每個 tick 傳送一次姿勢。每個模型都從間隔中各自的時間點開始,因此一群模型的更新會錯開
  • 只有騎在實體上的骨骼才會使用它;請參閱 displayBonesRideTheirEntity
  • 另外,若 Java 玩家上一批骨骼姿勢尚未離開伺服器,就會略過新的姿勢,直到它離開為止,因此連線緩慢的玩家會以其能承載的最快速度取得姿勢,而不是越落越遠。生成、移除與騎乘仍會傳給該玩家。它的下一個姿勢會帶有它錯過的數值,因此它的模型最終會落在其他人看到的位置。這適用於每根展示骨骼(無論是否騎在實體上),沒有對應的設定,且需要 FreeMinecraftModels 2.15.0 或更新版本。直到 2.14.2 為止,每個姿勢都會傳給每位玩家,無論其連線落後多遠

cullOffscreenBones​

  • 預設:true
  • 為 true 時,Java 用戶端會在模型的每根展示實體骨骼位於畫面外時略過繪製該骨骼,這能為用戶端省下視野外模型的大部分渲染工作
  • 若某根骨骼的立方體在它所立足之點的上方和下方都延伸得很遠,該骨骼一律會被繪製
  • 若模型的某部分曾在畫面邊緣消失,請設為 false
  • Bedrock 玩家不受影響

modelViewersTrackHiddenBodies​

  • 預設:true
  • 為 true 時,每位看得到「實體已隱藏的動態模型」的 Java 玩家,也會收到該實體,並以一個隱形且已卸除裝備的本體呈現。模型的骨骼隨後即可騎在它上面,如 displayBonesRideTheirEntity 所述
  • 其他玩家與 Bedrock 玩家仍和以前一樣,該實體對他們保持隱藏
  • 設為 false 可讓被隱藏的實體保持不被追蹤,其骨骼則維持逐骨骼傳送

idleWalkBlendTicks​

  • 預設:5
  • 實驗性。模型需要幾個 tick,才在它的 idle 與 walk 動畫之間完成交叉淡入淡出。淡入淡出期間兩個動畫都會持續播放。FreeMinecraftModels 2.15.0 及更新版本對 idle.long 以及騎乘與游泳動畫使用相同的淡入淡出
  • 0 表示立即切換,與舊版相同
  • Bedrock 玩家在 idle 與 walk 上會獲得相同的淡入淡出時間。它寫入產生的 Bedrock 動畫控制器中,因此要等資源包重新產生後,他們才會看到變更
  • 請參閱動畫混合

deathBlendTicks​

  • 預設:4
  • 實驗性。模型需要幾個 tick,才從它目前保持的姿勢淡入 death 動畫。0 表示立即切換,與舊版相同
  • 資源包重新產生後,Bedrock 玩家也會獲得相同的淡入淡出時間

longIdleMinSeconds​

  • 預設:15
  • 擁有 idle.long 動畫的模型在播放一次 idle.long 之前,於沒有其他動畫播放時顯示 idle 的最短時間。每次等待是從 longIdleMinSeconds 到 longIdleMaxSeconds 之間的隨機秒數
  • 小於 0 的值視為 0,大於 longIdleMaxSeconds 的值視為 longIdleMaxSeconds
  • 需要 FreeMinecraftModels 2.15.0 或更新版本。請參閱狀態動畫

longIdleMaxSeconds​

  • 預設:30
  • 這類等待的最長時間。移動、攻擊、其他動畫與騎乘者都會讓等待重新開始
  • 設為 0 或更小時,永遠不會播放 idle.long
  • 沒有 idle.long 動畫的模型不受影響

weightedTurning​

  • 預設:true
  • 實驗性。為 true 時,動態模型會帶著慣性朝其生物的面向轉動:它會加速、以受限的速度轉動,然後減速並停在新的面向上而不過頭。較大的模型轉得較慢
  • 只有模型會這樣轉動。生物本身仍和以前完全一樣地轉向與行走
  • 當玩家直接騎乘模型的生物,或坐在它的某個 m_ 座位上時,模型會瞬間轉向
  • 設為 false 可讓模型隨其生物瞬間轉向,與舊版相同
  • 關於大小如何改變這些限制,請參閱轉向慣性

turnSpeedCap​

  • 預設:30
  • 實驗性。大小為一格的模型的最高轉向速度,單位為每 tick 的度數
  • 此上限會除以模型大小的平方根,且絕不超過每 tick 90 度

turnAcceleration​

  • 預設:6
  • 實驗性。大小為一格的模型,每個 tick 在轉向速度上增加或減少的每 tick 度數
  • 它會除以模型的大小,因此較大的模型加速與減速都比較慢
  • 值為 0 或更小,就像 turnSpeedCap 為 0 或更小一樣,會讓模型瞬間轉向

maxModelsForProximityOverride​

  • 預設:25
  • 近距離可見性覆寫的偽負載平衡器
  • 一般情況下,距離玩家小於10格的模型會略過用於選擇觀看者的距離和遮蔽檢查;其他可見性規則仍然適用
  • 在密集區域(例如多層樓的 NPC 中樞),該覆寫會把玩家實際上看不見的數十個模型 —— 在其他樓層、在牆後 —— 變成每 tick 都要發送封包的觀看者
  • 當某個世界中載入的模型數達到此值時,該世界會停用近距離例外。即使很近,也必須通過設定的距離和可見性檢查。可見性檢查取樣模型中心與碰撞箱角點;沒有碰撞箱則通過檢查。模型稀少的世界保留例外
  • 此判定是以世界為單位而非全域,因此擁擠的中樞世界不會拖累安靜的世界
  • 把它調得非常高可實質恢復永遠覆寫的行為;設為 0 則一律要求視線
  • /fmm packetdebug 是用來測量效果的預期工具 —— 請參閱指令

filmicMode​

注意

不建議在錄影以外的情況使用。電影模式會向每位玩家傳送多得多的封包,並讓伺服器為每個已載入的模型播放動畫。在玩家眾多的伺服器上可能會造成卡頓。

  • 預設:false
  • 用於以 ReplayMod 或類似的錄影模組錄製預告片與影片
  • 一般情況下,玩家只會在模型位於 maxModelViewDistance 範圍內且通過視線檢查時收到該模型。被隱藏的模型會從該用戶端移除並停止動畫。重播只包含錄影用戶端收到的內容,因此當重播鏡頭看向這些模型時,它們會缺失或靜止不動
  • 為 true 時,每位玩家都會收到其已載入區塊中的所有已載入模型,而且這些模型會持續播放動畫,即使位於牆後或超出 maxModelViewDistance 也一樣。已載入區塊的範圍是世界的視野距離(上限為用戶端的顯示距離)再加一個區塊。未載入區塊中的模型仍不會顯示
  • 若只想在錄影期間開啟,請使用 /fmm filmic on|off,而不要編輯此檔案。請參閱指令

particleEffectsEnabled​

  • 預設:true
  • 為 false 時,模型、道具或手持物品上不會播放任何 Blockbench 粒子效果。模型仍會照常載入並播放動畫
  • 變更會在 /fmm reload 或重啟後生效。Java 玩家在 FMM 重新載入後即可看到變化。Bedrock 玩家則要在收到重新產生的資源包後才會看到,因為他們的效果是包含在資源包中的
  • 請參閱粒子

maxParticlesPerEmitter​

  • 預設:100
  • 單一模型上單一粒子效果的存活粒子上限。若粒子檔案本身的 max_particles 較低,則以該值為準
  • Java 玩家看到的每個粒子都是一個封包實體,因此數值過高會耗費頻寬

maxParticlesPerViewer​

  • 預設:400
  • 單一 Java 玩家在所有模型中可看到的存活粒子上限
  • 超過此值後,該玩家的新粒子會被略過,直到較舊的粒子消失為止。Bedrock 玩家在自己的用戶端上繪製粒子,不列入計算

preventPropPlacementInProtectedRegions​

  • 預設:true
  • 為 true 時,FreeMinecraftModels 會詢問 MagmaCore 已註冊的保護提供者:這位特定玩家是否可以在該道具將佔用的格子中建造,若答案為否則拒絕該次放置
  • 擁有 freeminecraftmodels.bypassregionprotection 權限(預設:op)的玩家略過這項 FMM 保護檢查。空間檢查與其他外掛的限制仍然有效
  • 內建的玩家權限提供者支援 WorldGuard 與 GriefPrevention,其他外掛也可註冊提供者。提供者拒絕或出錯都會拒絕放置;MagmaCore 也會拒絕受保護位置擁有者涵蓋的地點。沒有拒絕的提供者,也沒有受保護擁有權時,此檢查不增加限制
  • 拒絕訊息為 You don't have permission to place a model here!

提供者檢查這位玩家能否建造,因此領地成員身分可能允許放置。受保護位置擁有權是另一項檢查,沒有針對玩家的豁免。這是在查詢已註冊的整合,並非模擬原版方塊放置事件,所以不能重現所有外掛的放置規則。

每次放置都會進行單格檢查;體素化道具還會額外進行一次全體積檢查:

道具類型檢查的格子
一般(自由形式)道具與被點擊方塊面相鄰的單一格子 —— 也就是該道具將佔用的格子
voxelize: true 道具先檢查同一個相鄰格子,接著檢查該道具在格線對齊放置點周圍旋轉後佔用範圍(寬 x 高 x 深)中的每一個格子。只要該體積中任何一格不可用,整次放置就會被拒絕

體積檢查存在的原因是體素化道具可能寬達數格,若只檢查被點擊的格子,玩家就能跨在領地邊界上把大型道具丟進別人的建築裡。它在空間檢查之後執行,因此當佔用範圍實體受阻時,Not enough space to place this model! 仍優先。

檢查範圍使用 Math.round 對碰撞箱各維度取整,最小為一格。封包屏障範圍使用 ceil(size - 0.4),因此可能不同;放置檢查並不保證涵蓋與用戶端每個碰撞格完全相同的範圍。

備註

查詢提供者之前會先檢查權限。授予 freeminecraftmodels.bypassregionprotection 可讓管理人員免於 FMM 的保護檢查,同時為其他玩家保留此設定。它不會略過空間檢查,也不會撤銷其他外掛取消的事件。

registerCraftingRecipes​

  • 預設:true
  • 如需僅允許購買,請設為 false 並重新啟動。有效且已啟用的配方項目仍留在商店目錄中,但 Bukkit 合成配方會被移除
  • 玩家的 /fmm 可合成物品選單與配方詳情要求配方實際註冊,因此關閉合成的項目不會顯示在這些選單中
  • 單個配方的 isEnabled: false 會將它從已載入目錄中移除,包括商店。shopEnabled: false 僅隱藏購買項目

shop_config.yml​

可選的 Vault 支援家具商店有自己的設定檔,可以獨立於主外掛行為來啟用或調整。如果 Vault 或經濟提供者缺失,商店將拒絕註冊。

頂層鍵​

鍵預設說明
enabledfalse/fmm shop 的主開關。只有當此值為 true 且 Vault 與經濟提供者皆存在時,該指令才會註冊
defaultPrice100.0缺少 shopPrice 的配方所用預設價格;非正數會改用 100.0。修改此預設值不會改變已儲存的配方價格
menuTitle&8FMM - Furniture Shop商店物品欄頂部顯示的標題(支援 & 顏色代碼)
priceLoreFormat&7Price: &e{price}附加到每個商店物品上顯示其價格的物品說明行。佔位符:{price}
clickToBuyLoreFormat&aClick to purchase附加到每個商店物品上提示購買的物品說明行

訊息鍵(messages.*)​

所有訊息字串都支援 & 顏色代碼。

鍵預設佔位符
messages.purchaseSuccess&aPurchased &f{item} &afor &e{price}&a. Balance: &e{balance}&a.{item}、{price}、{balance}
messages.insufficientFunds&cYou need &e{price} &cto buy &f{item}&c. Balance: &e{balance}&c.{item}、{price}、{balance}
messages.shopDisabled&cThe furniture shop is currently unavailable.無
messages.itemNotForSale&cThat item is not currently for sale.{item}
messages.inventoryFull&eYour inventory was full; &f{item} &ehas been dropped at your feet.{item}

每個配方的商店欄位​

plugins/FreeMinecraftModels/recipes/<model_id>.yml 中的每個配方檔案都會獲得兩個額外欄位:

欄位預設說明
shopEnabledtrue此配方是否在 /fmm shop 中顯示。false 本身不會停用合成;配方啟用狀態與 registerCraftingRecipes 仍然適用
shopPrice來自 shop_config.yml 的 defaultPrice此特定物品的 Vault 貨幣成本

配方建構器(/fmm craftify)在儲存時會寫入這兩個欄位,所以調整價格只需要編輯一下文字檔。

權限​

在 plugin.yml 中註冊​

權限預設說明
freeminecraftmodels.*op萬用字元,授予 admin、deleteall、self/others 偽裝、區域保護繞過、寵物管理和寵物給予權限,自 2.15.0 之後的版本起還包括生物行為管理權限
freeminecraftmodels.adminop存取 /fmm admin(管理員內容瀏覽器)和 /fmm giveitem。其他管理/除錯指令(/fmm location、/fmm spawn、/fmm mount、/fmm itemify、/fmm craftify、/fmm reload、/fmm stats、/fmm hitbox visualize、/fmm debug、/fmm packetdebug、/fmm filmic、/fmm boneglide、/fmm setup、/fmm initialize、/fmm recommendedplugins、/fmm downloadall、/fmm downloadallcontent、/fmm updatecontent、/fmm downloadpluginupdate、/fmm applypluginupdate、/fmm forcereinstallcontent)改為檢查萬用字元 freeminecraftmodels.*
freeminecraftmodels.deleteallop萬用字元的子權限;存取 /fmm deleteall
freeminecraftmodels.disguise.selfop允許對發送者本人使用 /fmm disguise / /fmm undisguise
freeminecraftmodels.disguise.othersop允許指定目標的偽裝/取消偽裝,以及 /fmm disguiselist
freeminecraftmodels.bypassregionprotectionop略過 FMM 的放置與互動保護檢查,包括啟用 preventPropPlacementInProtectedRegions 時;不覆寫其他外掛的事件取消或空間要求
freeminecraftmodels.menutrue存取 /fmm 可合成物品選單
freeminecraftmodels.shoptrue存取 /fmm shop
freeminecraftmodels.petstrue存取 /fmm pets
freeminecraftmodels.pets.adminop萬用字元的子權限;存取 /fmm petadmin,自 2.15.0 之後的版本起還包括 /fmm petmigrate
freeminecraftmodels.pets.giveop萬用字元的子權限;存取 /fmm givepet,該指令也可從主控台執行
freeminecraftmodels.mobbehaviors.adminop萬用字元的子權限;存取 /fmm mobbehavior。需要 2.15.0 之後的 FreeMinecraftModels 版本
nightbreak.loginop由 MagmaCore 註冊,而非由 plugin.yml 註冊。共享的 /nightbreaklogin 與 /nightbreaklogout 指令需要此權限
nightbreak.pluginsop由 MagmaCore 註冊,而非由 plugin.yml 註冊。共享的 /nightbreak plugins 指令需要此權限

寵物指令的說明請參閱寵物。

模型 YML 配置​

模型的配套 .yml 與 .bbmodel 使用相同基本名稱並位於同一目錄。道具與手持物品使用不同的設定部分。

道具​

isEnabled: true
name: "&6Oak Table"
lore:
- "&7Seats four"
voxelize: true
solidify: true
scripts:
- my_prop.lua
欄位說明
isEnabled是否啟用定義;預設為 true
name道具放置物品的顯示名稱。支援顏色代碼。沒有它時,物品會以模型命名,例如 ✦ Oak Table ✦
lore放置物品的說明文字。支援顏色代碼。只要有 lore 鍵,就會取代預設說明文字(放置與拾取提示加上模型 ID),空清單(lore: [])則會將它移除
scripts來自 plugins/FreeMinecraftModels/scripts/ 的獨立道具 Lua 腳本
voxelize按方塊網格及90度增量對齊放置和旋轉,並檢查旋轉後整個佔用範圍的可用空間
solidify配合體素化傳送僅存在於封包中的屏障方塊,提供用戶端碰撞;它們不是世界方塊,會隨道具一同移除

放置物品的 name 與 lore 適用於 FMM 建立該物品的任何地方:/fmm itemify、合成配方產出、商店購買,以及從管理員選單取得的物品。選單項目(例如商店的商品列表與購買訊息)仍會顯示由模型 ID 形成的名稱。已在物品欄中的物品會保留舊的名稱與說明文字。

手持物品​

isEnabled: true
material: DIAMOND_SWORD
name: "&bFrost Blade"
lore:
- "&7A sword forged in ice"
enchantments:
- "minecraft:sharpness,3"
- "minecraft:unbreaking,2"

material 選擇 Bukkit 物品材質,註冊手持物品而不是道具。name 和 lore 支援顏色代碼。附魔使用帶命名空間的小寫 ID 及正整數等級。當某個附魔是物品套裝時,物品的說明文字會在含有 $itemSet 的說明文字行顯示該套裝的部件;沒有任何一行含有它時,則顯示在說明文字之後。透過 /fmm giveitem <id> 或管理員選單取得已註冊物品。道具配方和商店建立的是紙製放置物品,並非這裡由作者定義的手持物品。

若要為皮革盔甲染色,請在材質後面加上 RGB 十六進位顏色(不含 #),與 EliteMobs 裝備的寫法相同:material: LEATHER_CHESTPLATE:ff8800。此後綴只適用於名稱以 LEATHER_ 開頭的材質,例如皮革盔甲部件與皮革馬鎧。在其他材質上加上後綴,或數值不是一到六位的十六進位數字,會導致物品目錄被拒絕:/fmm reload 會保留目前的目錄,主控台則會指出該檔案。已在物品欄中的物品會保留原本的顏色。

更新相容性

裝備物品的 Lua 腳本已停用。手持物品定義若包含非空的 scripts:、SHARPNESS,3 等無命名空間的舊附魔,或伺服器上不可用的材質,會被略過並輸出診斷。FMM 不會更改作者檔案。請移除舊物品腳本繫結,透過附魔定義撰寫效果;道具腳本仍受支援。

魔杖和法杖請新增魔法武器定義。不要把武器行為放進道具腳本或已停用的物品鉤子。

運作說明​

  • /fmm reload 先匯入並驗證作者定義的物品、附魔和道具配方,同時維持目前目錄運作。驗證失敗會拒絕重新載入;成功後則完整重新初始化,包括 config.yml、shop_config.yml、pets.yml、配方、模型、寵物物種、寵物行為模組及資源包輸出。同時發起的初始化或重新載入要求會被拒絕
  • 完整初始化成功後會安排在40 tick 後發出 FmmReloadedEvent,供相依外掛重新繫結模型附件。匯入器觸發的較小範圍內容重新載入也會在成功時發出此事件。它會重建模型、物品、附魔、道具腳本和配方,但不會重新讀取 config.yml 或 shop_config.yml。如果該內容路徑清空運作中的登錄表後失敗,FMM 會被停用。道具配方失敗是例外:FMM 會記錄 Prop recipe catalog rejected,並保持先前的配方繼續運作。驗證遭拒不等於重新載入完成
  • 卸載世界時,FMM 移除道具的執行階段模型,保留持久化的底層盔甲座。重新載入這些實體時,會去除重複並還原道具。這不同於永久拾取或銷毀道具
  • 固定的 ZIP 時間戳記與有序的模型映射可減少不必要的變化,但檔案系統的遍歷順序仍可能在模型未變時改變 ZIP 位元組與 SHA1。因此不保證輸出完全相同。請參閱資源包輸出。
  • FreeMinecraftModels 只負責生成資源包,並不會自行託管。
  • ResourcePackManager 仍然是 Java 客戶端的建議傳遞路徑,也是混合配置下最安全且有文件記錄的路徑。
  • WorldGuard、WorldEdit、GriefPrevention、Vault、floodgate 和 Geyser-Spigot 在 plugin.yml 中宣告為 softdepend。WorldGuard 與 GriefPrevention 提供內建保護查詢;WorldEdit 不是獨立的保護提供者。Vault 加經濟提供者可啟用商店。對應的 Bedrock 顯示方式需要用戶端辨識、渲染橋接和資源包傳遞都可用

何時要變更這些值​

請將此設定用於執行階段行為調整,而非內容包管理。

  • 使用 /fmm setup、/fmm downloadall 與 /fmm updatecontent 進行官方包的生命週期工作
  • 使用 imports 資料夾進行手動 .bbmodel 或其他本機內容匯入工作
  • 在需要調整渲染模式、可視距離、互動距離、Bedrock 行為、區域保護強制執行或自動更新下載時使用 config.yml
  • 在模型密集的世界中,使用 skipUnchangedBoneUpdates、useDeltaMetadataPackets 與 maxModelsForProximityOverride 進行封包/頻寬調校。這三者的預設值都是已最佳化的行為;false 或極高的設定是為了除錯與 A/B 比較而存在,並非建議的正式環境數值
  • 只在錄製影片時使用 filmicMode(或 /fmm filmic on),錄完後再關閉
  • 使用 idleWalkBlendTicks、deathBlendTicks、longIdleMinSeconds、longIdleMaxSeconds、weightedTurning、turnSpeedCap 與 turnAcceleration 來調整模型的動畫與轉向方式。將混合時間設為 0 並將 weightedTurning 設為 false,即可獲得舊版的瞬間切換與瞬間轉向
  • displayBonesRideTheirEntity 與 modelViewersTrackHiddenBodies 預設為開啟。將它們設為 false 會恢復舊的逐骨骼傳送,移動中的模型與坐騎可能會落在它們的實體後面
  • 若粒子效果繁多的模型耗費太多頻寬,請調低 maxParticlesPerEmitter 與 maxParticlesPerViewer,或設定 particleEffectsEnabled: false
  • 使用 shop_config.yml(以及每個配方的 shopEnabled/shopPrice 欄位)來調整家具商店,無需碰程式碼

已知注意事項​

  • Bedrock 行為同時取決於 sendCustomModelsToBedrockClientsV2 以及你更廣泛的 Floodgate/Geyser/資源包設定,所以除非你已測試過你的確切堆疊,否則請保守地說明。
  • 如果商店已啟用但缺少 Vault 或經濟提供者,商店仍不可用,並會在啟動時記錄具體警告。/fmm version 只會報告外掛版本;/fmm shop 缺失時請檢查這些警告。