Ръководство

Как да поправиш грешки в Minecraft плъгини

Обновено на 18 октомври 2026 г.

Когато плъгин не се зарежда, сървърът почти винаги казва защо: причината е в конзолата по време на стартиране, няколко реда над или под името на плъгина. Научи се да четеш тази част от лога и повечето грешки се поправят за минута. Ето най-честите и какво означават.

Кажи версията на сървъра си и какво трябва да прави плъгинът.

Генерирай това с Codexe

Стъпка по стъпка

1.Отвори лога на стартирането
Прочети конзолата или logs/latest.log в папката на сървъра. В хостинг панел използвай неговата конзола или файловия мениджър.
2.Потърси името на плъгина
Намери първата грешка, която го споменава. Важни са редовете, които започват с [ERROR] или [WARN], и stack trace под тях.
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, или файлът не е плъгин.	Провери дали си изтеглил плъгина, а не кода му, мод или zip. Ако ти си го компилирал, поправи `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“: на играча му липсва permission node. Провери node-а на страницата на плъгина и го дай с плъгина си за permissions.
Грешки след редактиране на 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, преди да са „Готов“. На тестов сървър разделът Logs показва лога на живо с маркирани грешки, а Export logs го запазва като файл. Опиши какво виждаш в чата на проекта („плъгинът е червен в /plugins и логът казва ...“) и Codexe променя кода и компилира отново. Ако „Компилирай“ се провали върху файловете точно както Codexe ги е доставил, Fix with AI ги поправя безплатно.

Въпроси

Къде е логът на сървъра?

logs/latest.log в папката на сървъра, за текущото пускане. По-старите пускания са в същата папка като файлове .log.gz.

Може ли един плъгин да счупи друг?

Да: липсваща или счупена зависимост спира всеки плъгин, който има нужда от нея. Поправи първата грешка в лога преди другите.

Безопасно ли е да споделя лога си?

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

Компилирай отново счупен плъгин за своя сървър

Този промпт се отваря готов за изпращане:

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