FAQ and Troubleshooting

FAQ & Troubleshooting

Setup

RoyalBank says it's waiting for an economy provider / banking does nothing. Vault is only a bridge — you also need a real economy plugin (EssentialsX, CMI, etc.) registered through Vault. RoyalBank deliberately waits for that provider instead of disabling, so load order can't kill it; but if no economy ever registers, operations fail. Confirm your economy plugin is installed and loading without errors, then check /vault-info or your economy plugin's status.

Do I need EcoItems / PlaceholderAPI / EconGuard? No. All three are optional. EcoItems is only needed for ecoitems: upgrade costs, PlaceholderAPI only for placeholders in other plugins, and EconGuard only for the shared audit ledger. RoyalBank runs fully without any of them.

Config change isn't taking effect. Run /bank reload. If it still doesn't apply, the file probably failed to parse — check the console for a YAML error naming the line. Common causes: tabs instead of spaces, or an unquoted value with a special character.

Interest

Players say they aren't getting interest. Check, in order:

• The tier's max-interest isn't 0 (that disables interest for the tier).
• The player's balance actually falls in a tranche band — if all tranches top out below their balance, the portion above earns nothing (make the top tranche's to reach max-balance).
• The cooldown (interest-cooldown-hours) hasn't already been consumed.
• interest-command-enabled is true (for /bank interest) or interest-on-join is true (for join payouts).

Interest seems capped lower than my tranches add up to. Two ceilings apply and the smaller wins: the per-tier max-interest and the global settings.max-daily-interest.amount. Raise both (or set the global one negative for no global cap).

A player emptied and re-deposited to farm the first-deposit bonus. They can't — the bonus is tracked per account and paid once. Only /bank admin reset <player> makes an account eligible again.

Upgrades

A player has the gold blocks but can't upgrade. If the cost is minecraft:GOLD_BLOCK, a custom EcoItems gold block won't satisfy it (that's intentional — see Upgrade Costs). They need genuine vanilla blocks, or the tier should list the custom ecoitems: id instead. Also check they meet settings.upgrade-unlock-combined-balance.

Upgrade took nothing but didn't upgrade. Costs are consumed in the same operation that grants the tier and rolled back on failure, so this shouldn't strand items. Check the console for the reason the upgrade was rejected (insufficient funds, missing items, already max tier).

GUIs

A button does nothing. Check its action: value against the list in GUI Customization — a typo or NONE makes it decorative. Also watch the console for config warnings when the menu loads.

A custom deposit/withdraw prompt stopped listening. The chat prompt only captures input for settings.custom-amount-timeout-seconds (default 60). After that, type the amount again from the button.

Data & performance

Where is player data stored? Can I back it up live? In plugins/RoyalBank/bank.db. Use /bank admin backup — it makes a consistent snapshot with VACUUM INTO while the server runs. Don't copy the live .db file by hand while the server is up. See Storage & Backups.

Is this safe with a lot of players? Yes. Online accounts are cached in memory, the database runs in WAL mode, and pruning/backups run off the main thread. Keep transactions.max-per-player reasonable so the transaction table doesn't grow forever.

Still stuck?

Open an issue on the GitHub repository with your server version, the RoyalBank version (/plugins or the jar name), the relevant config section, and any console errors.