Введение: декоратор сошёл с ума

Ошибка «IllegalStateException: Already decorating» или «Decoration step already running» — это краш сервера, который происходит при генерации мира, когда два чанка пытаются одновременно «декорироваться» (размещать деревья, траву, руду) в одной области. Это баг в движке генерации, который чаще всего проявляется при использовании модов, добавляющих новые биомы и структуры. В этом гайде — как обойти этот баг.

Причина

Генерация мира в Minecraft состоит из этапов: генерация ландшафта → генерация структур → декорирование (деревья, трава, цветы, руда). Два соседних чанка могут попытаться декорировать один и тот же блок на границе чанков. Ванильный код имеет защиту от этого, но моды могут её обходить или ломать.

Решение 1: Обновить моды и ядро

Это баг, который часто фиксят в обновлениях. Убедитесь, что у вас последняя версия Forge/Fabric и всех модов. Особенно модов, связанных с генерацией мира (Biomes O' Plenty, TerraBlender, Terralith).

Решение 2: Уменьшить количество потоков генерации

В paper.yml (для Paper) или в конфигах модов уменьшите количество одновременных задач генерации:

chunk-system:
  worker-threads: 2

Меньше потоков = меньше шанс, что два чанка столкнутся при декорировании.

Решение 3: Предзагрузка мира (Chunky)

Та же рекомендация, что и в гайде «Out of Memory при генерации»: предзагрузите мир. Генерация одним потоком через Chunky не вызывает этой ошибки, так как чанки генерируются последовательно.

💡 Совет профи

Если ошибка происходит регулярно в одном и том же месте — удалите проблемный region-файл и дайте миру перегенерироваться заново. Иногда повреждённый чанк застревает в состоянии «недодекорирован» и вызывает ошибку при каждом обращении. Удаление region-файла решает проблему радикально.