Введение: биомы-убийцы

Ошибка «Invalid biome data» или «java.lang.IllegalArgumentException: Invalid biome id» — это краш сервера, который происходит при заходе игрока в определённый биом. Причина — повреждённые данные биома в чанке или несовместимость модов, добавляющих биомы. В этом гайде — как диагностировать и исправить проблему с биомами.

Причина 1: Мод добавляет биомы, которые не зарегистрированы

Мод на биомы был удалён с сервера, но чанки, сгенерированные с этим модом, остались. Сервер пытается загрузить чанк, но не может найти биом с нужным ID — краш.

Решение:

• Верните мод на сервер.
• Или удалите проблемные чанки (region-файлы), чтобы они перегенерировались без мода.
• Или используйте инструмент для очистки мира от биомов удалённого мода (BiomeRemover).

Причина 2: Конфликт нескольких модов на биомы

Два мода пытаются зарегистрировать биом с одинаковым ID или изменить один и тот же биом. Результат — повреждённые данные биома.

Решение:

• Удалите один из конфликтующих модов.
• Или измените ID биомов в конфигах одного из модов (если позволяет).

Причина 3: Повреждённый region-файл

Файл чанка повреждён, и данные биома читаются как мусор (invalid biome id).

Решение:

• Удалите проблемный region-файл. Чанк перегенерируется.
• Или используйте Region Fixer для восстановления.

💡 Совет профи

Перед удалением мода на биомы всегда делайте полный бэкап мира. После удаления мода запустите сервер, зайдите в мир и проверьте проблемные чанки. Если мир загрузился — выполните команду /paper fixbiomes (если доступна в вашей версии Paper) для исправления несоответствий биомов в существующих чанках.