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.

!Version !Minecraft !Java

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:

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.

Dependencies

• None required — MultiBank runs standalone with its own database economy.
• Vault (optional): install it to expose MultiBank as the server-wide Vault economy.
• ServerFactions (optional): enables automatic faction bank accounts when present and enabled in config.

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-multibank