Введение: плагин есть — функционала нет

«Установил плагин, он в /pl отображается, но ничего не работает. Команды не выполняются, функции не появляются. Что я сделал не так?» Это классическая ситуация. Плагин загружен, но не работает — и новичок не знает, куда смотреть. В этом гайде я дам пошаговый алгоритм диагностики: 7 шагов, которые найдут проблему в 95% случаев.

Шаг 1: Проверьте, что плагин действительно загружен

/pl

Если плагин в списке — он загружен. Если нет:

• Проверьте консоль при запуске сервера — там будут ошибки загрузки плагина.
• Проверьте, что файл плагина имеет расширение .jar (а не .zip, .rar).
• Проверьте версию плагина — она должна соответствовать версии сервера.

Шаг 2: Проверьте консоль на ошибки

Откройте консоль сервера и выполните команду плагина. Если в консоли появляется красное сообщение об ошибке — скопируйте его. Ошибка обычно содержит:

• Название плагина: какой плагин вызвал ошибку.
• Тип ошибки: NullPointerException, NoSuchMethodError, ClassNotFoundException.
• Стектрейс: список классов и методов, которые привели к ошибке.

Шаг 3: Проверьте зависимости

Многие плагины требуют другие плагины. Например, плагины экономики требуют Vault. Без Vault они загружаются, но команды не работают.

Как проверить: откройте страницу плагина на SpigotMC, найдите раздел «Dependencies» или «Required Plugins». Установите все перечисленные плагины.

Шаг 4: Проверьте права (Permissions)

Даже если плагин загружен, его команды могут быть недоступны игроку без прав. Проверьте:

1. Откройте страницу плагина на SpigotMC → раздел «Permissions».
2. Найдите право на нужную команду (например, myplugin.use).
3. Выдайте это право группе игрока: /lp group default permission set myplugin.use true.
4. Проверьте права игрока: /lp user Игрок info.

Шаг 5: Проверьте конфигурацию плагина

Некоторые плагины по умолчанию ВЫКЛЮЧЕНЫ в конфиге. Откройте папку plugins/НазваниеПлагина/config.yml и проверьте:

• Нет ли параметра enabled: false.
• Нет ли параметров, требующих настройки (например, пустой токен бота).
• Правильно ли указаны ID миров, названия предметов, права.

Шаг 6: Проверьте совместимость с другими плагинами

Два плагина могут конфликтовать. Например, два плагина на защиту территории (WorldGuard и GriefPrevention) могут мешать друг другу.

Как проверить: временно удалите ВСЕ плагины, кроме проблемного и его зависимостей. Если плагин заработал — добавляйте остальные плагины по одному, пока не найдёте конфликтующий.

Шаг 7: Проверьте версию Java

Некоторые новые плагины требуют Java 17 или 21. Если сервер работает на Java 8 — плагин не загрузится или будет работать с ошибками.

java -version

Если версия ниже требуемой — обновите Java (см. статью «Сервер не запускается»).

💡 Совет профи

Читайте логи сервера. Файл logs/latest.log содержит ВСЕ сообщения, включая ошибки плагинов, которые могли мелькнуть в консоли и исчезнуть. Откройте его Блокнотом и поищите название вашего плагина (Ctrl+F). Рядом с названием будут сообщения об ошибках — это лучшая подсказка для диагностики.