Bank Permissions

All permission nodes used by the Bank plugin, including admin permissions, feature-gating permissions, and rank-based page limits.

---

Admin Permission

Permission	Type	Default	Description
bank.admin	Admin	false	Access to all admin commands (admin, open, give, adminupgrade, reset, log, reload) and the admin panel UI

note

All admin subcommands use the single bank.admin permission. There are no separate permissions for individual admin commands.

---

Feature Permissions

Feature permissions are configured in config.json under the permissions section. They gate specific player actions — when a permission string is set, only players with that permission can use the feature.

Feature	Config Path	Default Permission	Description
Upgrade	permissions.upgrade.permission	"" (everyone)	Purchase bank page upgrades
Transfer	permissions.transfer.permission	"" (everyone)	Transfer items between bank pages
Withdraw	permissions.withdraw.permission	"" (everyone)	Withdraw items from the bank
Deposit	permissions.deposit.permission	"" (everyone)	Deposit items into the bank

When a permission string is empty (""), the feature is available to all players. When set to a specific permission node, players without that permission see the configured lockedMessage.

Example — VIP-only upgrades:

"permissions": {
  "upgrade": {
    "permission": "bank.vip.upgrade",
    "lockedMessage": "Requires VIP rank to upgrade!"
  }
}

---

Rank-Based Page Limits

The permissions.rankPages map controls how many bank pages players can unlock based on their LuckPerms permissions. Each entry maps a permission node to a maximum page count.

Permission	Max Pages	Description
bank.pages.3	3	Basic rank — up to 3 pages
bank.pages.5	5	Mid rank — up to 5 pages
bank.pages.7	7	High rank — up to 7 pages
bank.pages.10	10	Premium rank — up to 10 pages

Resolution logic:

1. The system checks all rankPages entries against the player's permissions
2. The player gets the highest matching value across all their permissions
3. The result is capped at the global maxPages config value
4. If rankPages is empty or the player has no matching permissions, they can buy up to maxPages

tip

If rankPages is empty, all players can buy up to maxPages. Once you add entries to rankPages, only players with a matching permission can upgrade beyond defaultPages.

---

LuckPerms Examples

Grant admin access

/lp user Steve permission set bank.admin true

Set up rank-based page limits

/lp group vip permission set bank.pages.5 true
/lp group premium permission set bank.pages.10 true

Gate upgrades behind VIP rank

/lp group vip permission set bank.vip.upgrade true

---

Permission Inheritance

A typical permission hierarchy:

Owner / Admin
  └── bank.admin
  └── bank.pages.10

VIP
  └── bank.pages.7
  └── bank.vip.upgrade (if upgrade is gated)

Default
  └── (no bank permissions needed — all player features work by default)