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

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

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

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

plugins/FreeMinecraftModels/config.yml

Текущие проверенные настройки​

setupDone​

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

useDisplayEntitiesWhenPossible​

  • По умолчанию: true
  • Указывает FreeMinecraftModels предпочитать рендеринг через display-сущности, когда сервер и клиент это поддерживают
  • Плагин по-прежнему использует запасной вариант, когда display-сущности недоступны
  • Клиенты Bedrock — особый случай, поэтому не предполагайте, что эта настройка задаёт одинаковый путь рендеринга для каждого игрока

maxModelViewDistance​

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

maxInteractionAndAttackDistance​

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

maxInteractionAndAttackDistanceForProps​

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

sendCustomModelsToBedrockClients​

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

Эксплуатационные примечания​

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

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

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

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

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

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