Установка EssentialsX на сервер Minecraft

Установка EssentialsX: какие модули ставить, настройка config.yml, дома и варпы, киты, экономика, права через LuckPerms и типичные конфликты.

EssentialsX — базовый набор команд, без которого сервер выживания выглядит голым: дома, варпы, телепорты, киты, экономика, спавн, приватные сообщения. Установка EssentialsX сама по себе простая, но плагин модульный, и половина вопросов возникает из-за того, что нужный модуль не поставили или поставили лишний.

Разберу, какие файлы качать, что настроить в первый час и как связать всё это с правами.

Модули: что качать

С официального сайта скачивается набор .jar-файлов. Ставить нужно не все, а при обновлении все модули должны быть одной версии — это прямо оговорено в документации EssentialsX.

Модуль	Что делает	Нужен ли
EssentialsX	Ядро: дома, варпы, телепорты, кики, мьюты, базовая экономика	Обязательно
EssentialsXChat	Форматирование чата, префиксы из LuckPerms, локальный чат	Для выживания — да
EssentialsXSpawn	Точки спавна, спавн для новичков	Для выживания — да
EssentialsXProtect	Базовая защита от гриферства и взрывов	Нет, если стоит WorldGuard
EssentialsXAntiBuild	Запрет строительства без права	По надобности
EssentialsXGeoIP	Определение страны по IP	По надобности
EssentialsXDiscord и DiscordLink	Мост с Discord и привязка аккаунтов	По надобности
EssentialsXXMPP	Устаревший мост с XMPP	Не нужен

Минимум для выживания: ядро, Chat, Spawn. Остальное — по надобности. Protect часто конфликтует с WorldGuard, поэтому если у вас есть WorldGuard, Protect лучше не ставить — про регионы есть отдельный материал.

Установка EssentialsX: порядок действий

Откройте Файлы → папка plugins
Загрузите выбранные .jar (все из одного релиза, разные версии между собой не дружат)
Перезапустите сервер полностью

Через SFTP путь тот же — инструкция по подключению. Общий порядок работы с плагинами описан в разделе про установку плагинов.

После рестарта появится папка plugins/Essentials с config.yml, worth.yml, kits.yml и остальными файлами.

Проверка:

код

/ess version

Что править в config.yml первым делом

Файл большой, но реально важных пунктов в нём немного.

Дома. Лимиты задаются правами, а не числом в конфиге:

yaml

sethome-multiple:
  default: 1
  vip: 3
  premium: 5

Дальше игрок с правом essentials.sethome.multiple.vip получает три дома. Как выдавать такие права — в разделе про установку LuckPerms.

Телепорты. Задержка и остывание нужны, чтобы /tpa не превращался в способ сбежать из боя:

yaml

teleport-cooldown: 10
teleport-delay: 3
teleport-invulnerability: 4
teleport-safety: true

teleport-delay: 3 означает, что телепорт сработает через три секунды и отменится при движении.

Экономика:

yaml

starting-balance: 100
currency-symbol: '$'
min-money: 0

Стартовый баланс лучше держать маленьким — иначе новые аккаунты станут источником инфляции. Как строить экономику целиком, разбирал материал про настройку экономики на сервере.

Спам-защита команд:

yaml

command-cooldowns:
  home: 5
  spawn: 10
  tpa: 15

Отключение лишних команд. EssentialsX перехватывает много имён, и часть из них нужна другим плагинам:

yaml

disabled-commands:
  - hat
  - nuke
  - god

Конфликты команд

Самая частая проблема после установки. EssentialsX регистрирует /home, /warp, /tp, /msg, и эти же имена хотят другие плагины.

Решение — префикс:

код

/essentials:home
/otherplugin:home

Постоянный приоритет задаётся в commands.yml в корне сервера:

yaml

aliases:
  home:
  - essentials:home
  tp:
  - essentials:tp

После правки нужен рестарт. Если команда упорно вызывает не тот плагин, смотрите в plugin.yml конфликтующего плагина, какие имена он занимает.

Киты

Файл plugins/Essentials/kits.yml:

yaml

kits:
  starter:
    delay: -1
    items:
      - stone_sword 1
      - stone_pickaxe 1
      - bread 16
      - oak_log 32
  daily:
    delay: 86400
    items:
      - iron_ingot 8
      - golden_apple 2
      - cooked_beef 16
  vip:
    delay: 43200
    items:
      - diamond_sword 1 sharpness:2 unbreaking:2
      - diamond 4

delay: -1 — кит выдаётся один раз навсегда, число — интервал в секундах. Право на кит: essentials.kit.starter.

Автовыдача стартового кита новичкам настраивается в config.yml:

yaml

newbies:
  announce-format: '&7Добро пожаловать, {DISPLAYNAME}!'
  kit: starter
  spawnpoint: newbies

Варпы и спавн

код

/setspawn
/setwarp shop
/warp shop
/delwarp shop

Права на конкретный варп: essentials.warp.shop или essentials.warps.* на все. Случайный телепорт в свежих версиях EssentialsX есть (/tpr, настройки в tpr.yml), а сравнение с отдельными RTP-плагинами — в статье про RTP и варпы.

Модуль Spawn добавляет spawn-on-join — принудительный телепорт на спавн при каждом входе:

yaml

spawn-on-join: false

Включать стоит только на серверах мини-игр, на выживании это раздражает.

Чат и префиксы

EssentialsXChat берёт префикс из LuckPerms и подставляет в формат:

yaml

chat:
  radius: 0
  format: '{PREFIX}&f{DISPLAYNAME}&7: &f{MESSAGE}'
  group-formats:
    admin: '&c[Админ] &f{DISPLAYNAME}&7: &c{MESSAGE}'

radius: 0 — общий чат на весь сервер. Значение больше нуля включает локальный чат в радиусе блоков, а /shout (или !сообщение) отправляет глобально.

Сами префиксы задаются командами LuckPerms — синтаксис в справочнике команд.

Права: минимальный набор

Для группы default:

код

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.kit true
/lp group default permission set essentials.kit.starter true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true

Что нельзя выдавать обычным игрокам ни при каких условиях:

essentials.gamemode — креатив каждому
essentials.give и essentials.item — выдача любых предметов
essentials.tp (без a) — телепорт к любому игроку без спроса
essentials.god — бессмертие
essentials.enchant — зачарование без опыта
essentials.* — всё сразу

Права на essentials.fly обычно уходят донат-группам, но помните: летающий игрок видит и находит базы, что ломает PvP-выживание.

Экономика и Vault

Для работы магазинов и других экономических плагинов нужен Vault — прослойка между плагинами. Ставится как обычный .jar в plugins. Без него магазины не увидят баланс EssentialsX.

Проверка связки:

код

/vault-info

В выводе должно быть Economy: Essentials Economy.

Типичные проблемы

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

/home телепортирует не туда. Конфликт с другим плагином домов. Разводите через commands.yml.

Префиксы не показываются в чате. Не установлен EssentialsXChat либо формат чата перехватывает другой плагин.

Игроки телепортируются в бою. Не выставлены teleport-delay и остывание.

После рестарта пропали дома и балансы. Данные лежат в plugins/Essentials/userdata. Если папка пуста — сервер не успел сохранить перед аварийным завершением. Регулярные бэкапы решают проблему; схема — в статье про бэкапы игрового сервера.

Ошибка в логе про несовместимую версию. EssentialsX жёстко привязан к версии игры. При обновлении сервера обновляйте и плагин; порядок смены версии — в разделе про смену версии и ядра.

Подборка того, что имеет смысл поставить рядом с EssentialsX, есть в статье про лучшие плагины Minecraft.

Если для стартового набора плагинов нужен тариф с запасом по памяти — варианты на странице цен.