Плагіни на серверах Minecraft; Він керує системою авторизації, економікою, захистом, ринком, подіями, претензіями, античіт-системами та багатьма спеціальними системами. Якщо один із плагінів не встановлено, значна частина сервера може не працювати.

Помилки плагінів зазвичай виникають у консолі або logs/latest.log з’являється у файлі. Найпоширеніші помилки; Не вдалося завантажити плагін, Непідтримувана версія API, невідома залежність, Недійсний plugin.yml і несумісність версій Java.

1. Де можна побачити помилку плагіна?

Якщо плагін не завантажується, в першу чергу слід переглянути консоль сервера та файл latest.log.

tail -n 200 logs/latest.log

Для відстеження в реальному часі:

tail -f logs/latest.log

Для пошуку за назвою плагіна:

grep -i "pluginadi" logs/latest.log

2. Помилка непідтримуваної версії API

Ця помилка вказує на те, що версія API Minecraft, яку підтримує плагін, несумісна з версією сервера.

Unsupported API version 1.20

Наприклад, плагін може бути підготовлений для 1.20, але на вашому сервері може працювати версія 1.16.5. У цьому випадку плагін може не завантажуватися або працювати некоректно.

рішення:

• Перевірте версію Minecraft, яку підтримує плагін.
• Завантажте версію плагіна, сумісну з версією вашого сервера.
• Не очікуйте, що нові плагіни працюватимуть на дуже старих серверах.
• При необхідності знайдіть відповідну версію в архіві старої версії плагіна.

3. Невідома помилка залежності

Деякі плагіни не працюють окремо. Він просить спочатку встановити інший плагін. Це називається залежністю.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Наприклад, часто економні плагіни Сховище хоче. Для плагінів авторизації або ринку також можуть знадобитися інші плагіни бібліотеки.

рішення:

• Прочитайте вимоги на сторінці плагіна.
• Завантажте відсутній плагін залежностей.
• Переконайтеся, що плагін залежностей також сумісний із версією вашого сервера.
• Повністю перезапустіть сервер.

4. Помилка недійсного plugin.yml

Всередині jar-файлу плагіна plugin.yml Якщо файл пошкоджений, відсутній або неправильний, плагін неможливо встановити.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Зазвичай це відбувається, коли:

• Було завантажено не той файл.
• Замість плагіна, zip-файл вихідного коду було розміщено в папці плагінів.
• Файл jar пошкоджено.
• Плагін був неправильно запакований розробником.

Як рішення, плагін правильний. .jar Файл слід завантажити. Файл source-code.zip, завантажений з GitHub, не слід розміщувати безпосередньо в папці плагінів.

5. Несумісність версії Java

Для версії Minecraft і плагінів потрібні певні версії Java. Якщо використовується неправильна версія Java, плагін або сервер можуть взагалі не відкритися.

java -version

Поширена помилка:

UnsupportedClassVersionError

Ця помилка вказує на те, що плагін було скомпільовано з новою Java, але на сервері використовується старіша Java.

Загальна логіка:

• Для старих версій Minecraft часто потрібна застаріла версія Java.
• Для нових версій Minecraft потрібна новіша версія Java.
• Слід перевірити вимогу Java в описі плагіна.
• Обрана версія Java в панелі хостингу повинна бути перевірена.

6. Чи файл плагіна знаходиться у правильній папці?

Файли плагінів на серверах Bukkit, Spigot і Paper плагіни кидається в папку.

ls plugins/

Файл плагіна має бути таким:

plugins/PluginAdi.jar

Плагіни, залишені в zip, rar, вихідному коді або папках, часто не працюють.

7. Конфлікти плагінів

Два плагіни, які виконують однакову роботу, можуть конфліктувати один з одним. Наприклад, два різних плагіни чату, два різні плагіни економії або дві різні системи претензій можуть намагатися керувати тими самими подіями.

Симптоми конфлікту:

• Плагін встановлено, але його команди не працюють.
• Один плагін переважає налаштування іншого.
• У консолі виникає конфлікт подій або виняток.
• Гравці не можуть використовувати команди, навіть якщо у них є дозвіл.
• Сервер поводиться інакше після перезавантаження.

Щоб знайти рішення, плагіни можна протестувати, вимикаючи їх один за іншим. Однак перед тим, як робити це на живому сервері, слід зробити резервну копію та віддати перевагу невеликій кількості годин гравців.

8. Помилка конфігурації може перешкодити відкриттю плагіна

Деякі плагіни не відкриваються, якщо у файлі конфігурації є помилка YAML. Пробільні відступи особливо важливі у файлах YAML.

Типові помилки:

• Використання символу табуляції
• Не залишайте пробіл після двокрапки
• Написання тексту, що потребує лапок, без лапок
• Пошкодження файлу через турецькі символи або спеціальні символи
• Збереження відсутнього файлу конфігурації

Якщо є неправильний файл конфігурації, папку плагіна можна тимчасово перейменувати, щоб створити резервну копію папки плагіна та повторно створити конфігурацію.

Поширені помилки

• Встановлення плагінів, які не сумісні з версією сервера
• Не встановлюються відсутні плагіни залежностей
• Помилково сприймаючи вихідний zip-файл GitHub як плагін
• Не перевіряється версія Java
• Спроба встановити плагін за допомогою /reload
• Використання вкладок у конфігураційних файлах YAML

FAQ

Плагін є в папці plugins, але він не працює, чому?
Це може бути несумісність версії, відсутність залежності, несумісність Java або помилка конфігурації. Необхідно перевірити файл latest.log.

Що означає UnsupportedClassVersionError?
Плагін щойно скомпільовано з Java. Версія Java, яка використовується на сервері, застаріла.

Чи безпечно використовувати /reload?
Це не рекомендується для багатьох плагінів. Повний перезапуск безпечніший для встановлення, видалення плагіна та основних змін конфігурації.

Рекомендації з техніки безпеки та експлуатації

• Завантажуйте плагіни з надійних джерел.
• Перш ніж додавати плагін на живий сервер, спробуйте його на тестовому сервері.
• Перед кожним оновленням плагіна створюйте резервну копію папки плагінів.
• Зменште поверхню атаки, видаливши непотрібні плагіни.
• Регулярно перевіряйте журнали плагінів.

Ця стаття спеціально підготовлена для PvPServer.