EssentialsX — повседневный плагин для серверов Paper и Spigot: дома, варпы, точка спавна, запросы телепорта между игроками, киты и приветствие при входе. Почти каждый survival-сервер использует его, потому что он объединяет команды, которые игроки ожидают как само собой разумеющееся. В этом гайде настраиваются базовые функции и показано, какие права для них выдавать. Скриншоты сделаны на тестовом сервере с Paper 1.21.4 и EssentialsX 2.21.0.

Установка и первый вход

В панели ты найдешь EssentialsX в разделе Plugins → Browser. Достаточно основного модуля EssentialsX; дополнительные модули вроде EssentialsX Chat или EssentialsX Spawn устанавливай только тогда, когда тебе нужны их функции. После перезапуска EssentialsX приветствует каждого игрока сообщением, количеством игроков онлайн и временем игры.

Сообщение о входе от EssentialsX с Hinweis на более новую версию
Сообщение о входе от EssentialsX с Hinweis на более новую версию

Красное уведомление на изображении — встроенная проверка обновлений: она сообщает операторам, когда доступна более новая версия. Обновление выполняется через браузер плагинов в панели, а не по ссылке. Если сообщение не нужно, установи в plugins/Essentials/config.yml значение update-check: false.

Спавн, дома и варпы

Три команды, которыми игроки пользуются чаще всего:

/setspawn
/sethome
/home
/setwarp рынок
/warp рынок

/setspawn задает точку, где появляются новые игроки и куда ведет /spawn. /sethome сохраняет текущую позицию как дом игрока; /home возвращает его туда. Варпы — это публичные точки, которые администратор создает через /setwarp, а любой игрок достигает через /warp.

Возвращение через /home в деревню: игрок снова стоит перед своим домом
Возвращение через /home в деревню: игрок снова стоит перед своим домом

Несколько домов на игрока настраиваются через права: тот, у кого есть essentials.sethome.multiple.vip, получает столько домов, сколько указано в config.yml в разделе sethome-multiple для vip. Без этих узлов остается один дом.

Права для стандартной группы

Без плагина прав EssentialsX дает всем игрокам большинство команд. Как только запущен LuckPerms, действует только то, что ты разрешил. Разумный набор для группы default:

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.home 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.back true

/tpa отправляет запрос на телепорт, /tpaccept принимает его; /back после смерти возвращает к точке смерти. Команды вроде /gamemode, /give, /kick и /ban остаются за группой модерации. Как создавать группы, описано в LuckPerms: настройка прав.

Киты и приветствие

Стартовый кит дает новым игрокам инструменты на первое время. Киты находятся в plugins/Essentials/config.yml в разделе kits; запись указывает предметы и кулдаун в секундах. Для команды /kit starter нужно право essentials.kits.starter. Приветствие и сообщение дня находятся в том же файле в разделах newbies и motd; цвета задаются &-кодами. После изменений конфигурации /essentials reload загружает их без перезапуска.

Где находятся данные игроков

EssentialsX хранит данные не в папке мира, а в собственной директории плагина. Это важно знать, если ты меняешь мир или переезжаешь на другой сервер:

  • plugins/Essentials/userdata/ — по одному файлу на игрока с домами, последней позицией, временем игры и никнеймами, названному по его UUID.
  • plugins/Essentials/warps/ — отдельный файл для каждого варпа.
  • plugins/Essentials/config.yml — киты, приветствие, задержка телепорта и все остальные настройки.

Новый мир не затрагивает дома и варпы, но их координаты после этого будут вести в пустоту и их придется задать заново. При переезде сервера забери с собой всю папку plugins/Essentials/, тогда дома и варпы сохранятся.

Типичные ошибки

  • /home не работает. Игрок не задал дом или отсутствует право essentials.home.
  • Телепорт прерывается. Настройка teleport-delay ждет несколько секунд и отменяет телепорт при движении. Уменьши значение в config.yml или выдай право essentials.teleport.timer.bypass.
  • Варпы исчезли. Варпы лежат как файлы в plugins/Essentials/warps/. Бэкап панели сохраняет их; новая папка мира этого не меняет.
  • Дублирующиеся команды. Другие плагины дают собственные команды /spawn или /home. В config.yml в разделе overridden-commands задается, какой плагин побеждает.

FAQ

Нужны ли мне все модули EssentialsX?

Нет. Основной модуль EssentialsX уже включает дома, варпы, телепорт и киты. Дополнительные модули устанавливай только ради их конкретной функции: EssentialsX Chat для префиксов в чате, EssentialsX Spawn для отдельных правил спавна при первом входе и смерти.

Почему команды после установки LuckPerms больше не работают?

Без плагина прав EssentialsX свободно разрешает большинство команд. Как только запускается LuckPerms, действует только то, что явно разрешено. Один раз аккуратно задай узлы для группы default — после этого поведение будет предсказуемым, а ты сам решишь, кто может использовать /tpa или /back.

Как игроку получить несколько домов?

Через две связанные настройки: в config.yml в разделе sethome-multiple ты задаешь, сколько домов разрешает уровень, а в LuckPerms выдаешь подходящий узел, например essentials.sethome.multiple.vip. Без этого узла остается один дом на игрока.

Нужно ли перезапускать сервер после изменения config.yml?

Для большинства значений достаточно /essentials reload, например для китов, приветствия или задержки телепорта. Новый установленный дополнительный модуль и изменения, которые затрагивают другие плагины, требуют полного перезапуска сервера.

Входят ли дома и варпы в бэкап панели?

Да, бэкап сохраняет всю директорию сервера, а значит и plugins/Essentials/. Замена мира не удаляет дома и варпы, но их координаты после этого могут не соответствовать ландшафту и их придется задать заново.

Дополнительные гайды

Области, которые игроки не должны менять, защищает WorldGuard: защита регионов. Если сервер лагает даже при малом количестве игроков, поможет spark: анализ лагов.

Источники

EssentialsX: посмотреть пример

Собственные записи из демо-среды. Показанные версия и настройки могут отличаться от твоего сервера.

Точка дома atelier сохранена.
Точка дома atelier сохранена.

2.21.0