跳至主要内容

FreeMinecraftModels 設定

本頁說明目前 config.yml 中會明顯影響 setup、渲染與玩家互動的設定。

檔案位置​

plugins/FreeMinecraftModels/config.yml

目前已驗證的設定​

setupDone​

  • 預設值：false
  • 控制首次設定引導是否被視為已完成
  • 只要這個值仍然是 false，擁有較高 FreeMinecraftModels 權限的玩家就會收到執行 /fmm initialize 的提醒
  • 正常引導流程會自動切換這個值，因此通常不需要手動修改

useDisplayEntitiesWhenPossible​

  • 預設值：true
  • 告訴 FreeMinecraftModels 在伺服器與客戶端路徑支援時優先使用 display entity 渲染
  • 當 display entity 無法使用時，外掛仍然會回退到其他方式
  • Bedrock 客戶端屬於特殊情況，因此不要假設這個選項會讓所有玩家都使用相同的渲染路徑

maxModelViewDistance​

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

maxInteractionAndAttackDistance​

  • 預設值：3
  • 適用於靜態與動態模型實體
  • 執行期間的互動檢查與攻擊判定都會使用這個值

maxInteractionAndAttackDistanceForProps​

  • 預設值：6
  • 適用於 prop 實體
  • 這個值與靜態/動態實體的互動距離分開設定

sendCustomModelsToBedrockClients​

  • 預設值：false
  • 控制 FreeMinecraftModels 是否嘗試向 Bedrock 客戶端傳送自訂模型
  • 若停用，Bedrock 玩家會回退到對應的原版實體（如果存在）
  • 若你啟用它，請先確認你的 Bedrock/Geyser/Floodgate resource-pack 分發路徑確實已為這些客戶端準備完成

作業說明​

  • /fmm reload 會重新匯入內容並重新產生輸出包，因此影響渲染行為的設定變更最好在 reload 後再驗證
  • FreeMinecraftModels 只會產生 resource pack；它本身不會自行託管該資源包
  • ResourcePackManager 仍然是 Java 客戶端的建議分發方式，也是混合環境下目前最安全、最完整記錄的路徑

何時應該修改這些值​

這份設定用於調整執行時行為，而不是管理內容套件。

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

已知注意事項​

  • 本地儲存庫中的 plugin.yml 與 pom.xml 之間存在版本中繼資料漂移，因此本頁刻意記錄行為，而不是固定某個公開版本字串
  • Bedrock 行為同時取決於這份設定與你整體的 Floodgate/Geyser/resource-pack 架構，因此在沒有測試你自己實際環境之前，應維持保守描述