Водич

Како поправити грешке у 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`	Класа која плагину треба не постоји: недостаје плагин од кога зависи, библиотека није shade-ована у .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 на страници плагина и додели га својим плагином за дозволе.
Грешке после измене 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 за постављање и брисање, warp-ови се чувају кроз рестартовања, поруке у config.yml.”