Bank Admin Panel
The Bank Admin Panel is a full in-game configuration interface with 8 tabs. All settings can be edited inline with immediate save — no config file editing required.
Opening the Admin Panel
/ksbank admin
Permission: bank.admin
Panel Layout
The admin panel uses a tabbed sidebar on the left with 8 tabs, and the active tab's content on the right. A status message bar at the bottom shows feedback for actions.
Tabs
General Tab
Configure core bank settings.
| Field | Type | Description |
|---|---|---|
| Default Pages | Text Input | Number of bank pages new players start with (min: 1) |
| Max Pages | Text Input | Maximum number of bank pages a player can unlock |
| Slots Per Page | Text Input | Number of item slots per bank page |
| Upgrade Enabled | Checkbox | Whether players can purchase page upgrades with currency |
| Economy Provider | Display | Shows the detected economy provider name (read-only) |
How to edit: Change the value in the text field and press the Save button. Invalid values are auto-corrected (e.g., defaultPages < 1 is set to 1).
Economy Tab
Configure upgrade costs and economy providers.
| Field | Type | Description |
|---|---|---|
| Default Costs | Text Input | Comma-separated cost array (e.g., 0,250,500,1000,2500). Index 0 = page 1 cost, index 1 = page 2 cost, etc. |
| Default Currency Name | Text Input | Display name for the default currency (e.g., Gold) |
| Provider Costs | List (paginated, 3 per page) | Per-provider cost arrays with display names. Shows ProviderName (DisplayName) — [costs] |
| Shop Info Enabled | Checkbox | Show the "Want more pages?" button in page overview |
| Shop Info Button Text | Text Input | Label on the shop info button |
| Shop Info Message | Text Input | Chat message sent when the button is clicked |
| Shop Info Link | Text Input | Clickable URL included in the chat message |
Provider management:
- Add provider: Enter a name in the "New provider name..." field and click Add
- Edit provider: Click the Edit button next to a provider to load its values into the form fields, modify them, then click Update
- Delete provider: Click the Delete button next to a provider to remove it
Ranks Tab
Configure rank-based page limits via LuckPerms permissions.
| Field | Type | Description |
|---|---|---|
| Rank list | List (paginated, 8 per page) | Shows permission → pages mappings sorted by page count |
| Permission | Text Input | Permission node (e.g., bank.pages.5) |
| Pages | Text Input | Maximum pages for this permission |
Rank management:
- Add rank: Enter the permission and pages values, then click Add
- Edit rank: Click a rank entry to load its values, modify, then Update
- Delete rank: Click the Delete button next to a rank entry
Coins Tab
Configure coin-to-currency conversion definitions.
| Field | Type | Description |
|---|---|---|
| Provider dropdown | Dropdown | Select which economy provider to add coins to |
| Coin entries | List (paginated, 10 per page) | Shows coins grouped by provider with headers |
| Item ID | Text Input | The item ID of the coin (e.g., Copper_Coin) |
| Value | Text Input | Currency amount per coin item |
| Auto-detected | Display | Shows whether EcotaleCoins were auto-detected |
Coin management:
- Add coin: Select provider from dropdown, enter Item ID and Value, click Add
- Edit coin: Click the Edit button on a coin row to load its values, modify, then Update
- Delete coin: Click the Delete button to remove a coin definition
- New provider: Select "+ New Provider..." in the dropdown, enter a provider name
Restrict Tab
Configure item restrictions (blacklist/whitelist).
| Field | Type | Description |
|---|---|---|
| Mode | Display | Shows current mode (blacklist or whitelist) |
| Restricted items | List (paginated, 10 per page) | Item ID patterns currently in the restriction list |
| Item ID | Text Input | Item ID or wildcard pattern (e.g., Quest_Item_*) |
Restriction management:
- Add item: Enter an item ID or pattern and click Add
- Delete item: Click the Delete button next to an item to remove it
- Toggle mode: Use the Mode toggle button to switch between blacklist and whitelist
Players Tab
Search and manage individual player bank data.
| Field | Type | Description |
|---|---|---|
| Search | Text Input | Enter a player name to search |
| Player Name | Display | Player's username |
| UUID | Display | Player's UUID |
| Pages | Display | Number of unlocked pages |
| Slots | Display | Used slots / total slots |
| Item Count | Display | Total number of items stored |
| World Group | Display | Current world group (or "Global") |
| Sort Mode | Display | Player's selected sort mode (Default, A-Z, Z-A, Rarity) |
Player management:
- Add Page: Click to grant one additional page to the player (free)
- Remove Page: Click to remove the last page (items on that page are lost)
- Open Bank: Click to open and view the player's bank contents (read/write)
- Reset Bank: Click to reset the player's bank entirely (irreversible)
Resetting a player's bank removes ALL items and resets page count to defaultPages. This action cannot be undone.
History Tab
View transaction logs for any player.
| Field | Type | Description |
|---|---|---|
| Search | Text Input | Enter a player name to search |
| History entries | List (paginated, 10 per page) | Shows timestamp, action (DEPOSIT/WITHDRAW), item ID, and amount |
Entries are color-coded: green for deposits, red for withdrawals. Each entry shows a precise timestamp (date + time with seconds).
Worlds Tab
Configure world banking — separate bank inventories per world group.
| Field | Type | Description |
|---|---|---|
| World Banking Enabled | Checkbox | Enable/disable separate bank inventories per world |
| World Groups | List (paginated) | Shows group name and associated world patterns |
| Group Name | Text Input | Name for the world group (e.g., pvp, creative) |
| Worlds | Text Input | Comma-separated world name patterns (e.g., arena, battleground) |
World group management:
- Add group: Enter group name and world patterns, click Add
- Edit group: Click the Edit button on a group to load its values, modify, then Update
- Delete group: Click the Delete button to remove a world group
World pattern matching uses case-insensitive contains logic. A pattern arena matches a world named PvP_Arena_Kx8hs9d. This accommodates dynamic world name suffixes.
Workflow Examples
Setting up rank-based page limits
- Open the admin panel:
/ksbank admin - Click the Ranks tab
- Enter
bank.pages.5in the Permission field - Enter
5in the Pages field - Click Add
- Repeat for other ranks
- In LuckPerms, assign the permissions to groups:
/lp group vip permission set bank.pages.5 true
Configuring economy providers
- Open the admin panel:
/ksbank admin - Click the Economy tab
- Enter a provider name in "New provider name..."
- Click Add
- Enter cost array (e.g.,
0,100,200,500) and display name - Click Save
Adding item restrictions
- Open the admin panel → Restrict tab
- Verify the mode is set to your desired mode (blacklist/whitelist)
- Enter item patterns (e.g.,
Quest_Item_*,Soulbound_*) - Click Add for each pattern
Save Behavior
Changes made in the admin panel are applied immediately to the running configuration and saved to config.json on disk. No server restart is required.
If you need to reload configuration from disk (e.g., after manual file edits), use:
/ksbank reload