Skip to content

UI Pages

Version: 2.6.6

Players use one window, the bank window. This page explains everything in it. Admin tools are on Admin Panel, the settings mentioned here on Configuration.

WindowHow to open itNotes
Bank windowA bank NPC, /ksbank open or /ksbank page <page>Your own bank
Bank window of another player/ksbank open --player=<name>, or Open Bank in the admin panelAdmins only
Admin panel/ksbank adminAdmins only

/ksbank history, /ksbank upgrade, /ksbank log and /kslang only answer in chat (see Language).


The bank window with the vault, the inventory and the Account tab The bank window in the Pages view with the Account tab open.

The window has a header, the vault and your inventory on the left, and a side panel with three tabs on the right.

  • Bank and a subtitle: “Vault of Steve · 312 items” (the number counts every single item, not stacks).
  • Used meter: occupied slots of all your pages, for example “38 / 135”, with a bar.
  • X closes the window (Escape works too).

Toolbar

  • Search items… dims every item that does not match while you type. The search looks at the item name in your game language (for example “Goldbarren” on a German client) and in the language you chose with /kslang (“Brot” also finds bread on an English client) and at the item ID, with or without underscores: bar gold finds Ingredient_Bar_Gold.
  • Name / Rarity / Amount sort the vault: by item ID from A to Z, rarest first, or largest stack first. Empty slots always come last. Click the active pill again to switch sorting off.
  • Sorting only changes what you see; the items stay in their slots. The sort choice is saved for your bank.

Grid

9 slots per row (45 slots = 5 rows per page by default). Each item has a rarity ring (common, uncommon, rare, epic, legendary) instead of the vanilla quality background; the same rings are used in your inventory below.

View switch and pager

ViewWhat you see
PagesOne page at a time. The pager shows “Page 2 / 5” with < and >, and one diamond per page (the current one in gold); click a diamond to jump. With more than 10 pages the diamonds are hidden.
ScrollAll pages in one grid with a scrollbar, and a hint like “All 3 pages · 135 slots · scroll with the mouse wheel”.

Switching the view redraws the window in place. The choice is saved for your bank; new players start in the Scroll view.

Below the vault: “Inventory”, the hint “Click: move between vault and inventory”, your storage (4 rows of 9) and your hotbar.

You doWhat happens
Click a vault item (also double-click or shift+click)The whole stack goes to your inventory, hotbar first. If your inventory is full, it drops at your feet.
Click an item in your storage or hotbarThe whole stack goes into the first empty slot of the shown page (Pages view) or of the whole vault (Scroll view). It is not added to existing stacks. A full page answers “This page is full - switch pages”, a full vault “Your vault is full”.
Drag an item onto another slotThe two slots swap. This works between the vault, your storage and your hotbar.
Drag a coin from your inventory onto the vaultWith an economy the coin turns into balance instead of being stored, see Account tab. Without the deposit feature permission it is stored as a normal item.

Items on the server’s restriction list cannot go into the vault, neither by click nor by drag and drop (also not as the other half of a swap). They stay in your inventory and the status line says “This item cannot be stored in the bank”.

Every move between vault and inventory is written to the history.

MessageMeaning
”N item(s) from removed mods are kept in your bank but cannot be shown.”Items whose mod was removed. They stay stored and show up again when the mod is back
”Page N of your bank could not be read. It stays locked and its items are kept - please tell an admin.”The page’s saved data is damaged. Its slots are locked; nothing can be put there
”N item(s) did not fit into your bank after its size changed. Free up slots and open the bank again to get them back.”The server lowered the slots per page. The items wait in your bank file and come back when there is room

The side panel has the tabs Account, History and Pages. The window opens on:

  • Pages when your bank has no page yet,
  • Account when the server has an economy,
  • History otherwise.

A status line at the bottom of the panel shows the result of your last action, green for success and red for errors. Switching tabs clears it.


Only shown when KyuubiSoft Core found an economy (see Getting Started) and the bank is your own. From 2.7.0 it is also shown while the server currency Kronen is on, see The account tab from 2.7.0.

PartWhat it does
CurrencyDropdown of the economy providers. Only shown when more than one is registered.
BalanceYour balance in the selected currency, with the currency name below it (the admin’s display name for the provider, else the name the economy reports, for example “Coins”).
Deposit coins”Drag coins into the vault or all at once:” and the button Deposit all coins, which turns every coin item of the selected currency in your storage and hotbar into balance (“Deposited …”; “No coins found” when there is none).
Withdraw as coinsA coin choice, an Amount field and Withdraw.
TransferPlayer name, Amount and Send.

Deposit coins and Withdraw as coins are only shown when the selected currency has coin items (EcotaleCoins, or coins added in the admin panel).

The server can limit depositing, withdrawing and transfers to a permission node (feature permissions). Without the node the button answers in the status line with the server’s text, or “You are not allowed to do this”.

Withdrawing as coins

  • The choice is Auto (optimal) or one coin, shown as its item ID and value, for example “Coin Gold (= 1000)”.
  • The bank pays as many of the chosen coin as fit, then the rest with the largest coins first. Only the value that fits into whole coins is taken from your balance: 15 with a smallest coin of 10 pays out one coin and keeps 5 in the account. Below the smallest coin nothing happens (“Amount is below the smallest coin”).
  • The coins go into your inventory, hotbar first; whatever does not fit drops at your feet.
  • Payouts are not written to the history.

Transfers

  • The receiver must be online. Upper and lower case of the name do not matter.
  • “Sent 250 Gold to Steve” on success; “Transfer failed” when the player is not online, your balance is too low or the economy refused. If the money cannot be credited to the receiver, you get it back.
  • Transfers are written to your history as “Transferred”.

Amounts can be typed as 1250, 1.250, 1,250 or 1 250. Decimals such as 1,5 are rejected (“Invalid amount”).

The account tab with Kronen: balance, recent bookings and a transfer to a player who is offline The account tab while Kronen is the server’s money: the balance, the last four bookings and a transfer with a reason to a player who is offline.

Bank 2.7.0 shows KyuubiSoft’s server currency Kronen (“Crowns” in English) in this tab. It carries the currency itself when KyuubiSoft Core is not installed; with Core 2.10.0 it shows Core’s balances. Kronen is off by default, and while it is off and no other economy exists, the Account tab stays hidden as before.

While Kronen is the money, the tab shows:

PartWhat it does
CurrencyOnly when another economy is switched on as well: Kronen comes first, then the other providers. Switched-off providers are no longer listed.
BalanceThe balance with the coin and the currency’s name (“2,480” · “Crowns”).
RecentYour last four bookings with where they came from and why, in your language: “Claims” · “2 chunks bought”, “Transfer from Mira” · ""thanks for the iron"", “From the server team”, “Start balance”, with the amount and the time (“today 16:20”). All in history › opens the History tab with the Crowns filter.
Deposit coins / Withdraw as coinsOnly when coin items are set up for the currency, as before.
TransferPerson, amount and an optional reason, a confirmation line and the send button (below).
Footer”Crowns are the server currency · /kskronen”

Transfers from 2.7.0

  • Also to people who are offline. Everyone who has played on the server can receive money. While you type a name, the field shows “online” or “offline” and “last seen 2 h ago”. A misspelled name gets “Nobody called “Mria” found – did you mean Mira?”; only an exact name is ever paid. When several offline people had exactly that name, nothing is sent (“the right one has to be online”).
  • Reason (optional). It is shown to the recipient and in both histories.
  • Confirmation line before you send: “Juno gets 300 Crowns · you keep 2,180 Crowns” and “Goes straight to the account · Juno sees it at the next login” (or ”… gets a message” when the person is online). Problems show in the same line: not enough balance, an invalid amount, above the limit per transfer.
  • Send 300 Crowns sends it. The status line confirms “Sent 300 Crowns to Juno” (plus “Juno is offline”). The same transfer again within 3 seconds is refused (“This transfer was just sent.”), so a double click never pays twice.
  • With Kronen, amounts may have up to two decimals in your language’s format, and the limits of the Kronen settings apply (per transfer, per day). Each person can send one transfer per second; a second one within that second gets “One transfer per second – please wait a moment.” Sending needs ks.kronen.user.pay (allowed by default) besides the transfer feature permission.
  • Typing in the three fields redraws the confirmation line at most four times per second, so a quick click on Send is never swallowed.
  • With another economy, transfers to offline people and the reason work the same way; amounts are whole numbers, and an online recipient gets a chat message “Kyuubi sent you 300 …”.
  • Both people get a history entry: ”› Juno 300 Crowns · “for the oak logs"" for the sender and ”‹ Kyuubi 300 Crowns · “for the oak logs"" for the recipient.

The History tab with day headers and the rarity-sorted vault The History tab; the vault next to it is sorted by rarity, and a search dims the items that do not match.

The tab shows your newest historyMaxEntries entries (100 by default, 0 = all); the label shows their number (“History 42”). Older entries stay in the database for admins.

  • Search history… filters while you type. It matches the shown item name, the item ID (with or without underscores) and the action word (deposit, withdraw, transfer).
  • All / Deposited / Withdrawn filter by direction. “Withdrawn” includes transfers.
  • 10 entries per page, newest first, under day headers: Today, Yesterday or the date (“17.10.”).
  • Each entry: the item icon with its rarity ring, the translated item name, the action and time (“Deposited · 14:32”) and the amount, green with + for deposits and red with - for withdrawals.
  • A coin dragged onto the vault shows the coin and the credited value as text (for example “Coin_Gold › 1,000”) with the number of coins as amount. “Deposit all coins” shows one line “Coins › 1,250” without icon or amount. Transfers show the receiver and the sum (”› Steve 250”) without icon or amount. The exact number format comes from your economy.
  • The pager (“1 / 4” with < and >) only appears with more than one page.
  • With nothing to show: “No transactions yet”, or “No results for ”…"" after a search.

The history covers all world groups of the player.

From 2.7.0 (not released yet):

  • While Kronen is the server’s money, a fourth pill Crowns lists your last 20 bookings of the currency from the last 30 days, grouped by day, with source, reason and amount. All in history › in the Account tab opens this filter.
  • Received transfers appear in the recipient’s history too (”‹ Kyuubi 300 Crowns”). In the filters a received transfer counts as Deposited, a sent one as Withdrawn.

The History tab with the Crowns filter Bank 2.7.0: the Crowns filter of the History tab.


The Pages tab with owned pages, the next page and its Buy button The Pages tab: one row per page; the next page has a gold frame and the Buy button.

The tab label shows owned and listed pages (“Pages 2/5”). The hint at the top reads “Your rank decides how many pages you can buy. Every page has 45 slots.”

Pay with (only when upgrade.providerCosts is set) chooses the price list: Default or one economy provider.

Every row shows “Page N” and its state:

StateRow
OwnedGold diamond, “45 slots”, Owned
Next pageGold frame, the price and Buy (Unlock when the bank has no page yet)
LaterThe price in grey and “Buy page N first”
Higher rank neededGrey title, “Higher rank needed”: above the limit of your rank pages
Not for saleGrey title, “Not for sale”: the price list has no price for this page
  • The price reads Free when it is 0 or when the server has no economy; otherwise for example “250 Gold” (the currency word follows the same rule as under the balance).
  • From 2.7.0 (not released yet): while Kronen is the server’s money, the default price list is paid in Kronen and shown with the coin and the currency’s name (“250 Crowns”). The purchase appears in your Kronen history as “Bank” · “Page 3 unlocked”. Without any economy pages stay free. Other economies show their own name instead of a fixed “Gold”.
  • Buy pays, saves your bank and redraws the window in place with the new page. Chat confirms “New bank page unlocked! (Page N)”.
  • If the purchase fails, the status line says “Purchase failed - see chat” and the chat says why: “Maximum bank size reached!”, “Not enough funds! Need: 250 Gold”, or the server’s text when page purchases need a permission node you do not have.
  • When the server has switched page sales off (upgrade.enabled: false), no page has a Buy button; pages within your limit read “Not for sale”.
  • A Want more pages? button at the bottom (when shopInfo is enabled) sends a chat message with a clickable link; the status line says “Link sent to your chat”.

A bank without a page: the lock over the vault and the Unlock button A new bank with defaultPages: 0: the vault is locked and the Pages tab offers the first page.

When a server starts players with defaultPages: 0, the vault shows No bank page yet with the text “Unlock your first page in the “Pages” tab on the right, then you can store items here.” The vault and inventory grids are hidden, the Used meter shows 0 / 0 and the window opens on the Pages tab. Unlock buys page 1 for defaultCosts[0] (free by default).


The bank window without an economy: no Account tab, Scroll view Without an economy the Account tab is hidden; this vault uses the Scroll view.

Without an economy the bank is pure storage: the Account tab is missing, the window opens on History, coins are stored like any other item and every page in the Pages tab is Free.


Admins open another player’s bank with /ksbank open --player=<name> or Open Bank in the admin panel. Open Bank replaces the admin panel with the bank; when that bank is already open, the panel stays open and its status line says “Bank is already open!”.

  • The vault and its history belong to the player; the inventory below is the admin’s own. Items can be moved between the two.
  • The Account tab is hidden. Buy and the view switch answer “Only possible in your own bank”. Sorting works but is not saved for the owner.
  • While the player has their bank open, an admin cannot open it (“Bank is already open!”). If the player opens their bank while an admin looks at it, the admin’s view is saved and stops working.

  • Closing the window (X, Escape) saves all pages. Buying a page and switching the view save before the window is redrawn.
  • While the window is open, the bank is saved every 60 seconds. A server crash loses at most the moves of the last minute.
  • Logging out and a server stop save the bank too.
  • When an admin changes your bank (gives an item, adds pages, resets it) while it is open, your window is saved and closed first.

/kslang is shared by all KyuubiSoft mods and answers in chat. Without an argument it shows your current language (chosen by you or taken from your game), the available language codes and how to change it. /kslang de-DE sets a language, /kslang auto goes back to the client language. The choice applies to every KyuubiSoft mod on the server.