EssentialsX: полный гайд по настройке Minecraft сервера в 2026

Если ты ставишь Paper или Spigot и хочешь чтобы у игроков работали /home, /sethome, /spawn, варпы, личка и экономика, то без EssentialsX не обойтись. Это базовый плагин, который закрывает 80% потребностей обычного выживалки или мини-игрового сервера. Разберём установку, модули, конфиг, права и тонкие места, где админы стабильно ломают экономику или ловят лаги.

Что такое EssentialsX и почему именно он

EssentialsX - это форк старого Essentials, который заброшен ещё в 2014 году. С тех пор вся разработка идёт в репозитории EssentialsX на GitHub, и плагин до сих пор остаётся самым скачиваемым на SpigotMC: больше 50 миллионов загрузок суммарно.

Поддерживает Paper, Spigot, Purpur и частично Folia. На Folia работает только Core и Spawn в отдельной ветке EssentialsXSpigotFolia, остальные модули пока не переехали из-за региональной модели тиков. Версии Minecraft - от 1.8 до 1.21, ветка для 1.21 стабильна с релиза 2.21.0.

Альтернативы есть: CMI (платный, монолитный), HuskHomes, ChestCommands. Но если нужно поставить и забыть, EssentialsX выигрывает по соотношению функций к нулевой цене.

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

EssentialsX разбит на несколько jar-файлов. Базу скачиваешь обязательно, остальное по нуждам:

• EssentialsX.jar - ядро. Хомы, варпы, телепорты, кит, личка, базовая экономика
• EssentialsXChat.jar - форматирование чата, каналы, локальный чат
• EssentialsXSpawn.jar - кастомный спавн, респавн на спавне для новичков
• EssentialsXAntiBuild.jar - простая защита блоков по правам
• EssentialsXProtect.jar - защита от криперов, поджогов, утечек воды
• EssentialsXGeoIP.jar - определение страны игрока по IP, требует MaxMind базу
• EssentialsXXMPP.jar - редкий модуль, оповещения в Jabber
• EssentialsXDiscord.jar - двусторонний мост чата с Discord
• EssentialsXDiscordLink.jar - линкование аккаунтов и синк ролей с LuckPerms

На практике большинство серверов ставят Core, Chat, Spawn и Discord. Остальные либо избыточны, либо заменяются специализированными плагинами (WorldGuard вместо Protect, DiscordSRV вместо EssentialsXDiscord если нужны эмбеды).

Качай только с официальной страницы релизов GitHub. Левые сборки с YouTube часто содержат обфусцированные бэкдоры.

Установка и зависимости

Закидываешь нужные jar в plugins/, перезапускаешь сервер. EssentialsX сам создаст папку plugins/Essentials/ с config.yml, kits.yml, worth.yml и ещё парой файлов.

Зависимости:

• Vault - нужен если планируешь использовать экономику с другими плагинами (Shop, ChestShop, AuctionHouse). Без Vault EssentialsX Economy работает изолированно
• LuckPerms - не обязателен, но без системы прав ты не разрулишь группы и лимиты хомов. SuperPerms из коробки умеет только базовые operator-права
• PlaceholderAPI - нужен для расширенного форматирования чата через %essentials_*% плейсхолдеры

Порядок загрузки правильный из коробки, EssentialsX в plugin.yml уже указывает softdepend: [Vault, LuckPerms, PlaceholderAPI].

Базовые команды для игроков

Эти ноды раздаются группе default и используются каждый день:

/sethome [name]      # ставит хом, по дефолту максимум 1
/home [name]         # телепорт на хом
/delhome <name>      # удалить хом
/spawn               # на спавн мира
/warp [name]         # на варп если есть права
/tpa <player>        # запрос телепорта к игроку
/tpaccept            # принять запрос
/tpdeny              # отклонить
/back                # вернуться на место смерти или предыдущий тп
/msg <player> <msg>  # личка
/r <message>         # ответ на последнюю личку
/mail send <p> <m>   # офлайн-сообщение
/balance             # баланс
/pay <player> <sum>  # перевод денег
/afk                 # пометить себя AFK

/back после смерти - спорная фича. На анархии её обычно вырубают через essentials.back.ondeath отзыв, чтобы PvP имел вес.

Команды модератора и админа

Минимальный набор для модерации:

/vanish              # невидимка для игроков
/tempban <p> <time>  # временный бан, например 7d или 2h
/mute <p> <time>     # мут с таймером
/jail <p> <jail>     # отправить в джейл-зону
/kick <p> [reason]   # кик
/broadcast <msg>     # сообщение всем
/feed                # покормить
/heal                # восстановить хп
/gamemode <mode>     # сменить режим
/invsee <player>     # посмотреть инвентарь
/seen <player>       # когда последний раз заходил

Джейлы создаются командой /setjail <name> стоя на нужной точке. Игрок в джейле не может ломать блоки, чатиться (зависит от jail-mute-on-jail) и пользоваться командами.

config.yml: ключевые параметры

plugins/Essentials/config.yml - это сердце плагина. Параметры, которые точно нужно проверить и настроить под себя:

# Лимит хомов для группы default
sethome-multiple:
  default: 1
  vip: 3
  vip+: 5
  staff: 10

# Кулдаун между телепортами в секундах
teleport-cooldown: 60

# Задержка перед телепортом, если игрок двинется - отмена
teleport-delay: 3

# Безопасный телепорт: проверяет блок под ногами
teleport-safety: true
force-disable-teleport-safety: false

# Экономика
currency-symbol: '$'
starting-balance: 100
min-money: 0
max-money: 10000000000

# Сколько хранится /seen и логов
last-message-reply-recipient: true
last-message-reply-recipient-timeout: 180

# AFK
auto-afk: 300        # 5 минут до автоAFK
auto-afk-kick: 1800  # кик через 30 минут AFK

# Социалспай: модераторы видят личку игроков
social-spy:
  available-on-vanish: true

Важный момент: sethome-multiple работает только если у игрока есть нода essentials.sethome.multiple.<group>. Просто поменять число в конфиге недостаточно.

Экономика: Vault, /shop, таблички

EssentialsX Economy - это in-memory + файловое хранилище балансов. Для маленького сервера до 200 онлайн норм, для больших нужно смотреть на CoinsEngine или ставить EssentialsX поверх MySQL через сторонние мосты.

Чтобы магазины работали, ставишь Vault, и EssentialsX автоматически зарегистрирует себя как Economy provider. Проверка через /vault-info.

Для магазина на табличках EssentialsX умеет нативно. Создаёшь табличку:

[Buy]
1
64
100

Это значит «купить 1 стак (64 шт) предмета указанного на табличке-индикаторе сверху за 100 монет». Полный список знаков - в signs: секции конфига:

enabled-signs:
  - balance
  - buy
  - sell
  - free
  - disposal
  - heal
  - mail
  - trade
  - warp

Для нормального магазина с GUI лучше ChestShop или DeluxeMenus, таблички больше для ламповости.

Киты: kits.yml

Файл plugins/Essentials/kits.yml хранит наборы предметов. Пример кита для новичка:

kits:
  starter:
    delay: -1
    items:
      - bread 16
      - wooden_sword
      - wooden_pickaxe
      - wooden_axe
      - leather_helmet
      - leather_chestplate
      - leather_leggings
      - leather_boots
      - torch 32
  daily:
    delay: 86400
    items:
      - cooked_beef 32
      - iron_pickaxe unbreaking:1
      - golden_apple 4

delay: -1 значит «выдать один раз навсегда», 86400 - раз в сутки в секундах. Игрок берёт кит командой /kit starter, права - essentials.kits.starter.

Для зачарований используется синтаксис material enchantment:level, например diamond_sword sharpness:5 unbreaking:3. Полный список enchantment-имён - в Bukkit API.

Спавн и варпы

Ставишь спавн так:

/setspawn          # по дефолту для всех групп
/setspawn default  # явно для группы default

Можно настроить разные спавны для разных групп через respawn-listener-priority и группы прав. Для новичков обычно делают отдельный туториал-мир.

Варпы:

/setwarp shop      # создать
/warp shop         # телепорт
/delwarp shop      # удалить
/warps             # список доступных

Каждый варп требует права essentials.warp.warps.<name> или общую essentials.warp.*. Если у тебя 50 варпов и ты не хочешь раздавать каждый отдельно - ставишь essentials.warps.* всем.

AntiBuild и Protect: когда не использовать

EssentialsX AntiBuild - простая защита блоков по правам. Работает, но негибкая: ты не можешь разрешить ставить блоки только в одном регионе. Для серьёзной защиты спавна и областей ставишь WorldGuard, и AntiBuild не включаешь.

EssentialsX Protect - защита от криперов и физики. Тоже базовая. Если у тебя выживалка с PvE-зонами, опять же лучше WorldGuard с флагами creeper-explosion deny.

Простое правило: используй EssentialsX Core + Spawn + Chat + Economy, остальные модули включай только если знаешь что они тебе нужны.

Чат и PlaceholderAPI

EssentialsXChat поддерживает форматирование через chatformat в конфиге. Базовый пример с группами:

chat:
  format: '{DISPLAYNAME}&7: &f{MESSAGE}'
  group-formats:
    default: '&7[Игрок] {DISPLAYNAME}&7: &f{MESSAGE}'
    vip: '&6[VIP] {DISPLAYNAME}&7: &f{MESSAGE}'
    staff: '&c[Staff] {DISPLAYNAME}&7: &f{MESSAGE}'
  radius: 0

radius: 0 - глобальный чат, любое число больше 0 - локальный чат в радиусе блоков.

С PlaceholderAPI можно вкорячить префикс из LuckPerms напрямую:

format: '%luckperms_prefix% {DISPLAYNAME}&7: &f{MESSAGE}'

Не забудь подключить параметр EssentialsChat.placeholders: true через PlaceholderAPI hook, иначе плейсхолдеры не парсятся.

Производительность на больших серверах

На сервере с 500+ онлайн EssentialsX может стать узким местом. Что отключить:

• GeoIP - выгружает базу в память и делает lookup на каждый join. Если не показываешь страну в чате - выключи
• /seen хранилище - last-seen пишется в userdata на каждый дисконнект. На больших серверах включай last-seen-write: false
• AFK auto-kick - проходит по всем игрокам каждый тик. Поставь auto-afk-kick: -1 если кика не нужно
• TPS-зависимые тикеры - в EssentialsX есть периодические задачи на сохранение userdata. Кручу userdata-saving-interval от 60 до 300 секунд

Userdata лежит в plugins/Essentials/userdata/ как .yml на каждого игрока. На больших серверах это десятки тысяч файлов, и очистка через /baltop или /seen сканит все. Решение - перевести на MySQL через сторонний мост или регулярно чистить старые userdata через скрипт.

Права через LuckPerms: что выдавать

Минимальный набор для группы default:

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.sethome.multiple.default true
lp group default permission set essentials.delhome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.warp true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.tpdeny true
lp group default permission set essentials.msg true
lp group default permission set essentials.mail true
lp group default permission set essentials.balance true
lp group default permission set essentials.pay true
lp group default permission set essentials.kits.starter true
lp group default permission set essentials.afk true
lp group default permission set essentials.back true

Для VIP добавляешь essentials.sethome.multiple.vip и в конфиге пишешь сколько хомов. Для модераторов - essentials.vanish, essentials.kick, essentials.mute, essentials.tempban, essentials.broadcast, essentials.invsee, essentials.seen.

Опасные ноды, которые НИКОГДА не выдаёшь обычным игрокам: essentials.god, essentials.fly, essentials.gamemode, essentials.give, essentials.eco (это про управление экономикой сервера).

FAQ

EssentialsX работает на Folia?

Частично. Есть отдельная ветка EssentialsXSpigotFolia, в ней работают Core и Spawn. Большая часть остальных модулей не переписана под региональную модель тиков Folia. Если ставишь Folia, заранее знай что часть фич придётся заменить.

Как сделать чтобы /home работал только в overworld?

Через права и Multiverse. Выдаёшь essentials.home.bed только в нужном мире через LuckPerms-контексты: lp group default permission set essentials.home true world=world. В других мирах команда не сработает. Альтернатива - параметр world-teleport-permissions: true в конфиге.

Зачем мне Vault если EssentialsX уже даёт экономику?

Vault это API-мост между плагинами. EssentialsX Economy сама по себе работает только внутри EssentialsX команд (/balance, /pay). Все сторонние магазины, аукционы, плагины с покупками работают через Vault API. Без Vault они не увидят балансы EssentialsX.

Можно ли увеличить количество хомов выше 3?

Да, через essentials.sethome.multiple.<group> и секцию sethome-multiple в конфиге. Создаёшь группу например vip+ с 10 хомами в конфиге и выдаёшь ноду через LuckPerms. Чисто технических ограничений нет, упирается только в производительность файловой системы.

Как защитить /spawn от грифа?

Через WorldGuard, не через AntiBuild. Создаёшь регион вокруг спавна командой //wand + /region define spawn, потом /region flag spawn build deny и /region flag spawn pvp deny. AntiBuild от EssentialsX слишком прямолинеен и не разрешит частичные исключения.

Как сбросить хомы у всех игроков?

Прямого способа нет, но можно удалить секцию homes: в каждом userdata-файле через скрипт, или сбросить конкретного игрока командой /delhome <player>:<name> от консоли. На больших серверах проще написать bash-скрипт с yq или sed по plugins/Essentials/userdata/.

Конфликтует ли EssentialsX с другими плагинами хомов и варпов?

Да, если стоит ещё HuskHomes или CMI. Команды /home, /warp, /tpa будут пересекаться, и Bukkit отдаст команду тому плагину, который зарегистрировал её первым. Решение - убрать дубликаты в commands.yml или отключить лишний модуль через disabled-commands в конфиге EssentialsX.

Что дальше

EssentialsX закрывает базу, но не более того. Для серьёзного сервера сразу планируй стек: WorldGuard для регионов, LuckPerms для прав, PlaceholderAPI для интеграций, и что-то под инвентари (ChestShop или DeluxeMenus). Конфиги держи в git, бэкапы userdata делай раз в сутки, и не забудь прикрыть сервер от DDoS - один SYN-флуд и все твои настройки останутся без игроков.