💰 BankSystem

A complete banking experience for your server: multiple accounts, shared accounts with roles, loans, interest, transaction history and a clean modern GUI.

Plugin by ItzPhenix  |  Version 1.2.0  |  Paper 1.21+

---

✨ Features

	Feature	Description
🏦	Multiple bank accounts	Every player can open up to several accounts with custom names (configurable limit and creation cost).
👥	Shared accounts & roles	Share an account with other players using the roles VIEWER, MEMBER and MANAGER. Change roles or remove members at any time.
💸	Deposit & withdraw	Fast deposits and withdrawals with configurable minimum and maximum amounts per transaction.
➜	Transfers	Send money between your own accounts or to accounts you are a member of, with an account picker GUI.
📋	Transaction history	Full history with paging: deposits, withdrawals, transfers, interests and loans, each with balance after the transaction.
💳	Loans	Players can take out a bank loan, get the money instantly, pay it back in parts or all at once. Configurable rate, interval, maximum amount and minimum account age.
📈	Interest system	Automatic interest payouts on accounts with configurable rate, interval, minimum balance and payout cap.
🏧	ATM	Interact with a configurable block (Lodestone by default) to open the bank directly.
✏️	Account management	Rename accounts, delete accounts, owner only protections and optional overdraft.
🔔	Notifications	Players get notified about deposits, withdrawals, transfers, role changes, shared accounts and interest, even offline.
🌐	Full custom language	Everything the players see is translatable. Ships with English (default) and German.
🔌	Integrations	Works with any Vault economy, extra XConomy support and PlaceholderAPI placeholders.

---

🌐 Language system

Choose the language of all chat messages, GUI texts, role names, admin help and console logs in config.yml:

general:
  language: "en"   # "en" (English, default) or "de" (German)

The matching file (messages_en.yml or messages_de.yml) is created automatically in plugins/BankSystem/ on the first start and can be edited freely.

Upgrading from 1.1.2? If you had a custom messages: section in your config.yml, it is migrated automatically into the language file on first start. Nothing is lost.

Built in placeholders (PlaceholderAPI)

%bank_total_balance%        Total balance across all accounts of a player
%bank_account_count%        Number of owned accounts
%bank_shared_count%         Number of shared accounts
%bank_main_balance%         Balance of the main account
%bank_main_name%            Name of the main account
%bank_richest_account_name% Name of the richest account
%bank_richest_account_bal%  Balance of the richest account
%bank_loan_active%          Whether the player has an active loan
%bank_loan_amount%          Remaining loan amount
%bank_account_<name>_balance%  Balance of a specific account

---

📜 Commands

Command	Description
/bank (alias /atm)	Opens the bank GUI.
/bank confirm	Confirms a pending action (account creation, account deletion).
/bankadmin reload	Reloads the configuration and language files.
/bankadmin setbalance <player> <account> <amount>	Sets the balance of an account.
/bankadmin delete <player> <account>	Deletes any account.
/bankadmin info <player>	Shows all accounts of a player.
/bankadmin list	Lists all bank accounts on the server.

---

🔑 Permissions

Permission	Default	Description
banksystem.use	true	Use the bank GUI
banksystem.create	true	Create bank accounts
banksystem.deposit	true	Deposit money
banksystem.withdraw	true	Withdraw money
banksystem.transfer	true	Transfer money
banksystem.share	true	Share accounts with others
banksystem.share.roles	true	Manage roles on shared accounts
banksystem.interest	true	Receive interest
banksystem.loan	true	Take out loans
banksystem.history	true	View transaction history
banksystem.notifications	true	Receive bank notifications
banksystem.free	false	Create accounts for free
banksystem.maxaccounts.bypass	false	Bypass the account limit
banksystem.admin	op	Access to admin commands

---

⚙️ Example configuration

general:
  language: "en"
  currency-symbol: "$"
  date-format: "MM/dd/yyyy HH:mm"

accounts:
  creation-cost: 200000.0
  max-accounts-per-player: 3
  default-name: "Main Account"

loans:
  enabled: true
  max-loan-amount: 1000000.0
  loan-rate: 0.02
  repayment-interval: 120

interest:
  enabled: true
  rate: 0.005
  interval-minutes: 60

sharing:
  enabled: true
  max-members: 10

---

📦 Requirements & Installation

Requirements

• Paper (or a fork like Purpur) for Minecraft 1.21 or newer
• Java 17 or newer
• An economy plugin through Vault (for example EssentialsX Economy)

Installation

1. Drop BankSystem-1.2.0.jar into your server's plugins folder.
2. Restart the server.
3. Edit plugins/BankSystem/config.yml and the language file to your liking.
4. Run /bankadmin reload to apply the changes.

Storage is handled with SQLite by default, no external database needed.

---

🛠️ Support

Found a bug or have a feature request? Reach out to ItzPhenix directly.

---

BankSystem 1.2.0 · made by ItzPhenix · enjoy the bank 💰