Vault и экономика на Minecraft-сервере: как всё связать

Магазин, работы, аукцион и кланы на сервере Minecraft живут на одной валюте. Каждый из этих плагинов должен знать, сколько денег у игрока и как их списать. Чтобы они не писали собственные хранилища, появился Vault: это не экономика, а общий интерфейс. Деньги хранит другой плагин (провайдер), а Vault передаёт ему запросы от остальных плагинов.

Разберём схему, установку на Paper 1.21.1, команды баланса и перевода, выдачу денег администратором и ошибки, которые встречаются при связке плагинов.

Коротко

Чтобы работала экономика на Paper 1.21.1, установите EssentialsX (он хранит деньги), затем Vault, если нужен магазин или другой плагин, который его просит. Игроки проверяют баланс командой /balance, переводят через /pay <ник> <сумма>, а админ выдаёт монеты через /eco give <ник> <сумма>. Ошибка «No economy provider» значит, что провайдера нет.

Как устроена связка

Схема из трёх частей:

• Провайдер хранит баланс и умеет списывать и начислять. Например, EssentialsX.
• Vault — общий интерфейс: провайдер регистрируется в нём при старте, а Vault отдаёт его другим плагинам.
• Потребитель — магазин, аукцион или работа — просит у Vault баланс и не знает, какой плагин за ним стоит.

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

Шаги

1. Установите EssentialsX

В панели откройте «Моды и плагины» → «Каталог», выберите «Paper — плагины» и версию 1.21.1, найдите EssentialsX, установите и перезапустите сервер. Экономика EssentialsX работает сразу после запуска, отдельно включать её не нужно.

Подробно о самом EssentialsX, спавне, домах и китах — в статье EssentialsX: команды, дома и киты.

2. Установите Vault

Оригинальный Vault выпускается на SpigotMC и Hangar, а в Modrinth (откуда берёт плагины каталог панели) по слову «Vault» находится совместимая замена VaultUnlocked: форк, который подключается к плагинам как обычный Vault. Установите её из каталога. Если вам нужен именно оригинальный Vault, скачайте jar на его странице и положите в папку plugins через «Файлы». Vault — библиотека, поэтому после установки в консоли должна появиться строка о том, что он включён.

Порядок имеет значение. Сначала провайдер (EssentialsX), затем Vault и потребители. Если поменяете порядок, Vault всё равно подхватит провайдера при старте, но в логах могут быть предупреждения о зависимостях.

3. Проверьте баланс и перевод

Зайдите в игру обычным игроком и выполните:

/balance
/pay Alex_EGN 50

Первая команда показывает баланс. Вторая переводит 50 монет игроку Alex_EGN. Сумма списывается у отправителя, если у него достаточно средств. Проверьте обе стороны: у получателя баланс должен вырасти, у отправителя — уменьшиться.

Сумма стартового баланса для новых игроков задаётся в plugins/Essentials/config.yml параметром starting-balance. Значение меняется в файле, после правки выполните /ess reload или перезапустите сервер. Проверьте имя параметра в вашей версии файла: при первом запуске он уже есть в конфиге.

4. Выдайте деньги администратору

Для ручных выдач используйте /eco, команду для администраторов:

/eco give Alex_EGN 500
/eco take Alex_EGN 100
/eco set Alex_EGN 0
/eco reset Alex_EGN

• give — начислить сумму;
• take — списать;
• set — установить точный баланс;
• reset — вернуть стартовое значение.

Эти команды лучше выполнять из консоли или с аккаунта модератора, а права на /eco выдавать только тем, кому доверяете. Иначе игрок с правом на /eco сможет нарисовать себе любую сумму.

5. Ограничьте права через LuckPerms

Минимальный набор для обычного игрока: essentials.balance и essentials.pay. Команды /eco у игроков быть не должно. Пример из «Консоли» через LuckPerms:

lp group default permission set essentials.balance true
lp group default permission set essentials.pay true
lp group admin permission set essentials.eco true

Названия прав сверяйте с документацией EssentialsX (essentialsx.net), а после выдачи проверьте конкретного игрока: lp user Alex_EGN permission check essentials.eco. Подробнее про группы — в статье LuckPerms.

6. Подключите магазин

У большинства магазинов в настройках указан провайдер или режим «Vault». Выберите его и перезапустите магазин или сервер. Если магазин предлагает выбрать валюту, укажите ту же, что в EssentialsX.

Проверка простая: поставьте магазин, выставите товар за 10 монет, купите его у себя аккаунтом с балансом 100 и посмотрите, что сумма списалась. Это делается в тестовом мире, а не на живом сервере.

Как сделать в панели EGN

1. «Моды и плагины» → «Каталог» — установите EssentialsX, затем VaultUnlocked (или оригинальный Vault вручную) и магазин.
2. «Моды и плагины» → «Установлено» — здесь видно, какие плагины включены и не конфликтуют. Если у потребителя указана ошибка версии, сверьте её с версией ядра.
3. «Файлы» → plugins/Essentials/config.yml — правьте стартовый баланс (параметр starting-balance). Редактор проверяет YAML и предупредит об ошибке в отступах до сохранения.
4. «Консоль» — выполняйте /eco здесь: консоль всегда имеет право на эту команду.
5. «Бэкапы» — перед массовыми выдачами или сбросом балансов сделайте снимок. База EssentialsX хранится в папке plugins/Essentials/ и откатывается вместе с файлами.

Частые ошибки

Самая частая проблема — два экономических плагина сразу. Они ставят разные балансы, а игроки пишут в поддержку, что деньги пропадают. Если хотите сменить провайдера, сначала переведите балансы вручную, иначе старые суммы останутся в прежней базе.

Пример: магазин на сервере с нуля

Допустим, вы хотите продавать алмазы за монеты. Последовательность такая.

1. Убедитесь, что EssentialsX работает: /balance показывает баланс тестового аккаунта.
2. Установите Vault (или VaultUnlocked) и магазин, который его поддерживает. В настройках магазина выберите провайдером Vault, а валюту оставьте стандартной.
3. Задайте цену: например, 10 монет за алмаз. Цена хранится в конфиге магазина, а не в EssentialsX.
4. Выдайте тестовому аккаунту монеты командой /eco give <тест-ник> 100.
5. Купите алмаз и проверьте: баланс должен уменьшиться на 10, предмет появиться в инвентаре.
6. Проверьте продажу: продайте предмет и убедитесь, что деньги вернулись.

Если хотя бы один шаг не сходится, сначала посмотрите логи старта: чаще всего это отсутствие провайдера или неверное имя валюты.

Как сменить провайдера экономики

Смена провайдера — редкая, но неприятная операция. Порядок такой: остановите сервер, сделайте снимок в «Бэкапах», выпишите текущие балансы через /balance у активных игроков или из папки plugins/Essentials/userdata/, поставьте новый провайдер и перенесите суммы командами /eco set. Только после этого удаляйте старый плагин. Если пропустить перенос, игроки потеряют деньги, и восстановить их будет сложно.

Таблица «симптом → причина → решение»

Итог

Vault сам по себе ничего не хранит. Он нужен, чтобы магазины, работы и аукционы работали с одним провайдером экономики. Для большинства серверов провайдером служит EssentialsX: он даёт балансы, переводы и команды /eco. Настройте права так, чтобы игроки видели баланс и переводили деньги, а выдавали их только админы. Тогда ошибок с деньгами будет мало, а поддержка получит меньше обращений.

Если вы ещё выбираете, какой плагин ставить первым, посмотрите список плагинов для выживания. Перед крупными изменениями экономики сделайте бэкап, а кражи и взломы сундуков помогает расследовать CoreProtect.

Вопросы и ответы

Нужен ли Vault, если на сервере только EssentialsX?

Для команд EssentialsX — нет, у него своя экономика. Vault нужен, когда вы ставите плагины (магазины, работы, аукцион), которые работают с деньгами через общий интерфейс. На Modrinth его роль выполняет форк VaultUnlocked.

Можно ли держать две экономики на одном сервере?

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

Как проверить, что Vault видит провайдера?

В логах старта не должно быть ошибок о провайдере. Если потребитель работает и показывает баланс, связка рабочая. Окончательная проверка — покупка или перевод.

Почему /eco не работает у модератора?

Не выдано право essentials.eco в группе. Проверьте через lp user <ник> permission check essentials.eco и выдайте право группе модераторов.

Сервер под Minecraft за пару минут — egnetwork.ru