Настройка плагинов для Minecraft сервера

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 14:59, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Ссылки на подробные инструкции по плагинам)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

Плагины добавляют на сервер 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 Заранее создаёт мир, чтобы сервер не тормозил при исследовании
BlueMap Карта мира в браузере — подробная инструкция
Geyser и Floodgate Пускают на сервер игроков с телефонов и консолей — подробная инструкция

Каждый плагин занимает память и время процессора. Ставьте только нужные; если после установки десятка плагинов сервер стал медленнее — см. Оптимизация производительности 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: