Configuration

Configuration

Everything lives in plugins/RoyalBank/config.yml. Run /bank reload after edits.

This page covers the settings, transactions, and database sections. The account ladder has its own page — see Bank Tiers & Interest — and anti-abuse has its own too.

settings

settings:
  currency-symbol: "$"
  starting-level: 1
  interest-on-join: true
  interest-command-enabled: true
  interest-cooldown-hours: 31
  pay-interest-to-bank: true
  upgrade-unlock-combined-balance: 10000000.0
  first-deposit-bonus:
    enabled: true
    amount: 10.0
  max-daily-interest:
    enabled: true
    amount: 1500000.0
  custom-amount-timeout-seconds: 60
  messages-prefix: "&6&lRoyalBank &8» &r"
  amount-limits:
    min-transaction: 0.01
    max-transaction: 1000000000000.0
    decimal-places: 2
  transfer:
    confirm-threshold: 100000000.0
    confirm-timeout-seconds: 30

Key	Meaning
currency-symbol	Symbol used when formatting amounts in messages and GUIs.
starting-level	Tier a brand-new account starts at.
interest-on-join	Pay any available interest automatically when a player joins.
interest-command-enabled	Allow /bank interest and the GUI interest button.
interest-cooldown-hours	Real hours between interest claims. Default 31.
pay-interest-to-bank	true = interest goes into the bank; false = into the purse.
upgrade-unlock-combined-balance	Combined (bank + purse) balance a player must reach before they're allowed to upgrade.
first-deposit-bonus	One-time bonus paid the first time a player ever deposits. Tracked per account — emptying and re-depositing won't re-grant it.
max-daily-interest.amount	Ceiling on each interest claim. Set negative for no global cap. Frequency is governed by interest-cooldown-hours.
custom-amount-timeout-seconds	How long a GUI "custom amount" chat prompt stays active before a normal chat message is no longer captured.
messages-prefix	Prefix prepended to plugin messages (uses & color codes).
amount-limits	Min/max per transaction and the decimal precision used.
transfer.confirm-threshold	Transfers at/above this need /bank transfer confirm. 0 = never require confirmation.
transfer.confirm-timeout-seconds	How long a pending transfer stays confirmable.

transactions

transactions:
  max-per-player: 100
  prune-on-startup: true

Key	Meaning
max-per-player	Newest N transactions kept per player. Keeps the table from growing without bound.
prune-on-startup	Trim histories down to the limit when the server starts.

database

database:
  file: "bank.db"

The SQLite file name, relative to plugins/RoyalBank/. See Storage & Backups.

Messages

Every player-facing string is in messages.yml, using & color codes (and hex where your server supports it). Edit freely and /bank reload.

A note on formatting

config.yml is YAML. Keep the indentation (two spaces, no tabs), quote anything with special characters, and don't remove keys — if a value is missing the plugin falls back to a default and logs a warning. If the file fails to load, RoyalBank tells you the line in the console.