# Vault

- [Vault Economy v2.1.0](https://vault2-0.mintlify.app/index.md): Complete internal economy system for Spigot/Paper — Bank System, Physical Notes, Multi-currency, MySQL, Loans, PlaceholderAPI, Discord webhooks and 11 languages. Does not require external Vault.jar.
- [First Install](https://vault2-0.mintlify.app/first-install.md): Requirements (Java 17/21, Spigot 1.8.8+), step-by-step installation, JAR placement, first boot, PlaceholderAPI and MySQL checks.
- [Quick Start Guide](https://vault2-0.mintlify.app/beginners/getting-started.md): First steps with Vault 2.1. Installation, basic commands /balance /pay /eco and folder structure.
- [Currency Format](https://vault2-0.mintlify.app/currency/format.md): Controls how money is displayed — symbol, position (suffix/prefix), space, locale (us, eu, in, ch, fr) and rendered examples. Usage of currency.format() in Java and PlaceholderAPI %vault_balance_formatted%.
- [Currency Abbreviation](https://vault2-0.mintlify.app/currency/abbreviation.md): Automatic abbreviation of large balances — decimals, suffix (k/m/b/t), when abbreviation kicks in, thresholds (k=1000, m=1_000_000, etc.) and PlaceholderAPI %vault_eco_balance_short%.
- [Config Reference](https://vault2-0.mintlify.app/config-reference.md): Exhaustive breakdown of Vault v2.1.0's config.yml — every key with its type, default value, detailed explanation, and related source code. Covers language, currency.*, storage, currencies, top.*, bank (interest+tax), discord.*, world_balances, import.essentials, offline-uuid-fallback, update_check*,…
- [Languages / i18n](https://vault2-0.mintlify.app/languages.md): 11 official supported languages in Vault v2.1.0 (en, es, pt, de, fr, nl, pl, ru, hi, zh_CN, zh_TW). How to change `config.language`, structure of messages_xx.yml and custom translation.
- [Updater](https://vault2-0.mintlify.app/updater.md): Configure the Vault 2.1.0 update checker that queries Modrinth (ID rj9SgaYL), and the manual /vault update command.
- [Player-to-Player Payments (/pay)](https://vault2-0.mintlify.app/features/player-pay.md): Direct payment system between players with interactive GUI menu, configurable limits, offline payments, and charge requests.
- [Bank (/vault bank)](https://vault2-0.mintlify.app/features/bank.md): Independent bank balance with GUI, deposits/withdrawals, periodic interest, and progressive tax on large fortunes.
- [Physical Notes](https://vault2-0.mintlify.app/features/physical-notes.md): Withdraw money as PAPER items with HMAC-SHA256 anti-duplicate cryptographic signature. PersistentDataContainer support 1.14+ and legacy lore.
- [Loans (/loan and /vault loan)](https://vault2-0.mintlify.app/features/loans.md): Player loan system with installments, automatic interest, missed payments, and defaulting penalty effects.
- [Transaction Log](https://vault2-0.mintlify.app/features/transactions.md): Transaction logging system with 24 TxType values, dual file/MySQL DAO, daily JSON logs, and paginated /vault history interface.
- [Top Players (/vaultop and /eco top)](https://vault2-0.mintlify.app/features/top-players.md): Asynchronous ranking of the richest players with configurable cache, threshold-based invalidation, and 10-per-page pagination.
- [Clickable Charge Requests](https://vault2-0.mintlify.app/features/charge-requests.md): Clickable payment requests sent via chat, MySQL or in-memory persistence, and max_on_join limit at login.
- [Discord Webhook](https://vault2-0.mintlify.app/features/discord-webhook.md): Discord notifications without external libraries using java.net.http.HttpClient. Alerts for large transactions, anti-dupe, and persistence failures.
- [Installation Errors](https://vault2-0.mintlify.app/faq/installation-errors.md): Solutions to the most common failures when installing or starting Vault 2.1. Economy error, duplicate plugin, MySQL Hikari, Java version.
- [Bank Interest Not Applied](https://vault2-0.mintlify.app/faq/bank-interest-disabled.md): Checklist when players do not receive INTEREST. enabled, percent, every_minutes, balance=0, async scheduler stopped.
- [Physical Note "invalid" / Cannot Redeem](https://vault2-0.mintlify.app/faq/physical-note-invalid.md): Why a paper note says note.redeem.invalid. HMAC, PDC, secret.dat, multi-language lore, anti-dupe already_redeemed.
- [Per-World Balances](https://vault2-0.mintlify.app/multiworld/world-balances.md): Independent per-world balances using separate_worlds and MySQL vault_world_balances table. Compatibility with Vault legacy API.
- [Migration from Essentials](https://vault2-0.mintlify.app/multiworld/migration-essentials.md): Import Essentials balances from /plugins/Essentials/userdata/*.yml. Merge/replace modes, hidden internal marker.
- [PlaceholderAPI](https://vault2-0.mintlify.app/compatibility/placeholders.md): Complete list of PlaceholderAPI placeholders supported by Vault 2.1.0, including balance, baltop, currency, and dynamic placeholders.
- [SkinsRestorer](https://vault2-0.mintlify.app/compatibility/skinsrestorer.md): Integration with SkinsRestorer to display player-skull heads in the payment menu (/pay), with premium and non-premium support.
- [LuckPerms](https://vault2-0.mintlify.app/compatibility/luckperms.md): Integration with LuckPerms for permission-based economy features, group multipliers, meta-based currency limits, and context-aware transactions in Vault 2.1.0.
- [Scripting Placeholders](https://vault2-0.mintlify.app/scripting/placeholders.md): Quick reference of placeholders with practical examples for scoreboards, tablists, NPCs and scripts.
- [Transaction Logs & Events](https://vault2-0.mintlify.app/dev/java/tx-events.md): Record transactions with TransactionLogService and listen to events using TxRecord.Builder and TxType types in Vault 2.1.0.
- [SimpleEconomy Hooks](https://vault2-0.mintlify.app/dev/java/simple-economy-hooks.md): How to get the EconomyProvider from VaultPlugin and perform instanceof checks against SimpleEconomy to detect the modern v2 API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.