Плагин несовместим с версией сервера (NoSuchMethodError/NoClassDefFoundError по API/NMS)
- Платформы
- Paper · Purpur · один сервер
- Проверено
- Проверено
- Уверенность
- Уверенность 90%
Как это выглядит в логе
Достаточно одной из строк. Агент сверяет их с логом локально, на вашем сервере.
logs/latest.log
[WARN] java.lang.NoSuchMethodError: 'в stack trace[WARN] java.lang.NoSuchFieldError: Class в stack trace[WARN] java.lang.NoClassDefFoundError: в stack trace[WARN] java.lang.ClassNotFoundException: в stack trace
Симптомы
- Плагин не включается или его функции падают с ошибками после обновления сервера
- В trace: NoSuchMethodError/NoSuchFieldError/NoClassDefFoundError/ClassNotFoundException для классов net.minecraft или org.bukkit
Причина
Плагин обращается к методу, полю или классу сервера (Bukkit API, CraftBukkit или NMS), которого нет в этой версии: плагин собран под другую версию Minecraft/Paper.
Вероятные причины
- Версия плагина не поддерживает текущую версию Minecraft (обычно после обновления сервера)
- Плагин использует версионированный пакет org.bukkit.craftbukkit.vX_Y_RZ, которого нет в Paper 1.20.5+ (без relocation)
- Устаревший Bukkit API удалён/изменён в новой версии Paper
Как исправитьСредний риск
- По фреймам trace определите плагин (первый фрейм с его jar/пакетом после строки исключения).
- Обновите плагин до версии, в описании которой указана поддержка вашей версии Minecraft (Hangar/Modrinth/SpigotMC, раздел Versions/Changelog).
- Если совместимой версии нет — временно откатите сервер на поддерживаемую плагином версию (с резервной копией мира) или замените плагин аналогом.
- Не используйте
/reloadпосле замены jar — перезапустите сервер.