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

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

- Рубрика: Гайды по играм
- Игра: Minecraft
- Опубликовано: 2026-11-13T18:40:00+03:00
- Обновлено: 2026-11-13T18:40:00+03:00
- Адрес: https://blog.egnetwork.ru/minecraft-vault-ekonomika
- Автор: Команда EGN

Магазин, работы, аукцион и кланы на сервере 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, Vault и магазин](https://blog.egnetwork.ru/media/322)

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

## Шаги

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

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

Подробно о самом EssentialsX, спавне, домах и китах — в статье [EssentialsX: команды, дома и киты](https://blog.egnetwork.ru/minecraft-essentialsx-komandy-i-kity).

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

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

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

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

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

```bash
/balance
/pay Alex_EGN 50
```

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

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

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

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

```bash
/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` сможет нарисовать себе любую сумму.

![Команды экономики EssentialsX: баланс, перевод и выдача администратором](https://blog.egnetwork.ru/media/323)

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

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

```bash
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](https://blog.egnetwork.ru/minecraft-luckperms-prava-i-gruppy).

## 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/` и откатывается вместе с файлами.

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

| Симптом | Причина | Решение |
|---|---|---|
| «No economy provider» в логах магазина | Нет провайдера экономики, EssentialsX не включён | Установите EssentialsX и проверьте его в консоли |
| Баланс в магазине и в `/balance` разный | Два провайдера экономики или магазин читает другой плагин | Оставьте один провайдер, в магазине выберите Vault |
| `/pay` пишет «Недостаточно средств» | Сумма больше баланса или стоит комиссия | Проверьте `/balance` и настройки перевода в конфиге |
| Игрок с правом на `/eco` сам себе начисляет деньги | Право выдано группе `default` или `*` | Уберите право через `permission unset` и оставьте только админам |
| Баланс сбросился у всех | Удалены файлы `plugins/Essentials/` или база повреждена | Восстановите папку из бэкапа, потом проверьте файлы игроков |
| Магазин не видит Vault | Vault не установлен или не загрузился | Проверьте зависимость в карточке плагина и логи старта |

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

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

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

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

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

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

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

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

| Симптом | Причина | Решение |
|---|---|---|
| Магазин показывает цену 0 | Неверно задана валюта или цена в другом формате | Проверьте конфиг магазина и единицу валюты |
| Покупка проходит, деньги не списываются | Магазин работает с другим провайдером | Выберите Vault в настройках магазина |
| Баланс сбрасывается после перезапуска | Файлы экономики не сохранились | Проверьте права на запись в `plugins/Essentials/` и наличие бэкапа |
| `/pay` пишет ошибку про неизвестного игрока | Ник введён с ошибкой или игрок ни разу не заходил | Используйте точный ник из игры |

## Итог

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

Если вы ещё выбираете, какой плагин ставить первым, посмотрите [список плагинов для выживания](https://blog.egnetwork.ru/minecraft-top-15-plaginov-vyzhivanie). Перед крупными изменениями экономики сделайте [бэкап](https://blog.egnetwork.ru/minecraft-bekapy-i-vosstanovlenie), а кражи и взломы сундуков помогает расследовать [CoreProtect](https://blog.egnetwork.ru/minecraft-coreprotect-otkat-grifa).

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

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

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

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

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

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

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

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

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

Сервер под Minecraft за пару минут — [egnetwork.ru](https://egnetwork.ru/)

---

Материал EGN (blog.egnetwork.ru), обновлено 13 ноября 2026; при цитировании указывайте ссылку.