跳到主要内容

FreeMinecraftModels 配置

本页介绍当前 config.yml 中实际影响设置、渲染和玩家交互的设置项。

文件位置​

plugins/FreeMinecraftModels/config.yml

当前已验证的设置​

setupDone​

  • 默认值：false
  • 控制首次设置引导是否已完成
  • 当此值为 false 时，拥有广泛 FreeMinecraftModels 权限的玩家会被提醒运行 /fmm initialize
  • 设置流程会自动切换此值；在正常引导过程中您不需要手动编辑它

useDisplayEntitiesWhenPossible​

  • 默认值：true
  • 告诉 FreeMinecraftModels 在服务器和客户端路径支持时优先使用展示实体渲染
  • 当展示实体不可用时，插件仍会回退到其他方式
  • 基岩版客户端是特殊情况，因此不要假设此设置会对每个玩家强制使用相同的渲染路径

maxModelViewDistance​

  • 默认值：60
  • 限制模型实体发送给查看者的最远距离
  • 较低的值可以减少在模型密集区域的数据包和客户端渲染负载

maxInteractionAndAttackDistance​

  • 默认值：3
  • 适用于静态和动态模型实体
  • 用于运行时交互和命中检测检查

maxInteractionAndAttackDistanceForProps​

  • 默认值：6
  • 适用于道具实体
  • 与静态/动态实体的交互距离是分开的

sendCustomModelsToBedrockClients​

  • 默认值：false
  • 控制 FreeMinecraftModels 是否尝试向基岩版客户端发送自定义模型
  • 如果禁用，基岩版玩家会回退到底层的原版实体（如果存在）
  • 如果启用，请确保您的 Bedrock/Geyser/Floodgate 资源包路径确实已为这些客户端准备就绪

操作说明​

  • /fmm reload 会重新导入内容并重新生成输出资源包，因此影响渲染行为的配置更改在重新加载后最容易验证
  • FreeMinecraftModels 只负责生成资源包；不会自行托管
  • ResourcePackManager 仍然是 Java 客户端推荐的分发方式，也是混合设置中最安全的文档化方式

何时更改这些值​

使用此配置进行运行时行为调优，而非内容包管理。

  • 使用 /fmm initialize、/fmm setup、/fmm downloadall 和 /fmm updatecontent 进行官方包生命周期管理
  • 使用 imports 文件夹进行手动 .bbmodel 或其他本地内容导入工作
  • 当您需要调整渲染模式、可视距离、交互距离或基岩版行为时使用 config.yml

已知注意事项​

  • 本地仓库在 plugin.yml 和 pom.xml 之间存在版本元数据差异，因此本页有意记录行为而非固定公开版本字符串
  • 基岩版行为取决于此配置和您更广泛的 Floodgate/Geyser/资源包设置，因此除非您已测试了确切的技术栈，否则请保守描述