Введение: самая загадочная ошибка

Игрок пытается зайти на сервер и видит сообщение «Internal Server Error» или «Internal Exception: java.lang.NullPointerException». Это джокер среди ошибок — он означает, что на сервере произошло необработанное исключение во время обработки входа игрока. Причина может быть в чём угодно: от повреждённых данных игрока до бага в плагине. В этом гайде я покажу, как читать логи и находить конкретную причину.

Шаг 1: Открыть логи сервера

Ошибка «Internal Server Error» на клиенте не содержит подробностей. Вся информация — в логах сервера. Откройте файл logs/latest.log и найдите момент, когда игрок пытался подключиться. Вы увидите полный стектрейс ошибки.

Тип 1: NullPointerException при загрузке данных игрока

Стектрейс

java.lang.NullPointerException at net.minecraft.server.PlayerList.onPlayerLogin

Причина

Данные игрока повреждены (см. гайд «Invalid player data»). Сервер пытается загрузить инвентарь или позицию игрока, но файл повреждён, и сервер падает с NPE.

Решение

1. Остановите сервер.
2. Перейдите в world/playerdata.
3. Найдите UUID проблемного игрока.
4. Удалите .dat файл.
5. Запустите сервер — игрок зайдёт с чистым инвентарём.

Тип 2: Ошибка в плагине при входе игрока

Стектрейс

java.lang.NullPointerException at com.someplugin.Listener.onPlayerJoin

Причина

Плагин пытается что-то сделать с игроком при входе (выдать предмет, проверить права, загрузить данные), но в его коде ошибка.

Решение

1. Найдите в стектрейсе название плагина (имя пакета, например, com.essentials).
2. Обновите плагин до последней версии.
3. Если обновлений нет — временно удалите папку плагина из plugins.
4. Перезапустите сервер и проверьте, заходит ли игрок.
5. Сообщите разработчику плагина об ошибке, приложив стектрейс.

Тип 3: Ошибка в мире — битый чанк на точке спавна

Стектрейс

java.lang.IllegalArgumentException: n must be positive at net.minecraft.world.level.ChunkAccess.getBlockState

Причина

Чанк на точке спавна повреждён. Сервер пытается поставить игрока в этот чанк и падает.

Решение

1. Смените точку спавна: /setworldspawn X Y Z (в консоли, пока сервер работает).
2. Или удалите проблемный region-файл (см. гайд «Invalid player data»).

Тип 4: Конфликт модов

Стектрейс

java.lang.NoSuchMethodError at some.mod.ClassName

Причина

Два мода требуют разные версии одной библиотеки. При входе игрока вызывается метод, который отсутствует в загруженной версии библиотеки.

Решение

1. Обновите все моды до последних версий, совместимых с вашей версией Forge/Fabric.
2. Проверьте, что все библиотеки-зависимости установлены в папку mods.
3. Используйте утилиту для проверки конфликтов модов (например, ModCheck).

💡 Совет профи

Настройте плагин ConsoleSpamFix с фильтром ошибок. Он будет скрывать повторяющиеся ошибки в консоли, но записывать их в отдельный лог-файл. Это спасёт вашу консоль от засорения тысячью одинаковых стектрейсов, но сохранит информацию для диагностики. А для быстрого поиска проблемы используйте команду /paste (через плагин ServerDump) — она выгружает все логи и конфиги на веб-сервис и даёт ссылку, которую можно отправить разработчику плагина.