EssentialsX: команды, киты, варпы и экономика

Essentials или EssentialsX: что скачать

Оригинальный Essentials давно не обновляется и на современных ядрах не работает. EssentialsX продолжает его код: команды и файлы те же, jar ставится вместо старого, данные игроков обновляются автоматически. По запросу «плагин Essentials» сегодня нужно качать именно EssentialsX.

Стабильные релизы лежат на SpigotMC и Modrinth, свежие dev-сборки на essentialsx.net. Официально поддерживается последний патч каждой ветки Minecraft: 1.16.5, 1.20.6, 1.21.11 и так далее. Релиз 2.22.0 рассчитан на 1.21.11 и 26.1.2, поддержка 26.2 и 26.3 пока есть только в dev-сборках. Для промежуточных патчей 1.21 выбирайте релиз, в описании которого указана ваша версия.

Установка и модули

1. Скачайте основной jar EssentialsX, он обязателен. С SpigotMC приходит архив, его надо распаковать.
2. Добавьте нужные модули: EssentialsX Chat (формат чата, префиксы), EssentialsX Spawn (/spawn, точка появления новичков), EssentialsX Protect (запрет огня, взрывов криперов), EssentialsX AntiBuild (запрет строить по правам), GeoIP, Discord и Discord Link.
3. Поставьте Vault и плагин прав, разработчики рекомендуют LuckPerms. Без Vault не будут работать префиксы и группы.
4. Перезапустите сервер, в plugins/Essentials появятся config.yml и kits.yml.

Язык сообщений меняется в config.yml, русский перевод в комплекте:

locale: ru
per-player-locale: false

С per-player-locale: true каждый игрок видит сообщения на языке своего клиента.

Киты: /kit и /createkit

Самый быстрый способ: положите вещи в инвентарь и выполните /createkit start -1. Второй аргумент это задержка в секундах, -1 делает кит одноразовым. Вручную киты описываются в kits.yml:

kits:
  start:
    delay: -1
    items:
      - stonesword 1
      - stonepickaxe 1
      - stoneaxe 1
      - /broadcast {USERNAME} получил стартовый набор

Имена китов пишутся строчными буквами. Игроку нужны права essentials.kit и essentials.kits.start (или essentials.kits.* на все киты). Проверить содержимое можно через /showkit start, сбросить откат через /kitreset start <игрок>.

Варпы, дома и спавн

Варп создаётся командой /setwarp shop на месте админа, игроки идут туда через /warp shop. Чтобы закрыть отдельные варпы правами, включите в config.yml per-warp-permission: true и выдавайте essentials.warps.shop.

Дома: /sethome и /home. Несколько домов требуют двух прав сразу: essentials.sethome.multiple и essentials.sethome.multiple.vip, где vip это ранг из config.yml:

sethome-multiple:
  default: 3
  vip: 5
  staff: 10

Без лимита: essentials.sethome.multiple.unlimited.

/spawn и /setspawn есть только в модуле EssentialsX Spawn. /setspawn ставит общий спавн, /setspawn <группа> отдельный для группы. Чтобы всех при входе кидало на спавн, поставьте spawn-on-join: true.

Экономика EssentialsX

Экономика встроена: /balance, /pay, /baltop, продажа через /sell по ценам из worth.yml. Админ управляет деньгами командой /eco give|take|set|reset <игрок> <сумма>. Основные настройки в config.yml:

starting-balance: 0
currency-symbol: '$'
currency-symbol-suffix: false
minimum-pay-amount: 0.001

Чтобы магазины, работы и другие плагины видели эти деньги, нужен Vault.

Чат, префиксы и типовые проблемы

Формат чата задаёт модуль EssentialsX Chat в секции chat config.yml:

chat:
  format: '&7{PREFIX}&r {NICKNAME}&r &7{SUFFIX}&r: {MESSAGE}'

{DISPLAYNAME} уже содержит префикс и суффикс, вместе с {PREFIX} он даст двойной префикс. Префиксы берутся из плагина прав через Vault.

• /ess version показывает версию, найден ли Vault и какой плагин прав используется. Если в ответе только «Reloaded Essentials», стоит старый Essentials.
• Команду перехватил другой плагин: впишите её в overridden-commands config.yml или сделайте алиас на essentials:msg в commands.yml сервера.
• Таблички не работают: раскомментируйте нужные типы в enabledSigns.
• GroupManager не поддерживается, переходите на LuckPerms.