Настройка плагинов для Minecraft сервера: различия между версиями

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Починка кода: пробел перед знаками ! % ; : ? записан кодом, чтобы вики не подставляла неразрывный пробел
Ссылки на подробные инструкции по плагинам
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
= Настройка плагинов для Minecraft сервера =
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]] › [[Установка игрового сервера на VDS|Игровые серверы на VDS]]</div>
Плагины добавляют на сервер Minecraft то, чего нет в самой игре: права и ранги, точки дома и телепортацию, приваты, экономику, защиту от читов. Игрокам ничего устанавливать не нужно. В статье — где брать плагины, как их ставить, настраивать и удалять, на примере двух самых распространённых: LuckPerms (права) и EssentialsX (основные команды). Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с сервером Paper 26.3, снимки экрана сняты с настоящего сервера.


== 1. Подготовка системы ==
== Что понадобится ==


* Войдите в систему под учетной записью с правами '''root''' или пользователя с правами '''sudo'''.
Плагины работают только на серверах Paper, Spigot и CraftBukkit — на обычном сервере (Vanilla) их нет. Сервер из статьи [[Установка и настройка Spigot-Paper сервера]] подходит без изменений: дальше считается, что он установлен в <code>/opt/minecraft/server</code> и запущен как служба <code>minecraft</code>.
* Убедитесь, что у вас есть доступ к серверу через SSH или консоль.
* Рекомендуется использовать Ubuntu 24.04 LTS для стабильной работы.


== 2. Установка необходимых плагинов ==
Плагины — это не моды. Моды меняют саму игру и ставятся и на сервер, и каждому игроку: [[Настройка Minecraft сервера с модами Forge-Fabric]].


=== Создание директории для плагинов ===
== Где брать плагины ==


1. Перейдите в директорию сервера:
{| class="wikitable"
<pre>cd /opt/minecraft/spigot</pre>
! style="width:26%;" | Сайт !! Что это
|-
| hangar.papermc.io || Каталог плагинов от разработчиков Paper
|-
| modrinth.com/plugins || Большой каталог плагинов и модов с удобным поиском по версии игры
|-
| spigotmc.org/resources || Самый старый каталог; часть плагинов платные
|-
| Сайт или страница GitHub самого плагина || Обычно там самая свежая версия
|}


2. Создайте директорию для плагинов:
Перед загрузкой проверьте две вещи: плагин подходит к вашей версии игры и он рассчитан на Paper или Spigot (а не Forge, Fabric или BungeeCord). Не берите плагины с посторонних сайтов и из «сборок»: плагин получает на сервере полную власть, и вредоносный файл может украсть или стереть всё.
<pre>mkdir -p plugins</pre>


3. Установите права доступа:
== 1. Установка ==
<pre>chmod 755 plugins</pre>


=== Установка основных плагинов ===
Плагин — это один файл с расширением <code>.jar</code>. Его кладут в каталог <code>plugins</code> и перезапускают сервер.


1. '''Установка WorldEdit''':
Файл можно скачать на свой компьютер и загрузить на сервер по SFTP, а можно скачать сразу на сервер:
<pre>cd plugins</pre>
<pre>wget https://dev.bukkit.org/projects/worldedit/files/latest</pre>
<pre>mv latest WorldEdit.jar</pre>


2. '''Установка EssentialsX''':
<pre>sudo -iu minecraft
<pre>wget https://github.com/EssentialsX/Essentials/releases/latest/download/EssentialsX-2.20.1.jar</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>


3. '''Установка Vault''':
[[Файл:Linux-mcpl-install.png|800px]]
<pre>wget https://github.com/MilkBowl/Vault/releases/latest/download/Vault-1.7.3.jar</pre>


4. '''Установка LuckPerms''':
* Первая команда <code>curl</code> скачивает последнюю версию LuckPerms, вторая — EssentialsX 2.22.0. Для других плагинов подставьте адрес файла со страницы плагина.
<pre>wget https://github.com/lucko/LuckPerms/releases/latest/download/LuckPerms-Bukkit-5.4.101.jar</pre>
* Проверьте размер файлов командой <code>ls -lh</code>: файл в несколько сотен байт вместо мегабайт — признак неудачной загрузки.
* Каталоги <code>bStats</code> и <code>spark</code> создаёт сам Paper.


5. '''Установка PlaceholderAPI''':
Плагины загружаются только при запуске сервера. Команду <code>reload</code>, которую советуют старые инструкции, не используйте: после неё часть плагинов работает с ошибками.
<pre>wget https://github.com/PlaceholderAPI/PlaceholderAPI/releases/latest/download/PlaceholderAPI-2.11.4.jar</pre>


== 3. Настройка EssentialsX ==
== 2. Проверка и первые команды ==


=== Базовая конфигурация ===
Откройте консоль сервера:


1. Запустите сервер для создания конфигурационных файлов:
<pre>sudo -u minecraft tmux attach -t minecraft</pre>
<pre>cd /opt/minecraft/spigot</pre>
<pre>sudo systemctl start minecraft-spigot</pre>


2. Остановите сервер через несколько секунд:
[[Файл:Linux-mcpl-console.png|800px]]
<pre>sudo systemctl stop minecraft-spigot</pre>


3. Настройте config.yml:
Команда <code>plugins</code> показывает загруженные плагины. Выйти из консоли, не останавливая сервер, — '''Ctrl+B''', затем '''D'''.
<pre>nano plugins/Essentials/config.yml</pre>


4. Настройте основные параметры:
Остальные команды на снимке — настройка прав в LuckPerms:
<pre># Essentials Configuration
# Основные настройки
chat:
  format: '&7[&6{GROUP}&7] &f{DISPLAYNAME}&7: &f{MESSAGE}'
  radius: 0
  local-format: '&7[&6{GROUP}&7] &f{DISPLAYNAME}&7: &f{MESSAGE}'


# Настройки телепортации
{| class="wikitable"
teleport:
! style="width:55%;" | Команда !! Что делает
  delay: 0
|-
  cooldown: 0
| <code>lp creategroup admin</code> || Создать группу <code>admin</code>
  invulnerability: 0
|-
| <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>) у каждой команды своё; они перечислены в описании плагина.
economy:
  currency-symbol: '$'
  starting-balance: 0.0
  max-money: 1000000.0
  min-pay-amount: 0.0


# Настройки спавна
== 3. Настройка плагина ==
spawn:
  on-join: true
  on-respawn: true
  on-death: false
</pre>


=== Настройка команд ===
При первом запуске плагин создаёт в <code>plugins</code> каталог со своим именем, а в нём — файл настроек, чаще всего <code>config.yml</code>.


1. Настройте commands.yml:
<pre>sudo ls /opt/minecraft/server/plugins
<pre>nano plugins/Essentials/commands.yml</pre>
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.yml</pre>


2. Настройте команды:
[[Файл:Linux-mcpl-config.png|800px]]
<pre># Essentials Commands Configuration
# Основные команды
home:
  description: Телепортация домой
  usage: /home [название]
  permission: essentials.home


sethome:
На снимке в настройках EssentialsX изменена пауза между телепортациями (<code>teleport-cooldown</code>), после чего плагин перечитал настройки командой <code>essentials reload</code>.
  description: Установка дома
  usage: /sethome [название]
  permission: essentials.sethome


spawn:
* Отступы в файлах <code>.yml</code> значимы: только пробелы, не табуляция.
  description: Телепортация на спавн
* У многих плагинов есть своя команда перечитать настройки (<code>essentials reload</code>, <code>lp sync</code>). Если её нет, перезапустите сервер.
  usage: /spawn
* Правьте файлы от имени пользователя <code>minecraft</code> (<code>sudo -u minecraft …</code>), иначе сервер не сможет их изменить.
  permission: essentials.spawn


tpa:
== 4. Обновление и удаление ==
  description: Запрос телепортации
  usage: /tpa <игрок>
  permission: essentials.tpa


tpaccept:
{| class="wikitable"
  description: Принятие телепортации
! style="width:30%;" | Задача !! Что сделать
  usage: /tpaccept
|-
  permission: essentials.tpaccept
| Обновить плагин || Остановить сервер, удалить старый файл <code>.jar</code>, положить новый, запустить сервер. Каталог с настройками остаётся
|-
| Удалить плагин || Остановить сервер, удалить файл <code>.jar</code>. Каталог с настройками и данными удаляйте, только если они больше не нужны
|-
| Временно отключить || Остановить сервер и переименовать файл, например в <code>Имя.jar.off</code>
|}


tpahere:
Перед обновлением сервера на новую версию игры проверьте, что под неё вышли все ваши плагины, и сделайте копию: [[Настройка автоматических бэкапов Minecraft]].
  description: Запрос телепортации к себе
  usage: /tpahere <игрок>
  permission: essentials.tpahere
</pre>


== 4. Настройка LuckPerms ==
== С чего начать ==


=== Базовая конфигурация ===
{| 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|подробная инструкция]]
|}


1. Настройте config.yml:
Каждый плагин занимает память и время процессора. Ставьте только нужные; если после установки десятка плагинов сервер стал медленнее — см. [[Оптимизация производительности Minecraft сервера]], а при нехватке памяти выручит [https://ark-hoster.ru/vpsgame/ тариф VDS побольше].
<pre>nano plugins/LuckPerms/config.yml</pre>


2. Настройте основные параметры:
== Если что-то пошло не так ==
<pre># LuckPerms Configuration
# Основные настройки
server: "global"
storage-method: "h2"
data:
  address: "localhost:3306"
  database: "minecraft"
  username: "minecraft"
  password: "password"
  table-prefix: "luckperms_"


# Настройки синхронизации
[[Файл:Linux-mcpl-errors.png|800px]]
sync-minutes: 3
auto-push-updates: true
push-log-entries: true


# Настройки веб-интерфейса
На снимке в каталог плагинов положен повреждённый файл: сервер записал ошибку в журнал и запустился без него. После удаления файла остались два рабочих плагина.
web-editor:
  enabled: true
  address: "0.0.0.0"
  port: 8080
  secret: "your-secret-key"
</pre>


=== Создание групп ===
{| 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>. Причина и номер строки — в журнале сервера
|}


1. Создайте скрипт для настройки групп:
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:'''
<pre>nano setup-groups.sh</pre>


2. Добавьте содержимое:
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
<pre>#!/bin/bash
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов


# Создание групп
{{Телеграм}}
echo "Создание групп..."
 
# Группа по умолчанию
echo "lp creategroup default" | nc localhost 25565
 
# Группа VIP
echo "lp creategroup vip" | nc localhost 25565
 
# Группа Moderator
echo "lp creategroup moderator" | nc localhost 25565
 
# Группа Admin
echo "lp creategroup admin" | nc localhost 25565
 
# Настройка прав
echo "lp group default permission set essentials.home true" | nc localhost 25565
echo "lp group default permission set essentials.sethome true" | nc localhost 25565
echo "lp group default permission set essentials.spawn true" | nc localhost 25565
 
echo "lp group vip permission set essentials.home.others true" | nc localhost 25565
echo "lp group vip permission set essentials.tpa true" | nc localhost 25565
echo "lp group vip permission set essentials.tpahere true" | nc localhost 25565
 
echo "lp group moderator permission set essentials.* true" | nc localhost 25565
echo "lp group moderator permission set worldedit.* true" | nc localhost 25565
 
echo "lp group admin permission set * true" | nc localhost 25565
 
# Настройка приоритетов
echo "lp group default weight 0" | nc localhost 25565
echo "lp group vip weight 10" | nc localhost 25565
echo "lp group moderator weight 20" | nc localhost 25565
echo "lp group admin weight 30" | nc localhost 25565
 
echo "Группы настроены!"
</pre>
 
3. Сделайте скрипт исполняемым:
<pre>chmod +x setup-groups.sh</pre>
 
== 5. Настройка WorldEdit ==
 
=== Базовая конфигурация ===
 
1. Настройте config.yml:
<pre>nano plugins/WorldEdit/config.yml</pre>
 
2. Настройте основные параметры:
<pre># WorldEdit Configuration
# Основные настройки
max-blocks-per-chunk: 65536
max-blocks-per-chunk-analyze: 65536
max-blocks-per-chunk-ops: 65536
max-blocks-per-chunk-ops-analyze: 65536
max-blocks-per-chunk-ops-analyze: 65536
 
# Настройки ограничений
max-blocks-per-chunk-ops-analyze: 65536
max-blocks-per-chunk-ops-analyze: 65536
max-blocks-per-chunk-ops-analyze: 65536
 
# Настройки истории
history:
  size: 15
  use-disk: true
  use-database: false
 
# Настройки экономики
economy:
  cost: 0.0
  use-cost: false
</pre>
 
=== Настройка команд ===
 
1. Настройте commands.yml:
<pre>nano plugins/WorldEdit/commands.yml</pre>
 
2. Настройте команды:
<pre># WorldEdit Commands Configuration
# Основные команды
//wand:
  description: Получить инструмент выбора
  usage: //wand
  permission: worldedit.wand
 
//set:
  description: Установить блоки
  usage: //set <блок>
  permission: worldedit.set
 
//copy:
  description: Копировать область
  usage: //copy
  permission: worldedit.copy
 
//paste:
  description: Вставить область
  usage: //paste
  permission: worldedit.paste
 
//undo:
  description: Отменить действие
  usage: //undo [количество]
  permission: worldedit.undo
 
//redo:
  description: Повторить действие
  usage: //redo [количество]
  permission: worldedit.redo
</pre>
 
== 6. Установка дополнительных плагинов ==
 
=== Плагины для экономики ===
 
1. '''Установка CMI''':
<pre>cd /opt/minecraft/spigot/plugins</pre>
<pre>wget https://github.com/Zrips/CMI/releases/latest/download/CMI-9.6.0.0.jar</pre>
 
2. '''Установка Jobs Reborn''':
<pre>wget https://github.com/Zrips/Jobs/releases/latest/download/Jobs-5.0.0.0.jar</pre>
 
3. '''Установка ShopGUIPlus''':
<pre>wget https://github.com/brcdev-minecraft/ShopGUIPlus/releases/latest/download/ShopGUIPlus-1.8.0.jar</pre>
 
=== Плагины для защиты ===
 
1. '''Установка GriefPrevention''':
<pre>wget https://github.com/TechFortress/GriefPrevention/releases/latest/download/GriefPrevention-16.18.jar</pre>
 
2. '''Установка WorldGuard''':
<pre>wget https://github.com/EngineHub/WorldGuard/releases/latest/download/worldguard-bukkit-7.0.9.jar</pre>
 
3. '''Установка CoreProtect''':
<pre>wget https://github.com/PlayPro/CoreProtect/releases/latest/download/CoreProtect-22.2.jar</pre>
 
=== Плагины для развлечений ===
 
1. '''Установка Citizens''':
<pre>wget https://github.com/CitizensDev/Citizens2/releases/latest/download/Citizens-2.0.32-SNAPSHOT.jar</pre>
 
2. '''Установка MythicMobs''':
<pre>wget https://github.com/xikage/MythicMobs/releases/latest/download/MythicMobs-5.4.0.jar</pre>
 
3. '''Установка mcMMO''':
<pre>wget https://github.com/mcMMO-Dev/mcMMO/releases/latest/download/mcMMO-2.1.220.jar</pre>
 
== 7. Настройка конфигурации плагинов ==
 
=== Настройка CMI ===
 
1. Настройте config.yml:
<pre>nano plugins/CMI/config.yml</pre>
 
2. Настройте основные параметры:
<pre># CMI Configuration
# Основные настройки
Language: "ru"
Debug: false
UpdateChecker: true
 
# Настройки экономики
Economy:
  enabled: true
  currency-symbol: "₽"
  starting-balance: 1000.0
  max-money: 10000000.0
 
# Настройки телепортации
Teleport:
  delay: 3
  cooldown: 5
  invulnerability: 10
 
# Настройки чата
Chat:
  format: "&7[&6{GROUP}&7] &f{DISPLAYNAME}&7: &f{MESSAGE}"
  radius: 0
  local-format: "&7[&6{GROUP}&7] &f{DISPLAYNAME}&7: &f{MESSAGE}"
</pre>
 
=== Настройка Jobs Reborn ===
 
1. Настройте config.yml:
<pre>nano plugins/Jobs/config.yml</pre>
 
2. Настройте основные параметры:
<pre># Jobs Reborn Configuration
# Основные настройки
Language: "ru"
Debug: false
UpdateChecker: true
 
# Настройки экономики
Economy:
  enabled: true
  currency-symbol: "₽"
  starting-balance: 0.0
  max-money: 10000000.0
 
# Настройки работы
Jobs:
  enabled: true
  max-jobs: 3
  level-cap: 100
  exp-multiplier: 1.0
  money-multiplier: 1.0
</pre>
 
== 8. Настройка базы данных ==
 
=== Установка MySQL ===
 
1. Установите MySQL:
<pre>sudo apt install -y mysql-server</pre>
 
2. Запустите и включите автозапуск:
<pre>sudo systemctl start mysql</pre>
<pre>sudo systemctl enable mysql</pre>
 
3. Настройте безопасность MySQL:
<pre>sudo mysql_secure_installation</pre>
 
=== Создание базы данных ===
 
1. Подключитесь к MySQL:
<pre>sudo mysql -u root -p</pre>
 
2. Создайте базу данных и пользователя:
<pre>CREATE DATABASE minecraft CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'minecraft'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON minecraft.* TO 'minecraft'@'localhost';
FLUSH PRIVILEGES;
EXIT;</pre>
 
=== Настройка подключения к базе данных ===
 
1. Настройте LuckPerms для использования MySQL:
<pre>nano plugins/LuckPerms/config.yml</pre>
 
2. Измените настройки:
<pre>storage-method: "mysql"
data:
  address: "localhost:3306"
  database: "minecraft"
  username: "minecraft"
  password: "strong_password"
  table-prefix: "luckperms_"
</pre>
 
== 9. Настройка мониторинга плагинов ==
 
=== Создание скрипта мониторинга ===
 
1. Создайте скрипт мониторинга:
<pre>sudo nano /usr/local/bin/minecraft-plugins-monitor.sh</pre>
 
2. Добавьте содержимое:
<pre>#!/bin/bash
 
# Проверка статуса сервера
if&#32;! systemctl is-active --quiet minecraft-spigot; then
    echo "Minecraft сервер не запущен!" | mail -s "Minecraft Alert" admin@example.com
fi
 
# Проверка плагинов
PLUGINS_DIR="/opt/minecraft/spigot/plugins"
PLUGINS_COUNT=$(ls -1 $PLUGINS_DIR/*.jar 2>/dev/null | wc -l)
 
if [ $PLUGINS_COUNT -eq 0 ]; then
    echo "Плагины не найдены в директории $PLUGINS_DIR!" | mail -s "Minecraft Alert" admin@example.com
fi
 
# Проверка использования памяти
MEMORY_USAGE=$(ps aux | grep spigot | grep -v grep | awk '{print $4}')
if [&#32;! -z "$MEMORY_USAGE" ] && [ $(echo "$MEMORY_USAGE > 80" | bc) -eq 1 ]; then
    echo "Высокое использование памяти: ${MEMORY_USAGE}%" | mail -s "Minecraft Alert" admin@example.com
fi
 
# Проверка доступности порта
if&#32;! nc -z localhost 25565; then
    echo "Minecraft сервер не отвечает на порту 25565!" | mail -s "Minecraft Alert" admin@example.com
fi
</pre>
 
3. Сделайте скрипт исполняемым:
<pre>sudo chmod +x /usr/local/bin/minecraft-plugins-monitor.sh</pre>
 
4. Добавьте в crontab:
<pre>sudo crontab -e</pre>
 
5. Добавьте задачу:
<pre>*/5 * * * * /usr/local/bin/minecraft-plugins-monitor.sh</pre>
 
== 10. Резервное копирование плагинов ==
 
=== Создание скрипта резервного копирования ===
 
1. Создайте скрипт резервного копирования:
<pre>sudo nano /usr/local/bin/minecraft-plugins-backup.sh</pre>
 
2. Добавьте содержимое:
<pre>#!/bin/bash
 
BACKUP_DIR="/backup/minecraft-plugins"
DATE=$(date +%Y%m%d_%H%M%S)
 
# Создание директории для бэкапа
mkdir -p $BACKUP_DIR
 
# Остановка сервера для бэкапа
systemctl stop minecraft-spigot
 
# Создание архива плагинов
tar -czf $BACKUP_DIR/plugins-backup-$DATE.tar.gz -C /opt/minecraft/spigot plugins
 
# Создание архива конфигурации
tar -czf $BACKUP_DIR/config-backup-$DATE.tar.gz -C /opt/minecraft/spigot plugins/*/config.yml
 
# Запуск сервера
systemctl start minecraft-spigot
 
# Удаление старых бэкапов (старше 7 дней)
find $BACKUP_DIR -name "*-backup-*" -mtime +7 -delete
 
echo "Minecraft plugins backup completed: $DATE"
</pre>
 
3. Сделайте скрипт исполняемым:
<pre>sudo chmod +x /usr/local/bin/minecraft-plugins-backup.sh</pre>
 
4. Добавьте в crontab:
<pre>sudo crontab -e</pre>
 
5. Добавьте задачу:
<pre>0 3 * * * /usr/local/bin/minecraft-plugins-backup.sh</pre>
 
== 11. Устранение неполадок ==
 
=== Частые проблемы ===
 
1. '''Плагины не загружаются''':
* Проверьте совместимость версий плагинов
* Проверьте зависимости плагинов
* Проверьте логи сервера
 
2. '''Проблемы с производительностью''':
* Оптимизируйте настройки плагинов
* Проверьте конфликтующие плагины
* Увеличьте выделенную память
 
3. '''Проблемы с базой данных''':
* Проверьте подключение к MySQL
* Проверьте права доступа к базе данных
* Проверьте логи плагинов
 
=== Диагностика ===
 
1. '''Проверка статуса сервера''':
<pre>sudo systemctl status minecraft-spigot</pre>
 
2. '''Проверка логов''':
<pre>sudo journalctl -u minecraft-spigot -f</pre>
 
3. '''Проверка плагинов''':
<pre>ls -la /opt/minecraft/spigot/plugins/</pre>
 
4. '''Проверка конфигурации''':
<pre>ls -la /opt/minecraft/spigot/plugins/*/config.yml</pre>
 
5. '''Проверка базы данных''':
<pre>mysql -u minecraft -p -e "SHOW DATABASES;"</pre>
 
== Заключение ==
 
Плагины для Minecraft сервера успешно установлены и настроены! Теперь у вас есть полнофункциональный сервер с возможностями экономики, защиты, развлечений и мониторинга.
 
'''Для размещения ваших Minecraft серверов с плагинами на надежном хостинге рекомендуем воспользоваться услугами [https://ark-hoster.ru ARK-HOSTER.RU]:'''
 
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' - для высоконагруженных серверов с плагинами
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' - для небольших и средних серверов
 
Наши специалисты помогут с настройкой плагинов и оптимизацией производительности!

Текущая версия от 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: