CoreBank
The Ultimate High-Performance Async Banking Solution with Advanced GUI Actions


---

✨ Features

• 100% Asynchronous I/O: Saving, loading, and logging operations run entirely on separate threads. Your main
  thread stays untouched—enjoy a constant 20.0 TPS!
• Smart Click GUI Logic: Save precious GUI space. Players can use Left-click (+100), Right-click (+1,000), or Shift-click (Deposit/Withdraw entire wallet/bank) on a single item.
• Modular Multi-Config System: No messy configurations. Manage everything cleanly via dedicated files: database.yml, loans.yml, interest.yml, and gui.yml.
• Built-in MariaDB/MySQL Support: Features a high-speed HikariCP connection pool for network-wide synchronization (perfect for BungeeCord/Velocity setups).
• Standalone Fallback Modus: No SQL database available? No problem. The plugin automatically switches to a local bank_data.yml file if MySQL is disabled.
• Advanced Interest & Debt Systems: Passive interest payments with a configurable maximum balance cap. Loans can also generate debt interest over time to balance your economy.
• Async Bank Leaderboard: Let players compete for the top spot with /bank top, calculated completely lag-free in the background.
• Transaction History (Support Ready): Every movement is safely logged into the database, making fraud protection and player support incredibly easy.

---

Commands & Permissions

Player Commands:

• /bank — Opens the interactive banking terminal.
  Permission: corebank.use (Default: true)
• /bank top — Displays the top 10 richest bank accounts on the server.
  Permission: corebank.use (Default: true)

Admin Commands:

• /bankadmin see <player> — Inspect a player's bank balance and debt.
• /bankadmin <add|remove|set> <player> <amount> — Manage any player's bank account instantly.
  Permission: corebank.admin (Default: op)

---

⚙️ Requirements & Dependencies

• Java 21 or higher
• Paper / Spigot 1.21.x
• Vault
• Any Vault-compatible Economy Plugin (e.g., EssentialsX, CMI)

---

Setup & Installation

1. Download and drop the corebank.jar into your server's plugins folder.
2. Ensure both Vault and an economy plugin are active.
3. Start the server to generate the four modular configuration files.
4. (Optional) Open database.yml to insert your MariaDB/MySQL credentials and toggle mysql.enabled to true.
5. Customize the items, text, and interest rates in their respective files.
6. Reload/Restart and enjoy a high-performance banking system!