Настройка плагинов для Minecraft сервера: различия между версиями
Добавлен блок со ссылками на Telegram |
Ссылки на подробные инструкции по плагинам |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 1: | Строка 1: | ||
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]] › [[Установка игрового сервера на VDS|Игровые серверы на VDS]]</div> | <div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]] › [[Установка игрового сервера на VDS|Игровые серверы на VDS]]</div> | ||
Плагины добавляют на сервер Minecraft то, чего нет в самой игре: права и ранги, точки дома и телепортацию, приваты, экономику, защиту от читов. Игрокам ничего устанавливать не нужно. В статье — где брать плагины, как их ставить, настраивать и удалять, на примере двух самых распространённых: LuckPerms (права) и EssentialsX (основные команды). Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с сервером Paper 26.3, снимки экрана сняты с настоящего сервера. | |||
== | == Что понадобится == | ||
Плагины работают только на серверах Paper, Spigot и CraftBukkit — на обычном сервере (Vanilla) их нет. Сервер из статьи [[Установка и настройка Spigot-Paper сервера]] подходит без изменений: дальше считается, что он установлен в <code>/opt/minecraft/server</code> и запущен как служба <code>minecraft</code>. | |||
Плагины — это не моды. Моды меняют саму игру и ставятся и на сервер, и каждому игроку: [[Настройка Minecraft сервера с модами Forge-Fabric]]. | |||
== | == Где брать плагины == | ||
{| class="wikitable" | |||
! style="width:26%;" | Сайт !! Что это | |||
|- | |||
| hangar.papermc.io || Каталог плагинов от разработчиков Paper | |||
|- | |||
| modrinth.com/plugins || Большой каталог плагинов и модов с удобным поиском по версии игры | |||
|- | |||
| spigotmc.org/resources || Самый старый каталог; часть плагинов платные | |||
|- | |||
| Сайт или страница GitHub самого плагина || Обычно там самая свежая версия | |||
|} | |||
Перед загрузкой проверьте две вещи: плагин подходит к вашей версии игры и он рассчитан на Paper или Spigot (а не Forge, Fabric или BungeeCord). Не берите плагины с посторонних сайтов и из «сборок»: плагин получает на сервере полную власть, и вредоносный файл может украсть или стереть всё. | |||
== 1. Установка == | |||
Плагин — это один файл с расширением <code>.jar</code>. Его кладут в каталог <code>plugins</code> и перезапускают сервер. | |||
Файл можно скачать на свой компьютер и загрузить на сервер по SFTP, а можно скачать сразу на сервер: | |||
<pre>sudo -iu minecraft | |||
<pre> | 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</pre> | |||
[[Файл:Linux-mcpl-install.png|800px]] | |||
* Первая команда <code>curl</code> скачивает последнюю версию LuckPerms, вторая — EssentialsX 2.22.0. Для других плагинов подставьте адрес файла со страницы плагина. | |||
< | * Проверьте размер файлов командой <code>ls -lh</code>: файл в несколько сотен байт вместо мегабайт — признак неудачной загрузки. | ||
* Каталоги <code>bStats</code> и <code>spark</code> создаёт сам Paper. | |||
Плагины загружаются только при запуске сервера. Команду <code>reload</code>, которую советуют старые инструкции, не используйте: после неё часть плагинов работает с ошибками. | |||
< | |||
== | == 2. Проверка и первые команды == | ||
Откройте консоль сервера: | |||
<pre>sudo -u minecraft tmux attach -t minecraft</pre> | |||
<pre>sudo | |||
[[Файл:Linux-mcpl-console.png|800px]] | |||
Команда <code>plugins</code> показывает загруженные плагины. Выйти из консоли, не останавливая сервер, — '''Ctrl+B''', затем '''D'''. | |||
< | |||
Остальные команды на снимке — настройка прав в LuckPerms: | |||
{| class="wikitable" | |||
! style="width:55%;" | Команда !! Что делает | |||
|- | |||
| <code>lp creategroup admin</code> || Создать группу <code>admin</code> | |||
|- | |||
| <code>lp group admin permission set essentials.* true</code> || Дать группе все права плагина EssentialsX | |||
|- | |||
| <code>lp group default permission set essentials.home true</code> || Разрешить всем игрокам команду <code>/home</code>. В группе <code>default</code> состоит каждый | |||
|- | |||
| <code>lp user НИК parent add admin</code> || Добавить игрока в группу <code>admin</code> | |||
|- | |||
| <code>lp listgroups</code> || Список групп | |||
|- | |||
| <code>lp editor</code> || Открыть редактор прав в браузере — удобнее, чем команды | |||
|} | |||
В консоли сервера команды пишут без косой черты, в игре — с ней: <code>/lp listgroups</code>. Название права (<code>essentials.home</code>) у каждой команды своё; они перечислены в описании плагина. | |||
== 3. Настройка плагина == | |||
При первом запуске плагин создаёт в <code>plugins</code> каталог со своим именем, а в нём — файл настроек, чаще всего <code>config.yml</code>. | |||
<pre>sudo ls /opt/minecraft/server/plugins | |||
<pre>nano plugins/Essentials/ | sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.yml</pre> | ||
[[Файл:Linux-mcpl-config.png|800px]] | |||
На снимке в настройках EssentialsX изменена пауза между телепортациями (<code>teleport-cooldown</code>), после чего плагин перечитал настройки командой <code>essentials reload</code>. | |||
* Отступы в файлах <code>.yml</code> значимы: только пробелы, не табуляция. | |||
* У многих плагинов есть своя команда перечитать настройки (<code>essentials reload</code>, <code>lp sync</code>). Если её нет, перезапустите сервер. | |||
* Правьте файлы от имени пользователя <code>minecraft</code> (<code>sudo -u minecraft …</code>), иначе сервер не сможет их изменить. | |||
== 4. Обновление и удаление == | |||
{| class="wikitable" | |||
! style="width:30%;" | Задача !! Что сделать | |||
|- | |||
| Обновить плагин || Остановить сервер, удалить старый файл <code>.jar</code>, положить новый, запустить сервер. Каталог с настройками остаётся | |||
|- | |||
| Удалить плагин || Остановить сервер, удалить файл <code>.jar</code>. Каталог с настройками и данными удаляйте, только если они больше не нужны | |||
|- | |||
| Временно отключить || Остановить сервер и переименовать файл, например в <code>Имя.jar.off</code> | |||
|} | |||
Перед обновлением сервера на новую версию игры проверьте, что под неё вышли все ваши плагины, и сделайте копию: [[Настройка автоматических бэкапов Minecraft]]. | |||
== | == С чего начать == | ||
== | {| class="wikitable" | ||
! style="width:26%;" | Плагин !! Зачем | |||
|- | |||
| LuckPerms || Права и группы игроков — [[Права и группы на сервере Minecraft — плагин LuckPerms|подробная инструкция]] | |||
|- | |||
| EssentialsX || Основные команды: <code>/home</code>, <code>/spawn</code>, <code>/tpa</code>, наборы предметов, сообщения | |||
|- | |||
| WorldGuard и WorldEdit || Защита территорий и правка мира — [[Защита построек на сервере Minecraft — WorldGuard и WorldEdit|подробная инструкция]] | |||
|- | |||
| CoreProtect || Журнал действий игроков и откат разрушений | |||
|- | |||
| Vault || Связывает плагины экономики и прав между собой; нужен многим другим плагинам | |||
|- | |||
| Chunky || Заранее создаёт мир, чтобы сервер не тормозил при исследовании | |||
|- | |||
| BlueMap || Карта мира в браузере — [[Веб-карта мира для сервера Minecraft — BlueMap|подробная инструкция]] | |||
|- | |||
| Geyser и Floodgate || Пускают на сервер игроков с телефонов и консолей — [[Вход игроков Bedrock на сервер Minecraft Java — Geyser и Floodgate|подробная инструкция]] | |||
|} | |||
Каждый плагин занимает память и время процессора. Ставьте только нужные; если после установки десятка плагинов сервер стал медленнее — см. [[Оптимизация производительности Minecraft сервера]], а при нехватке памяти выручит [https://ark-hoster.ru/vpsgame/ тариф VDS побольше]. | |||
== Если что-то пошло не так == | |||
[[Файл:Linux-mcpl-errors.png|800px]] | |||
На снимке в каталог плагинов положен повреждённый файл: сервер записал ошибку в журнал и запустился без него. После удаления файла остались два рабочих плагина. | |||
= | {| class="wikitable" | ||
! Что видите !! Причина и решение | |||
|- | |||
| «Error loading plugin: zip END header not found» || Файл плагина повреждён или скачан не полностью. Скачайте его заново и сравните размер | |||
|- | |||
| «Could not load '…'» и «Unsupported API version» или «UnsupportedClassVersionError» || Плагин не подходит к версии сервера или собран для более новой Java. Возьмите версию плагина под свою версию игры | |||
|- | |||
| «Unknown dependency …» или «Could not load … depend» || Плагину нужен другой плагин (чаще всего Vault). Установите его | |||
|- | |||
| Плагина нет в списке <code>plugins</code> || Файл лежит не в каталоге <code>plugins</code>, сервер не перезапущен или это мод, а не плагин | |||
|- | |||
| Плагин в списке красным || Он загрузился с ошибкой. Причина — в журнале: <code>sudo grep -i -A5 "error" /opt/minecraft/server/logs/latest.log</code> | |||
|- | |||
| «You do not have permission» у игрока || Не выдано право на команду — шаг 2 | |||
|- | |||
| После правки настроек плагин перестал работать || Ошибка в отступах <code>.yml</code>. Причина и номер строки — в журнале сервера | |||
|} | |||
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:''' | |||
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов | |||
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов | |||
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' | |||
{{Телеграм}} | {{Телеграм}} | ||
Текущая версия от 14:59, 17 ноября 2026
Плагины добавляют на сервер 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов