Установка Vault и плагина экономики

Vault — плагин экономики только наполовину. Своих денег у него нет: это прослойка, через которую магазины, аукционы и джобы разговаривают с тем плагином, где деньги реально хранятся. Ставите Vault + EssentialsX — и десяток других плагинов внезапно узнают, сколько монет у игрока, не зная про EssentialsX ничего.

Без этой связки вы получите в консоли [Shop] No economy plugin found и неработающий магазин, даже если баланс в игре показывается нормально.

Vault, плагин экономики и потребители: как устроена связка

Схема из трёх слоёв:

1. Провайдер экономики — хранит балансы. EssentialsX Economy, CMI, XConomy.
2. Vault — общий интерфейс. Сам ничего не хранит.
3. Потребители — ChestShop, Jobs Reborn, ShopGUIPlus, AuctionHouse, PlaceholderAPI и прочие.

Провайдер должен быть ровно один. Два плагина экономики одновременно — это разъезжающиеся балансы: игрок покупает за деньги из EssentialsX, а зарабатывает в XConomy.

Тот же Vault обслуживает права и чаты — поэтому он же нужен плагинам, которые показывают префикс группы из LuckPerms.

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

Порядок стандартный, разница только в том, что файлов сразу несколько:

1. Скачайте Vault.jar со SpigotMC (актуальная ветка 1.7.x, обновляется редко — это нормально, плагин стабилен годами). Исходники и описание — в репозитории Vault на GitHub.
2. Скачайте провайдера. Проще всего EssentialsX: нужен EssentialsX.jar, экономика в нём уже внутри.
3. Остановите сервер, положите оба файла в plugins.
4. Запустите и проверьте консоль.

В логе ищите строку вида:

[Vault] Enabled Version 1.7.3-b131
[Vault] [Economy] Essentials Economy found: Loading

Вторая строка — главная. Если её нет, Vault не увидел провайдера. Проверка изнутри игры:

/vault-info

Команда покажет, какой плагин зарегистрирован как Economy, Permissions и Chat. Если напротив Economy пусто — дальше можно не настраивать, сначала чините это.

Механику загрузки .jar и рестарта смотрите в общей статье про установку плагинов, а конкретно по EssentialsX есть отдельная инструкция.

Базовая настройка денег

В EssentialsX за экономику отвечает plugins/Essentials/config.yml. Ключевые параметры:

starting-balance: 500
currency-symbol: '$'
min-money: -10000
max-money: 10000000000000

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

min-money можно поставить в 0, если не хотите отрицательных балансов.

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

Команды для проверки:

/bal
/bal Steve
/pay Steve 100
/eco give Steve 1000
/eco take Steve 500
/eco set Steve 0
/balancetop

Права на выдачу денег (essentials.eco) держите только у администрации — это буквально печатный станок.

Куда девать деньги

Экономика без источников дохода и трат мертвеет за неделю. Минимальный набор:

• Заработок. Jobs Reborn — оплата за рубку, копку, фермерство. Или квесты, или продажа ресурсов админ-шопу.
• Траты. ChestShop для торговли между игроками, ShopGUIPlus для админ-магазина, платные /home и варпы.
• Сток денег. Налоги, платные приваты, аукцион с комиссией. Без стока инфляция за месяц превращает алмаз в мусор.

Классическая ошибка новых серверов — админ-шоп, который покупает ресурсы дороже, чем продаёт похожий предмет. Игроки находят такой цикл за сутки и печатают миллионы. Проверяйте цены на замкнутые схемы: булыжник → продажа → покупка стака → крафт → продажа.

Более подробный разбор баланса есть в статье как настроить экономику на сервере.

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

No economy plugin found при живой экономике. Vault загрузился раньше провайдера или провайдер отвалился с ошибкой. Смотрите лог целиком, не только последние строки.

Балансы обнулились после смены плагина. Данные EssentialsX лежат в plugins/Essentials/userdata/<uuid>.yml, у CMI — в своей базе. Прямого переноса между ними нет, нужен конвертер или ручной экспорт. Перед любой сменой провайдера делайте бэкап.

Два провайдера сразу. В /vault-info видно, какой выбран. Лишний удаляйте, а не «отключайте в конфиге» — регистрация происходит на старте.

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

Пустой /balancetop. Топ кэшируется, обновляется командой /balancetop force или по таймеру из конфига.

Частые вопросы

Нужен ли Vault, если магазин один?

Почти всегда да: подавляющее большинство магазинных плагинов ищут экономику именно через Vault и без него не запускаются.

Можно ли обойтись без EssentialsX?

Да, провайдером может быть CMI (платный, но заменяет пол-набора плагинов) или лёгкий XConomy с поддержкой MySQL — удобно, когда балансы должны быть общими на нескольких серверах под BungeeCord.

Как перевести экономику на MySQL?

XConomy и CMI умеют из коробки, EssentialsX — нет, там только файлы. Для сетевого проекта берите сразу XConomy.

Коротко

Vault + один провайдер + магазины и источники заработка. Проверка успеха — команда /vault-info с непустой строкой Economy и работающая /pay между двумя аккаунтами. Дальше вся возня уходит в цены и баланс, а не в техническую часть.

Если сервера под всё это ещё нет — тарифы TeaHost.