Как установить плагины на Minecraft сервер: полный гайд

Плагины - это основа любого публичного Minecraft сервера. Без них у тебя будет чистый ванильный сервер, на котором нельзя ни права настроить, ни от гриферов защититься, ни экономику сделать. Если ты только поднял свой первый сервер на Spigot или Paper и не знаешь, с какой стороны подходить к плагинам - этот гайд для тебя.

Плагины vs моды: в чём разница

Новички часто путают плагины и моды, хотя это разные вещи.

Моды (Forge, Fabric, NeoForge) изменяют сам клиент и сервер. Они добавляют новые блоки, мобов, механики. Чтобы зайти на модифицированный сервер, игроку нужно установить те же моды на свой клиент.

Плагины (Bukkit, Spigot, Paper) работают только на стороне сервера. Они используют серверное API для добавления функционала: команды, права, телепорты, экономика. Игроку не нужно ничего устанавливать - он заходит с обычного клиента.

Формат плагинов - .jar файлы, которые кладутся в папку plugins/ на сервере. Всё.

Какой сервер нужен для плагинов

Ванильный server.jar от Mojang не поддерживает плагины. Тебе нужен один из серверных ядер с поддержкой Bukkit API:

• Paper - рекомендуемый выбор. Форк Spigot с кучей оптимизаций и патчей. Большинство плагинов пишутся и тестируются именно под Paper.
• Spigot - классика. Работает, но Paper быстрее и стабильнее.
• Purpur - форк Paper с дополнительными настройками. Для продвинутых.
• Folia - для многоядерных серверов. Не все плагины совместимы.

Если ты ещё не выбрал ядро - ставь Paper. Скачать можно с papermc.io.

Где скачивать плагины

Правило номер один: никогда не скачивай плагины с рандомных сайтов. Файлы .jar выполняют произвольный код на твоём сервере, и вредоносный плагин может удалить все файлы, украсть данные или дать злоумышленнику полный доступ.

Проверенные площадки:

• Modrinth - современная платформа, хорошая модерация, быстрый поиск
• Hangar - официальная площадка от PaperMC
• SpigotMC - самая большая база плагинов, но модерация слабее
• GitHub - многие разработчики публикуют релизы прямо на GitHub

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

Установка: пошаговый процесс

1. Скачай плагин

Скачай .jar файл нужного плагина. Например, EssentialsX:

wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsX-2.20.1.jar

2. Закинь в папку plugins

# Структура сервера
/home/minecraft/server/
├── server.jar
├── server.properties
├── plugins/           <-- сюда кладём .jar файлы
│   ├── EssentialsX-2.20.1.jar
│   └── LuckPerms-Bukkit-5.4.131.jar
├── world/
└── logs/

cp EssentialsX-2.20.1.jar /home/minecraft/server/plugins/

3. Перезапусти сервер

# Если сервер запущен в screen/tmux
screen -r minecraft
> stop

# Запусти заново
java -Xms2G -Xmx4G -jar server.jar nogui

При запуске ты увидишь что-то вроде:

[15:23:41 INFO]: [EssentialsX] Loading EssentialsX v2.20.1
[15:23:41 INFO]: [EssentialsX] Enabling EssentialsX v2.20.1
[15:23:42 INFO]: [EssentialsX] Successfully loaded.

4. Проверь работу

Зайди на сервер и набери команду:

/plugins

Ты увидишь список загруженных плагинов. Зелёные - работают, красные - что-то пошло не так.

Plugins (3): EssentialsX, LuckPerms, WorldGuard

Конфигурация плагинов

После первого запуска каждый плагин создаёт свою папку внутри plugins/:

/home/minecraft/server/plugins/
├── EssentialsX-2.20.1.jar
├── Essentials/
│   ├── config.yml          <-- основной конфиг
│   ├── messages.properties
│   └── userdata/
├── LuckPerms-Bukkit-5.4.131.jar
└── LuckPerms/
    └── config.yml

Конфиги - обычно файлы config.yml в формате YAML. Редактируй их любым текстовым редактором:

nano /home/minecraft/server/plugins/Essentials/config.yml

После изменения конфига большинство плагинов можно перезагрузить без рестарта сервера:

/essentials reload

Но некоторые плагины требуют полный рестарт. Читай документацию конкретного плагина.

Зависимости плагинов

Некоторые плагины требуют другие плагины для работы. Например:

• WorldEdit нужен для WorldGuard
• Vault нужен для плагинов экономики
• ProtocolLib нужен для многих плагинов, работающих с пакетами

Если зависимость отсутствует, ты увидишь ошибку при старте:

[15:23:41 ERROR]: Could not load 'plugins/WorldGuard-7.0.9.jar'
org.bukkit.plugin.UnknownDependencyException: Unknown dependency WorldEdit.
Please download and install WorldEdit to run this plugin.

Решение простое - скачай и установи недостающий плагин.

Частые ошибки и их решение

Неправильная версия Minecraft

[15:23:41 ERROR]: Could not load 'plugins/SomePlugin-1.0.jar'
org.bukkit.plugin.InvalidPluginException: Plugin requires Minecraft 1.20+

Плагин собран под другую версию MC. Скачай версию плагина, совместимую с твоей версией сервера.

Устаревшее API

[15:23:41 WARN]: Plugin SomePlugin v1.0 uses deprecated API methods.
This plugin may not work correctly on future versions.

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

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

[15:23:42 ERROR]: Error occurred while enabling SomePlugin v2.0
java.lang.NoClassDefFoundError: com/sk89q/worldedit/WorldEdit

Обычно это проблема зависимостей или конфликт между двумя плагинами, делающими одно и то же. Не ставь два плагина для одной задачи.

Ошибка в config.yml

[15:23:41 ERROR]: Cannot load plugins/MyPlugin/config.yml
org.yaml.snakeyaml.scanner.ScannerException: mapping values are not allowed here

Ошибка синтаксиса YAML. Проверь отступы (только пробелы, не табы!) и кавычки. Прогони файл через yamllint.com.

Обновление плагинов

Обновлять плагины важно - это исправления багов, новые функции и закрытие уязвимостей.

# 1. Останови сервер
# 2. Сделай бэкап
cp -r plugins/ plugins_backup_$(date +%Y%m%d)/

# 3. Замени .jar файл
rm plugins/EssentialsX-2.20.0.jar
cp EssentialsX-2.20.1.jar plugins/

# 4. Запусти сервер

Не обновляй все плагины разом. Обновляй по одному и проверяй, что ничего не сломалось.

Полезные плагины для старта

Минимальный набор для нового сервера:

Плагин	Зачем
EssentialsX	Базовые команды: /home, /spawn, /tpa, /warp, модерация
LuckPerms	Система прав и групп. Лучшее решение на рынке
WorldGuard	Защита регионов от гриферов (требует WorldEdit)
Vault	API для экономики и прав. Нужен многим плагинам
CoreProtect	Логирование изменений блоков. Незаменим для расследования гриферства

Защита от DDoS

Когда сервер набирает аудиторию, он становится мишенью для DDoS-атак. Плагины внутри сервера не могут защитить от сетевых атак - для этого нужна внешняя защита на уровне трафика.

MineGuard работает как прокси перед твоим сервером, фильтруя вредоносный трафик до того, как он дойдёт до игрового ядра. Плагин MineGuard для Paper/Spigot позволяет серверу получать реальные IP-адреса игроков через защищённый канал - без него все игроки будут видны с одного IP-адреса прокси.

Установка плагина MineGuard такая же, как и любого другого - скачай .jar из личного кабинета и закинь в plugins/. Конфиг сгенерируется автоматически при первом запуске.

Итого

Установка плагинов - базовый навык для любого админа Minecraft сервера. Процесс простой: скачал .jar, кинул в plugins/, перезапустил сервер. Сложности начинаются с конфигурацией и совместимостью, но почти любая ошибка решается чтением логов.

Начни с EssentialsX + LuckPerms + Vault, настрой базовые вещи, и уже потом добавляй плагины по мере необходимости. Не ставь 50 плагинов сразу - это путь к проблемам с производительностью и конфликтами.