Введение: плагины — магия сервера

«Скачал плагин, закинул в папку, а он не работает. Что я сделал не так?» Установка плагина кажется элементарной задачей, но новички совершают одни и те же ошибки: не то ядро, не та версия, забыли зависимости. В этом гайде я разберу установку плагина от А до Я.

Шаг 1: Убедитесь, что у вас правильное ядро

Плагины работают ТОЛЬКО на серверах с поддержкой Bukkit API. Это Paper, Spigot, Purpur, CraftBukkit. Ванильный сервер (скачанный с minecraft.net) НЕ поддерживает плагины.

Как проверить: Если в папке сервера есть файл server.jar и при запуске в консоли написано «Paper» или «Spigot» — плагины поддерживаются. Если «Vanilla» — нет.

Решение: Скачайте Paper с papermc.io, замените им ваш server.jar и запустите сервер заново.

Шаг 2: Скачайте плагин правильной версии

Каждый плагин имеет версию, совместимую с определённой версией Minecraft. Плагин для 1.20 НЕ будет работать на 1.21.

Где скачивать:

• SpigotMC.org — основной каталог плагинов.
• Modrinth.com — современная альтернатива.
• GitHub разработчика — для самых свежих версий.

Как выбрать версию: На странице плагина есть вкладка «Updates» или «Versions». Выберите версию, соответствующую вашей версии Minecraft. Если плагин для 1.21 не вышел — проверьте, работает ли версия для 1.20.5 (часто работает).

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

Многие плагины требуют другие плагины для работы. Например, плагины экономики требуют Vault. Плагины для голосового чата требуют ProtocolLib.

Как узнать зависимости: На странице плагина в разделе «Dependencies» или «Requirements» перечислены обязательные плагины. Скачайте и установите их ТОЖЕ.

Шаг 4: Поместите JAR-файл в папку plugins

1. Остановите сервер командой stop в консоли. Никогда не загружайте плагины на работающий сервер — это может вызвать краш.
2. Скопируйте скачанный .jar файл в папку plugins внутри папки сервера.
3. Запустите сервер.
4. В консоли вы увидите строки загрузки плагина: «[PluginName] Enabling PluginName v1.0». Если ошибок нет — плагин работает.

Шаг 5: Проверьте, что плагин загрузился

/pl

Эта команда показывает список всех загруженных плагинов. Если ваш плагин в списке — всё отлично. Если нет — проверьте консоль на наличие ошибок.

Типичные ошибки

• Плагин не появляется в /pl. Проверьте, что файл плагина — это JAR, а не ZIP или RAR. Проверьте версию плагина и версию сервера.
• В консоли ошибка «Plugin requires Vault». Установите плагин Vault.
• Плагин загрузился, но команды не работают. Проверьте права в LuckPerms. Плагин загружен, но у группы default нет прав на его команды.
• Сервер вылетает после установки плагина. Удалите JAR-файл плагина из папки plugins и запустите сервер снова. Плагин несовместим с вашей версией сервера или конфликтует с другим плагином.

💡 Совет профи

Устанавливайте плагины по одному и проверяйте сервер после каждого. Если вы закинете сразу 10 плагинов и сервер упадёт — вы не узнаете, какой из них вызвал краш. Правило: один плагин → перезапуск → проверка → следующий плагин.