Настройка плагинов для Minecraft сервера
Плагины добавляют на сервер Minecraft то, чего нет в самой игре: права и ранги, точки дома и телепортацию, приваты, экономику, защиту от читов. Игрокам ничего устанавливать не нужно. В статье — где брать плагины, как их ставить, настраивать и удалять, на примере двух самых распространённых: LuckPerms (права) и EssentialsX (основные команды). Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с сервером Paper 26.3, снимки экрана сняты с настоящего сервера.
Что понадобится
Плагины работают только на серверах Paper, Spigot и CraftBukkit — на обычном сервере (Vanilla) их нет. Сервер из статьи Установка и настройка Spigot-Paper сервера подходит без изменений: дальше считается, что он установлен в /opt/minecraft/server и запущен как служба minecraft.
Плагины — это не моды. Моды меняют саму игру и ставятся и на сервер, и каждому игроку: Настройка Minecraft сервера с модами Forge-Fabric.
Где брать плагины
| Сайт | Что это |
|---|---|
| hangar.papermc.io | Каталог плагинов от разработчиков Paper |
| modrinth.com/plugins | Большой каталог плагинов и модов с удобным поиском по версии игры |
| spigotmc.org/resources | Самый старый каталог; часть плагинов платные |
| Сайт или страница GitHub самого плагина | Обычно там самая свежая версия |
Перед загрузкой проверьте две вещи: плагин подходит к вашей версии игры и он рассчитан на Paper или Spigot (а не Forge, Fabric или BungeeCord). Не берите плагины с посторонних сайтов и из «сборок»: плагин получает на сервере полную власть, и вредоносный файл может украсть или стереть всё.
1. Установка
Плагин — это один файл с расширением .jar. Его кладут в каталог plugins и перезапускают сервер.
Файл можно скачать на свой компьютер и загрузить на сервер по SFTP, а можно скачать сразу на сервер:
sudo -iu minecraft cd ~/server/plugins curl -sLO "$(curl -s https://metadata.luckperms.net/data/downloads | jq -r .downloads.bukkit)" curl -sLO https://github.com/EssentialsX/Essentials/releases/download/2.22.0/EssentialsX-2.22.0.jar ls -lh exit sudo systemctl restart minecraft
- Первая команда
curlскачивает последнюю версию LuckPerms, вторая — EssentialsX 2.22.0. Для других плагинов подставьте адрес файла со страницы плагина. - Проверьте размер файлов командой
ls -lh: файл в несколько сотен байт вместо мегабайт — признак неудачной загрузки. - Каталоги
bStatsиsparkсоздаёт сам Paper.
Плагины загружаются только при запуске сервера. Команду reload, которую советуют старые инструкции, не используйте: после неё часть плагинов работает с ошибками.
2. Проверка и первые команды
Откройте консоль сервера:
sudo -u minecraft tmux attach -t minecraft
Команда plugins показывает загруженные плагины. Выйти из консоли, не останавливая сервер, — Ctrl+B, затем D.
Остальные команды на снимке — настройка прав в LuckPerms:
| Команда | Что делает |
|---|---|
lp creategroup admin |
Создать группу admin
|
lp group admin permission set essentials.* true |
Дать группе все права плагина EssentialsX |
lp group default permission set essentials.home true |
Разрешить всем игрокам команду /home. В группе default состоит каждый
|
lp user НИК parent add admin |
Добавить игрока в группу admin
|
lp listgroups |
Список групп |
lp editor |
Открыть редактор прав в браузере — удобнее, чем команды |
В консоли сервера команды пишут без косой черты, в игре — с ней: /lp listgroups. Название права (essentials.home) у каждой команды своё; они перечислены в описании плагина.
3. Настройка плагина
При первом запуске плагин создаёт в plugins каталог со своим именем, а в нём — файл настроек, чаще всего config.yml.
sudo ls /opt/minecraft/server/plugins sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.yml
На снимке в настройках EssentialsX изменена пауза между телепортациями (teleport-cooldown), после чего плагин перечитал настройки командой essentials reload.
- Отступы в файлах
.ymlзначимы: только пробелы, не табуляция. - У многих плагинов есть своя команда перечитать настройки (
essentials reload,lp sync). Если её нет, перезапустите сервер. - Правьте файлы от имени пользователя
minecraft(sudo -u minecraft …), иначе сервер не сможет их изменить.
4. Обновление и удаление
| Задача | Что сделать |
|---|---|
| Обновить плагин | Остановить сервер, удалить старый файл .jar, положить новый, запустить сервер. Каталог с настройками остаётся
|
| Удалить плагин | Остановить сервер, удалить файл .jar. Каталог с настройками и данными удаляйте, только если они больше не нужны
|
| Временно отключить | Остановить сервер и переименовать файл, например в Имя.jar.off
|
Перед обновлением сервера на новую версию игры проверьте, что под неё вышли все ваши плагины, и сделайте копию: Настройка автоматических бэкапов Minecraft.
С чего начать
| Плагин | Зачем |
|---|---|
| LuckPerms | Права и группы игроков |
| EssentialsX | Основные команды: /home, /spawn, /tpa, наборы предметов, сообщения
|
| WorldGuard и WorldEdit | Защита территорий и правка мира |
| CoreProtect | Журнал действий игроков и откат разрушений |
| Vault | Связывает плагины экономики и прав между собой; нужен многим другим плагинам |
| Chunky | Заранее создаёт мир, чтобы сервер не тормозил при исследовании |
Каждый плагин занимает память и время процессора. Ставьте только нужные; если после установки десятка плагинов сервер стал медленнее — см. Оптимизация производительности Minecraft сервера, а при нехватке памяти выручит тариф VDS побольше.
Если что-то пошло не так
На снимке в каталог плагинов положен повреждённый файл: сервер записал ошибку в журнал и запустился без него. После удаления файла остались два рабочих плагина.
| Что видите | Причина и решение |
|---|---|
| «Error loading plugin: zip END header not found» | Файл плагина повреждён или скачан не полностью. Скачайте его заново и сравните размер |
| «Could not load '…'» и «Unsupported API version» или «UnsupportedClassVersionError» | Плагин не подходит к версии сервера или собран для более новой Java. Возьмите версию плагина под свою версию игры |
| «Unknown dependency …» или «Could not load … depend» | Плагину нужен другой плагин (чаще всего Vault). Установите его |
Плагина нет в списке plugins |
Файл лежит не в каталоге plugins, сервер не перезапущен или это мод, а не плагин
|
| Плагин в списке красным | Он загрузился с ошибкой. Причина — в журнале: sudo grep -i -A5 "error" /opt/minecraft/server/logs/latest.log
|
| «You do not have permission» у игрока | Не выдано право на команду — шаг 2 |
| После правки настроек плагин перестал работать | Ошибка в отступах .yml. Причина и номер строки — в журнале сервера
|
Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов