BoostedTrees — Конфигурация

BoostedTrees — Конфигурация

Параметры конфигурации

• enabled — по умолчанию true. Включает генерацию лесов и запуск ручных задач. Отключение ставит активные ручные задачи на паузу; повторное включение не возобновляет их автоматически.
  
• worlds — по умолчанию []. Список разрешённых имён миров; пустой означает все обычные миры. Пробелы по краям удаляются, имена приводятся к нижнему регистру. Нижний мир и Край исключены из генерации лесов.
  
• custom_trees_percent — по умолчанию 80, диапазон 0–100. Целевая доля уникальных деревьев среди итоговых деревьев в сканируемой области.
  
• large_trees_percent — по умолчанию 10, диапазон 0–100. Целевая частота больших деревьев среди уникальных при наличии подходящего ландшафта и исходных деревьев.
  
• performance_level — по умолчанию 3, диапазон 1–5. Большие значения допускают больше сканирования и планирования и ускоряют ручное преобразование, увеличивая объём обработки.
  
• disabled_trees — по умолчанию []. Канонические идентификаторы, исключённые из автоматической генерации и ручного преобразования. Явные команды создания пробных деревьев остаются доступны.
  
• tree_rarity — соответствие идентификаторов деревьев ключам редкости. Автоматическая генерация и ручное преобразование лесов проверяют редкость до планирования. Явные команды создания пробных деревьев обходят этот фильтр выбора.
  

Изменения в меню сохраняются и применяются сразу. Ручные изменения файла требуют /boostedtrees reload. Некорректный YAML, неверные типы или неизвестные значения редкости отклоняются с сохранением файла; при неудачной перезагрузке остаются прежние рабочие настройки. Числа ограничиваются допустимыми диапазонами. Конфигурация нормализуется при сохранении, поэтому неподдерживаемые ключи не являются поддерживаемым способом настройки.

Уровни редкости
Ниже приведены вероятности допуска для подходящего исходного дерева. Это не итоговые проценты в мире; проверки биома, размера и размещения продолжают действовать. Для неуказанных видов используются встроенные значения: ancient_cypress и giant_sequoia — rare; elder_weeping_oak, titan_weeping_birch и savanna_colossus — ultra_rare; остальные — popular.

• popular – 100%
  
• common – 65%
  
• uncommon – 35%
  
• scarce – 20%
  
• rare – 10%
  
• very_rare – 1%
  
• ultra_rare – 0.1%
  

Конфигурация по умолчанию
Текущий код записывает нормализованную конфигурацию ниже. Старый включённый ресурс всё ещё использует rare_trees; этот устаревший список принимается и преобразуется в tree_rarity. Для новых изменений используйте текущую карту. Ключи конфигурации, идентификаторы деревьев и значения редкости остаются на английском.


Пример: один выбранный мир
Этот полный пример ограничивает новые леса миром world, задаёт 60% уникальных и 5% больших деревьев, отключает Giant Oak и устанавливает для Highland Pine значение common. Замените имя мира своим фактическим именем, затем выполните /boostedtrees reload.


Проценты — это целевые значения для подходящих исходных деревьев, а не гарантированные пропорции всего мира. Группа, заменённая одним уникальным деревом, считается одним итоговым деревом. Биомы, редкость, место и ограничения обработки могут уменьшить итоговую долю. custom_trees_percent: 0 отключает автоматическую замену; существующие деревья не удаляются.

Ручные задачи фиксируют настройки обнаружения и пропорций при запуске; уровень производительности и текущие проверки видов/редкости меняются в реальном времени. Изменение настроек не перестраивает уже созданные деревья. Запустите новую задачу для применения изменённых фиксируемых настроек задачи. Список разрешённых миров проверяется при запуске.