Перейти к основному содержимому

Конфигурация FreeMinecraftModels

На этой странице описаны текущие настройки config.yml, которые заметно влияют на setup, рендеринг и взаимодействие игроков.

Расположение файла​

plugins/FreeMinecraftModels/config.yml

Подтвержденные на данный момент настройки​

setupDone​

  • Значение по умолчанию: false
  • Определяет, считается ли первичная настройка завершенной
  • Игроки с широкими разрешениями FreeMinecraftModels получают напоминание выполнить /fmm initialize, пока это значение остается false
  • Процесс setup меняет это значение автоматически, поэтому при обычном онбординге вручную редактировать его не нужно

useDisplayEntitiesWhenPossible​

  • Значение по умолчанию: true
  • Указывает FreeMinecraftModels по возможности предпочитать рендеринг через display entity, если это поддерживается сервером и клиентом
  • Если display entity недоступны, плагин все равно использует fallback
  • Клиенты Bedrock являются особым случаем, поэтому не стоит считать, что эта опция заставляет всех игроков использовать один и тот же путь рендеринга

maxModelViewDistance​

  • Значение по умолчанию: 60
  • Ограничивает расстояние, на котором моделированные сущности отправляются наблюдателям
  • Более низкие значения уменьшают сетевую и клиентскую нагрузку в плотных областях с большим количеством моделей

maxInteractionAndAttackDistance​

  • Значение по умолчанию: 3
  • Применяется к статическим и динамическим моделированным сущностям
  • Используется проверками взаимодействия и попаданий во время работы

maxInteractionAndAttackDistanceForProps​

  • Значение по умолчанию: 6
  • Применяется к prop-сущностям
  • Эта настройка отделена от дистанции взаимодействия для статических и динамических сущностей

sendCustomModelsToBedrockClients​

  • Значение по умолчанию: false
  • Управляет тем, пытается ли FreeMinecraftModels отправлять пользовательские модели клиентам Bedrock
  • Если опция отключена, игроки Bedrock возвращаются к базовой vanilla-сущности, если она существует
  • Если ты включаешь ее, убедись, что твой путь resource pack для Bedrock/Geyser/Floodgate действительно готов для этих клиентов

Рабочие замечания​

  • /fmm reload повторно импортирует контент и заново генерирует выходной пак, поэтому изменения конфигурации, влияющие на рендеринг, удобнее всего проверять после reload
  • FreeMinecraftModels только генерирует resource pack; сам по себе он его не хостит
  • ResourcePackManager по-прежнему является рекомендуемым путем доставки для Java-клиентов и самым безопасно задокументированным путем для смешанных установок

Когда менять эти значения​

Используй этот конфиг для настройки поведения во время работы, а не для управления content pack.

  • Используй /fmm initialize, /fmm setup, /fmm downloadall и /fmm updatecontent для жизненного цикла официальных паков
  • Используй папку imports для ручного импорта .bbmodel или другого локального контента
  • Используй config.yml, когда нужно настроить режим рендеринга, дистанцию видимости, дистанцию взаимодействия или поведение Bedrock

Известные оговорки​

  • В локальном репозитории есть расхождение метаданных версии между plugin.yml и pom.xml, поэтому эта страница намеренно документирует поведение, а не фиксирует конкретную публичную версию
  • Поведение Bedrock зависит как от этого конфига, так и от всей твоей цепочки Floodgate/Geyser/resource pack, поэтому формулировки должны оставаться консервативными, пока ты не протестировал именно свой стек