features bank

---

🏦Bank

The bank introduces a second independent balance per player (stored in bank_balances.yml) separate from the wallet. Players can deposit funds to generate interest or withdraw them when needed.

Accessing the Bank

Open from:

• Slot 13 🏦 Bank of the main /vault menu (VaultMenuService.java:79-97, material GOLD_BLOCK)
• Command /vault bank menu

The GUI is managed by BankMenuService with a 45-slot inventory.

GUI Layout

Slot	Material	Function
10	Chest	Wallet — Balance in wallet
13	Ender Chest	Bank — Deposited bank balance
16	Beacon	Total — Wallet + Bank sum
20	Hopper	Deposit — Chat flow for deposit
22	Paper	Info — Interest/tax summary
24	Dispenser/Dropper	Withdraw — Chat flow for withdrawal
30–33	Green Stained Glass	Deposit quick picks (10/25/50/75%)
39–42	Red Stained Glass	Withdraw quick picks (10/25/50/100%)

Quick Picks with Shift ×10

The 4 percentage buttons behave differently when pressing Shift + Click (BankMenuService.java:270–280):

Quick pick	Normal click	Shift click
QP1 (10%)	10% × amount	100% (10×)
QP2 (25%)	25%	250%
QP3 (50%)	50%	500%
QP4 (75/100)	75% deposit / 100% withdrawal	Full wallet / full bank

Quick picks use niceRound() to round to friendly multiples (5 / 10 / 100 / 1,000 / 10,000 / 100,000 / 1,000,000…).

Bank Transactions

Each operation records a TxType in the transaction log (BankService.java:85–106):

• BANK_DEPOSIT — On deposit: withdraws from wallet → adds to bank_balance
• BANK_WITHDRAW — On withdrawal: subtracts from bank_balance → deposits into wallet

The bank_balances.yml file stores a balances.<UUID>: value map and optionally teams.<teamId> for team banks. It is persisted with save() after each operation.

Interest and Tax Configuration

bank:
  interest:
    enabled: true
    every_minutes: 60
    percent_per_period: 0.5
  tax:
    enabled: false
    every_minutes: 180
    threshold: 1000000
    percent_per_period: 0.1

Interest (applyInterest)

Asynchronous scheduler (runTaskTimerAsynchronously) that applies percent_per_period% on the full bank_balance every every_minutes minutes. Records TxType.INTEREST for every player with balance > 0.

If enabled: false, no task is scheduled regardless of the percentage value.

Progressive Tax (applyTax)

Only applies to the portion of the balance STRICTLY ABOVE THE THRESHOLD. Example:

• threshold = 1,000,000 ; balance = 1,500,000
• Only 500,000 is taxed × 0.1% = 500

Records TxType.TAX and subtracts from bank_balance.