Vault и VaultUnlocked: что скачать для 1.21 и как проверить

Vault или VaultUnlocked: что ставить на 1.21 и 26.x

Оригинальный Vault от MilkBowl последний раз выходил 17 июля 2020 года: это Vault 1.7.3. Поддержку 1.20.5, 1.21 и более новых версий авторы нигде не заявляли, новых релизов нет.

VaultUnlocked от TheNewEconomy это форк, который продолжают выпускать. Версия 2.20.3 от 16 сентября 2026 года добавила поддержку 26.3. В plugin.yml он называется Vault, поэтому плагины, которые требуют Vault, видят его как обычный Vault, а старые плагины экономики и прав работают через тот же API.

Оба плагина регистрируются под именем Vault. В папке plugins должен лежать только один из них.

Зачем нужен Vault и что без него не работает

Vault работает посредником. Плагин экономики регистрирует в нём счета игроков, плагин прав регистрирует группы, префиксы и суффиксы. Магазины, аукционы, меню и чат-плагины обращаются к Vault и не зависят от того, какая именно экономика стоит на сервере.

• EssentialsX без Vault не показывает префиксы, суффиксы и не определяет группы, так написано в его инструкции по установке;
• LuckPerms на Bukkit, Spigot и Paper отдаёт префиксы чат-плагинам только через Vault;
• плейсхолдеры баланса и группы в PlaceholderAPI берутся из расширения Vault.

Сам Vault ничего не хранит. Если плагина экономики нет, в /vault-info будет Economy: None, и всё, что работает с деньгами, работать не будет. Обычная связка: EssentialsX для экономики и LuckPerms для прав.

Установка и проверка через /vault-info

1. Скачайте VaultUnlocked-2.20.3.jar с Modrinth. Для сервера на Java 8 берите VaultUnlockedJava8-2.20.3.jar.
2. Удалите из plugins старый Vault.jar, если он там был.
3. Положите jar рядом с плагином экономики и прав, например EssentialsX и LuckPerms, и перезапустите сервер.
4. Введите в консоли /vault-info.

Старый Vault отвечает тремя строками:

[Vault] Economy: <экономика> [<все найденные>]
[Vault] Permission: <плагин прав> [<все найденные>]
[Vault] Chat: <плагин чата> [<все найденные>]

VaultUnlocked выводит шесть строк: для экономики, прав и чата отдельно Legacy (старый API Vault, через него работает большинство плагинов) и Modern (новый API VaultUnlocked). Для обычного сервера важны строки Legacy. None там означает, что нужный плагин не установлен или не загрузился: ищите ошибку при запуске в логе.

В plugins/Vault/config.yml один ключ: update-check: true, проверка обновлений. Больше Vault настраивать не нужно.

Префиксы и экономика через Vault

Префикс задаётся в LuckPerms, а в чат его выводит чат-плагин, который читает префикс через Vault:

/lp group vip meta addprefix 100 "&6[VIP] "
/lp user Steve info

Если префикс в /lp user Steve info есть, а в чате его нет, дело в чат-плагине или в Vault. Для EssentialsX проверьте /ess version: команда показывает, найден ли Vault и какой плагин прав используется. С Essentials нужны именно EssentialsX и EssentialsX Chat.

Экономика EssentialsX работает через Vault без отдельной настройки. Проверить можно так:

/eco give Steve 100
/balance Steve

Если деньги выдаются, а магазин их не видит, посмотрите строку Economy в /vault-info: там должна быть экономика EssentialsX, а не другой плагин.

Плейсхолдеры Vault в PlaceholderAPI

Для TAB, скорборда, голограмм и меню баланс и группа выводятся через PlaceholderAPI. Расширение ставится командами:

/papi ecloud download Vault
/papi reload
/papi parse me %vault_eco_balance%

• %vault_eco_balance%: баланс игрока;
• %vault_eco_balance_formatted% и %vault_eco_balance_commas%: баланс в удобном виде;
• %vault_prefix% и %vault_suffix%: префикс и суффикс;
• %vault_group%: основная группа, %vault_groups%: все группы;
• %vault_hasgroup_<group>%: есть ли у игрока группа.

Полный список есть в вики PlaceholderAPI. У VaultUnlocked есть и свои плейсхолдеры, например %vaultunlocked_balance%, но они работают только с экономикой, которая поддерживает новый API VaultUnlocked. Для EssentialsX надёжнее %vault_eco_balance%.

Как перенести балансы: /vault-convert

При смене плагина экономики балансы можно перенести командой:

/vault-convert <старая_экономика> <новая_экономика>

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

Права на команды: vault.admin.info для /vault-info, vault.admin.convert для /vault-convert, vault.admin включает оба. У старого Vault обе команды висят на одном vault.admin. По умолчанию всё это есть только у операторов. Право vault.update в VaultUnlocked отвечает за уведомления об обновлениях.