Руководство

Как исправить ошибки плагинов Minecraft

Обновлено: 18 октября 2026 г.

Когда плагин не загружается, сервер почти всегда сообщает почему: причина есть в консоли при запуске, на несколько строк выше или ниже названия плагина. Научитесь читать эту часть журнала, и большинство ошибок будет исправляться за минуту. Вот самые частые из них и что они означают.

Укажите версию сервера и что должен делать плагин.

Сгенерировать это в Codexe

Шаг за шагом

1.Откройте журнал запуска
Прочитайте консоль или logs/latest.log в папке сервера. На панели хостинга используйте её консоль или файловый менеджер.
2.Найдите название плагина
Найдите первую ошибку, в которой он упоминается. Важны строки, которые начинаются с [ERROR] или [WARN], и трассировка стека под ними.
3.Прочитайте первую строку и строки «Caused by»
Первая строка говорит, что сломалось; последняя строка Caused by: обычно говорит почему. Строки с названием пакета самого плагина показывают, где в его коде.
4.Сравните со списком ниже
Большинство ошибок при запуске связано с версией, Java или зависимостью, и сообщение говорит, с чем именно.
5.Исправьте одно и перезапустите
Измените одну вещь, перезапустите сервер (не /reload) и снова прочитайте журнал. Ошибки одного плагина могут вызывать ошибки в других.

Частые ошибки

Что вы видите	Что это значит	Как исправить
`Unsupported API version 1.21`	`api-version` плагина новее вашего сервера.	Возьмите версию для своего сервера или обновите сервер.
`Could not load 'plugins/X.jar'` с `Invalid plugin.yml` или `Jar does not contain plugin.yml`	Дескриптор плагина отсутствует или содержит ошибку YAML, либо файл вообще не плагин.	Проверьте, что вы скачали сам плагин, а не его исходный код, мод или архив. Если вы собирали его сами, исправьте `plugin.yml`.
`UnsupportedClassVersionError`, «class file version 65.0»	Плагину нужна более новая Java, чем та, на которой работает сервер (61 = Java 17, 65 = Java 21, 69 = Java 25).	Запустите сервер на этой Java или пересоберите плагин под свою Java.
`NoClassDefFoundError` или `ClassNotFoundException`	Нужного плагину класса нет: отсутствует плагин-зависимость, библиотека не встроена в .jar или такого API нет в этой версии.	Установите плагин, названный в ошибке (Vault, ProtocolLib), или используйте сборку для своей версии.
`Unknown/missing dependency plugins`	Плагин, указанный в `depend`, не установлен.	Установите его в `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Плагин загрузился, но упал в `onEnable`.	Прочитайте строку `Caused by`: часто это ошибка в конфиге или отсутствующая зависимость.
`Ambiguous plugin name`	В `plugins/` лежат два файла .jar одного и того же плагина.	Удалите старый.

Ошибки, не связанные с загрузкой

Плагин зелёный, но команда выдаёт «Unknown command»: команды нет в plugin.yml, или другой плагин использует то же название.
«I'm sorry, but you do not have permission»: у игрока нет нужного права. Найдите право на странице плагина и выдайте его через свой плагин прав.
Ошибки после правки config.yml: YAML требует пробелов, а не табуляции, и кавычек вокруг текста, который начинается с : или &.
Работает после перезапуска, ломается после /reload: плагин не поддерживает /reload. Перезапускайте сервер.

Какая Java нужна вашему серверу

Minecraft 1.20.5 и новее нужна Java 21, а 26.x нужна Java 25; версиям с 1.18 по 1.20.4 нужна Java 17. Выполните java -version той же Java, что использует сервер (на панели хостинга это обычно настройка Docker image или Java version). Плагин, собранный под более старую Java, работает на более новой, но не наоборот.

Исправление плагинов, сделанных в Codexe

Плагины, сделанные в Codexe, компилируются под выбранную вами версию и проверяются на корректный plugin.yml до статуса «Готово». На тестовом сервере вкладка «Журнал» показывает журнал в реальном времени с подсвеченными ошибками, а «Экспортировать журнал» сохраняет его в файл. Опишите, что вы видите, в чате проекта («плагин красный в /plugins, а в журнале написано ...»), и Codexe изменит код и соберёт проект заново. Если «Скомпилировать» не проходит на файлах ровно в том виде, в каком их выдал Codexe, «Исправить с помощью AI» исправит их бесплатно.

Вопросы

Где находится журнал сервера?

logs/latest.log в папке сервера для текущего запуска. Предыдущие запуски лежат в той же папке в виде файлов .log.gz.

Может ли один плагин сломать другой?

Да: отсутствующая или сломанная зависимость останавливает все плагины, которым она нужна. Исправляйте первую ошибку в журнале раньше остальных.

Безопасно ли делиться своим журналом?

В основном да, но сначала проверьте его: в журналах могут быть IP-адреса, а с некоторыми плагинами и пароли от баз данных из ошибок.

Пересоберите сломанный плагин для своего сервера

Этот промпт откроется уже готовым к отправке:

“Плагин для Paper 1.21.4 под названием SimpleWarps на замену моему старому, который больше не загружается: /setwarp, /warp и /delwarp с названием, /warps показывает их в GUI, право warps.admin для создания и удаления, варпы сохраняются между перезапусками, сообщения в config.yml.”