Installation

Installation

Requirements

Server	Paper 1.21+ (tested on Paper 26.2, which itself requires Java 25 to run)
Java	21+
Required	Vault and a Vault-compatible economy plugin (EssentialsX, CMI, etc.)
Optional	EcoItems or another PDC-tagged custom-item plugin — for item-based upgrade costs
Optional	PlaceholderAPI — for placeholders in other plugins
Optional	EconGuard — shared economy audit ledger and anti-abuse core

Vault is not an economy. Vault is only a bridge. You also need an actual economy plugin registered through it, or RoyalBank has no currency to move.

Steps

1. Download RoyalBank.jar and place it in your server's plugins/ folder.
2. Make sure Vault and your economy plugin are also installed.
3. Start (or restart) the server. RoyalBank generates its files under plugins/RoyalBank/.
4. Edit the generated files to taste (see Configuration).
5. Run /bank reload to apply changes without a full restart.

Generated files

plugins/RoyalBank/
├── config.yml            # settings, anti-abuse, and the level ladder
├── messages.yml          # every player-facing string
├── bank.db               # SQLite database (created on first run)
├── backups/              # created by /bank admin backup
└── gui/
    ├── main.yml
    ├── deposit.yml
    ├── withdraw.yml
    ├── transactions.yml
    └── confirm-upgrade.yml

First boot checklist

• Console shows RoyalBank enabling with no economy warning. If it reports waiting for an economy provider, your economy plugin isn't registering — see FAQ & Troubleshooting.
• /bank opens the main menu.
• /bank deposit 100 moves 100 from your purse into the bank.

Load order note

RoyalBank waits for the Vault economy provider to register rather than disabling itself if the provider isn't ready the instant RoyalBank enables. This means plugin load order can't silently kill it — but it also means that if no economy plugin ever registers, banking operations will fail until one does.