跳到主要内容

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 方案，所以在没有测试你自己的实际环境之前，应保持保守表述