FreeMinecraftModels 配置

本頁涵蓋目前 config.yml 中對設定、渲染和玩家互動有實質影響的設定。

檔案位置

plugins/FreeMinecraftModels/config.yml

當前已驗證的設定

setupDone

• 預設值：false
• 控制首次設定引導是否被視為已完成
• 擁有廣泛 FreeMinecraftModels 權限的玩家，在此值仍為 false 時會被提醒執行 /fmm initialize
• 設定流程會自動為你切換此值；在正常引導過程中你不需要手動編輯它

useDisplayEntitiesWhenPossible

• 預設值：true
• 告知 FreeMinecraftModels 在伺服器和客戶端路徑支援時，優先使用展示實體渲染
• 當展示實體不可用時，外掛仍會回退
• Bedrock 客戶端是特殊情況，因此不要假設此設定會對每個玩家強制使用相同的渲染路徑

maxModelViewDistance

• 預設值：60
• 限制模型實體傳送給觀察者的距離
• 在模型密集的區域中，較低的值可以減少封包和客戶端渲染負載

maxInteractionAndAttackDistance

• 預設值：3
• 適用於靜態和動態模型實體
• 由運行時互動和命中偵測檢查使用

maxInteractionAndAttackDistanceForProps

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

sendCustomModelsToBedrockClients

• 預設值：false
• 控制 FreeMinecraftModels 是否嘗試向 Bedrock 客戶端傳送自訂模型
• 如果停用，Bedrock 玩家會回退到底層的原版實體（如果存在的話）
• 如果啟用，請確保你的 Bedrock/Geyser/Floodgate 資源包路徑確實已為這些客戶端準備好

權限

已在 plugin.yml 中註冊

權限	預設	說明
freeminecraftmodels.*	op	授予所有 FreeMinecraftModels 指令的存取權
freeminecraftmodels.admin	op	授予管理指令的存取權，如 /fmm admin 和 /fmm giveitem
freeminecraftmodels.menu	true	授予 /fmm 可合成物品選單的存取權（預設所有玩家可用）

由指令強制執行（未在 plugin.yml 中註冊）

權限	預設	說明
freeminecraftmodels.deleteall	op	授予 /fmm deleteall 的存取權（在運行時由指令處理器檢查）

模型 YML 配置

每個 .bbmodel 檔案都可以有一個伴隨的 .yml 檔案（同名、同目錄），用於控制模型特定的設定。統一的 YML 格式支援以下欄位：

isEnabled: true
voxelize: true
solidify: true
scripts:
  - my_script.lua
material: DIAMOND_SWORD
name: "&bFrost Blade"
lore:
  - "&7A sword forged in ice"
  - "&7Deals frost damage"
enchantments:
  - SHARPNESS,3
  - UNBREAKING,2

欄位	類型	說明
isEnabled	boolean	模型是否載入（預設：true）
scripts	字串列表	要附加的 Lua 腳本檔名（來自 plugins/FreeMinecraftModels/scripts/）
voxelize	boolean	為 true 時，道具放置時對齊到 90 度旋轉增量並對齊到方塊網格。佔地面積從模型碰撞箱尺寸計算（四捨五入到整數方塊）。放置時會檢查佔地面積中的所有方塊是否為非固體。
solidify	boolean	為 true 時（需要 voxelize: true），在道具佔地面積的每個方塊中放置僅限封包的屏障方塊，使其具有客戶端碰撞。這些屏障是不可見的，僅存在於封包中 — 不會放置在世界中。當道具被拾取或銷毀時，屏障會自動移除。
material	字串	Bukkit 材料名稱（例如 DIAMOND_SWORD、PAPER）。設定後，模型成為玩家可以手持和裝備的自訂物品
name	字串	自訂物品的顯示名稱（支援 & 顏色代碼）
lore	字串列表	自訂物品的說明文字行（支援 & 顏色代碼）
enchantments	字串列表	附魔，格式為 ENCHANTMENT_NAME,LEVEL（例如 SHARPNESS,3）

當 material 被設定後，模型會被註冊為自訂物品。玩家可以透過 /fmm giveitem 獲得它，如果配置了配方也可以合成，並且可以使用全部 22 個 Lua 物品鉤子。

操作注意事項

• /fmm reload 會重新匯入內容並重新生成輸出資源包，因此影響渲染行為的配置變更在重新載入後最容易驗證
• FreeMinecraftModels 只負責生成資源包；它不會自行託管
• ResourcePackManager 仍然是 Java 客戶端的推薦傳送路徑，也是混合設定中最安全的文件記載路徑

何時變更這些值

使用此配置進行運行時行為調整，而非內容包管理。

• 使用 /fmm initialize、/fmm setup、/fmm downloadall 和 /fmm updatecontent 進行官方包生命週期管理
• 使用 imports 資料夾進行手動 .bbmodel 或其他本地內容匯入
• 當你需要調整渲染模式、可見距離、互動距離或 Bedrock 行為時使用 config.yml

已知注意事項

• 本地儲存庫在 plugin.yml 和 pom.xml 之間存在版本中繼資料漂移，因此本頁刻意記錄行為而非固定的公開版本字串
• Bedrock 行為取決於此配置和你更廣泛的 Floodgate/Geyser/資源包設定，因此除非你已測試過你的確切堆疊，否則請保守陳述