Посібник

Як виправити помилки плагінів 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, Виправити за допомогою ШІ безкоштовно їх відремонтує.

Запитання

Де журнал сервера?

logs/latest.log у теці сервера, для поточного запуску. Журнали попередніх запусків лежать у тій самій теці як файли .log.gz.

Чи може один плагін зламати інший?

Так: відсутня або зламана залежність зупиняє кожен плагін, якому вона потрібна. Виправте першу помилку в журналі, перш ніж братися за інші.

Чи безпечно ділитися своїм журналом?

Здебільшого так, але спершу перегляньте його: журнали можуть містити IP-адреси, а з деякими плагінами - паролі до бази даних із повідомлень про помилки.

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

Цей запит відкривається готовим до надсилання:

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