Сумісність версій плагінів та 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 | Файл пошкоджено або це не плагін — розбір |
Перевірка перед встановленням
Каталог «Плагіни та моди» в панелі фільтрує за вашим ядром і версією та попереджає про несумісність ще до встановлення — Як встановити. Під час ручного завантаження перевіряйте сторінку плагіна: там завжди вказано діапазон підтримуваних версій.
Хостинг MinecraftВаш сервер працює, навіть коли ви офлайнСтворити сервер
