Совместимость плагинов и версий API
Почему плагин не работает на вашей версии, что означает api-version, как читать требования и чем грозит несовпадение.
Обновлено 13 августа 2026 г.
Плагин собирается под определённую версию серверного API. Несовпадение даёт либо отказ загрузки, либо ошибки в работе.
Что определяет совместимость
- Версия игры. Плагин под 1.20 на 1.21 чаще всего не заработает: меняются внутренние классы.
- Ядро. Bukkit/Spigot/Paper — совместимы «снизу вверх»: плагин Bukkit пойдёт на Paper, обратное неверно, если использованы Paper-специфичные API.
- Зависимости. Vault, PlaceholderAPI, ProtocolLib — их версии тоже должны подходить.
api-version
В plugin.yml плагина указано:
api-version: 1.21
Если строки нет вовсе, сервер считает плагин легаси и включает режим совместимости — в логе появится предупреждение. Это не ошибка, но признак старого плагина.
Типичные симптомы
| В логе | Значение |
|---|---|
Unsupported API version | Плагин собран под более новое ядро |
NoSuchMethodError | Метод исчез в вашей версии — разбор |
NoClassDefFoundError | Нет зависимости — разбор |
Invalid plugin.yml | Файл повреждён или это не плагин — разбор |
Проверка до установки
Каталог «Плагины и моды» в панели фильтрует по вашему ядру и версии и предупреждает о несовместимости до установки — Как поставить. При ручной загрузке смотрите страницу плагина: там всегда указан диапазон поддерживаемых версий.