MultiBank

# MultiBank **A secure, multi-account economy plugin for Paper/Purpur 1.21.x.** Every player gets a personal account and can create shared **group accounts** with role-based permissions — all balances stored as integer cents for exact, drift-free money. !(https://img.shields.io/badge/version-1.0.0-blue) !(https://img.shields.io/badge/Minecraft-1.21.x-brightgreen) !(https://img.shields.io/badge/Java-21-orange) MultiBank can act as your server's primary economy (through its optional Vault bridge) and exposes a developer API for other plugins. ## Features - **Multiple accounts per player** — one personal account plus configurable shared group accounts. - **Role-based group accounts** — OWNER / MANAGER / MEMBER / VIEWER, with per-role permissions for renaming, inviting, kicking, setting roles, and transferring. - **Invite system** — invite players to a group account, with configurable invite expiry. - **GUI** — open a menu-driven interface for balances, accounts, and transfers. - **Atomic transactions** — deposits, withdrawals, transfers, and pays use in-database atomic updates with a funds guard, so concurrent operations can't dupe or lose money. Balances are stored as `long` cents. - **Payments** — `/pay` with configurable minimum/maximum amounts and a confirmation threshold. - **Top balances** — `/topbal` leaderboard (personal, primary, or all-account modes). - **Optional Vault bridge** — register MultiBank as the Vault economy provider so any Vault-aware plugin uses it. - **Optional ServerFactions integration** — automatic faction bank accounts (off by default). - **Developer API** — registered in the Bukkit ServicesManager for other plugins to consume. - **Storage** — SQLite by default or MySQL (HikariCP pooled), all queries parameterized. - **Rate limiting & GUI debounce** for abuse resistance. ## Commands | Command | Aliases | Description | Permission | | --- | --- | --- | --- | | `/mb` | `/multibank` | Open the MultiBank GUI (no args); parent for `account`, `admin`, `op` | — | | `/mb account <list\|info\|create\|rename\|setprimary\|invite\|accept\|kick\|role\|leave>` | | Manage personal and group accounts | see below | | `/mb admin <give\|take\|set\|freeze\|reload>` | | Administrative money and account controls | `multibank.admin` (+ sub-nodes) | | `/mb op <set\|give\|take>` | | OP/console override money commands | OP / console (config-gated) | | `/money` | `/bal`, `/saldo`, `/balance` | Check your balance | — | | `/pay` | `/pagar` | Pay another player | — | | `/topbal` | `/top`, `/baltop`, `/topmoney` | View the richest players | — | `/mb account create` requires `multibank.account.create`. Other `account` subcommands are gated by your **role** within the target group account rather than by a permission node. ## Permissions | Node | Description | Default | | --- | --- | --- | | `multibank.account.create` | Create shared group accounts | op* | | `multibank.admin` | Access `/mb admin` | op | | `multibank.admin.give` | Add money to an account | op | | `multibank.admin.take` | Remove money from an account | op | | `multibank.admin.set` | Set an account balance | op | | `multibank.admin.freeze` | Freeze/unfreeze an account | op | | `multibank.admin.reload` | Reload configuration and language | op | `/money`, `/pay`, `/topbal`, and opening the `/mb` GUI have no permission requirement and are available to everyone. \* These nodes are checked in code but not pre-declared in the plugin metadata, so by default only operators have them. Grant them explicitly with a permissions plugin (LuckPerms, etc.) to give access to non-ops. The `/mb op` override is restricted to server operators and console, and is further gated by `admin.op-override` in the config. ## Configuration Key sections of `config.yml`: ```yaml starting-balance: 100.00 # new personal accounts currency: symbol: "$" symbol-position: prefix # prefix | suffix decimals: 2 database: type: sqlite # sqlite | mysql sqlite-file: multibank.db pay: enabled: true min-amount: 0.01 max-amount: 0 # 0 = unlimited confirm-threshold: 1000.0 # -1 = never, 0 = always allow-self-pay: false accounts: allow-overdraft: false invite-expiry-hours: 72 max-group-accounts: 5 admin: op-override: enabled: true allow-console: true vault: enabled: true # register MultiBank as the Vault economy security: max-operations-per-minute: 30 # 0 = unlimited gui-debounce-ms: 250 factions: enabled: false # ServerFactions bank accounts ``` ## Installation 1. Requires **Paper** or **Purpur** 1.21.x and **Java 21**. 2. Drop `MultiBank-1.0.0.jar` into your server's `plugins/` folder. 3. (Optional) Install **Vault** so other plugins use MultiBank as the economy provider — keep `vault.enabled: true`. 4. Start the server to generate `config.yml`, then adjust the currency, starting balance, and limits. ##