​

🚀 First Install

​

✅ Minimum requirements

​

📥 Installation (step by step)

1. Choose the correct JAR
   • For Java 17 servers → vault-2.1.0-java17.jar
   • For Java 21 servers → vault-2.1.0-java21.jar
2. Stop the server and place the JAR in your plugins/ folder:
   my_server/
   ├── spigot-1.21.1.jar
   ├── plugins/
   │   ├── PlaceholderAPI/
   │   ├── LuckPerms/
   │   └── Vault/           ← created on first boot
   │   └── vault-2.1.0-java21.jar   ← PASTE HERE
   └── ...
   
3. (Optional) Install neighboring plugins to activate integrations:
   • PlaceholderAPI.jar → enables %vault_balance_formatted%, etc.
   • SkinsRestorer.jar → heads in /pay work even if the server is in offline mode.
   • LuckPerms.jar → to manage vault.* permissions comfortably.
4. Start the server. You will see in console:
   [Vault] ========================================
   [Vault]   Vault v2.1.0 (Java 21 build)
   [Vault]   Internal economy + Vault API bridge
   [Vault] ========================================
   [Vault] Locale: en  → messages_en.yml loaded
   [Vault] Storage: YAML  (balances.yml)
   [Vault] PlaceholderAPI detected → registered 40+ placeholders
   [Vault] SkinsRestorer detected → enabled head resolution
   [Vault] Update check: latest = v2.1.0  (you are up to date)
   
5. Stop and edit plugins/Vault/config.yml with your values (see Config Reference →).
6. Start again and run from in-game or console:
   /eco give YourName 10000
   /balance
   

​

🔧 First boot: generated files

# Default structure (v2.1.0)
config.yml                  # General settings, currency, storage, loans, bank, discord
balances.yml                # YAML balance storage (when use_mysql: false)
bank.yml                    # Banking system balances (bank_balance per UUID)
loans.yml                   # Active / closed loans (YamlLoanStorage)
transactions/               # Folder with daily JSON logs (DailyJsonLogWriter)
    ├── 2026-09-02.json
    └── ...
messages/
    ├── messages_en.yml
    ├── messages_es.yml
    ├── messages_pt.yml
    ├── messages_de.yml
    ├── messages_fr.yml
    ├── messages_nl.yml
    ├── messages_pl.yml
    ├── messages_ru.yml
    ├── messages_hi.yml
    ├── messages_zh_CN.yml
    └── messages_zh_TW.yml

​

✅ Post-installation checks

​

⚙️ Enable MySQL (optional)

storage:
  use_mysql: true
  mysql:
    host: db.myserver.com
    port: 3306
    database: vault_prod
    username: vault_user
    password: "YourSecurePassword123!"
    pool_size: 10