Changelog
v2.7.0 — 2026-11-10 — Kronen
Section titled “v2.7.0 — 2026-11-10 — Kronen”The bank carries the server currency Kronen (“Crowns” in English) and gets an account tab. Not released yet and not tested in game.
- Server currency without KyuubiSoft Core. The bank also carries KyuubiSoft’s own server currency when Core is not installed: balances, history,
/kskronen,/kskronen pay <person> <amount> [reason]and/kskronen historywork with the bank alone. With Core installed, Core carries the currency and the bank shows it. Both use the same data foldermods/kyuubisoft_kronen/, so nothing is lost when Core is added or removed. The currency is off by default. While it is off, the bank behaves exactly as before: no account tab without an economy, and pages stay free. - New account tab. While the currency is the server’s money, the account tab shows your balance with the coin, your last four bookings with where they came from (“Claims”, “Transfer from Mira”), a link to the full history and a footer naming the server currency.
- Transfers with a reason, also to people who are offline. Type a name and an amount, optionally a reason. Before you send, a confirmation line shows who gets how much and what you keep, and tells you when the person is offline (“last seen 2 h ago”) or when a name was misspelled (“did you mean Mira?”). Anyone who has played on the server can receive money, with every economy. Only an exact name is ever paid, and a quick double click never sends twice.
- The recipient sees the transfer. Transfers appear in the history of both people, and an online recipient gets a chat message.
- Currency filter in the history. The history has a Crowns filter with the last 20 bookings of the currency from the last 30 days.
- Page prices in the currency. Bank pages show their price with the coin and the currency name (“250 Crowns”), and the purchase appears in your history as “Page 3 unlocked”. Without any economy, pages stay free as before.
- Readable reasons. Bookings in the account tab and the history show their reason in your language (“Claims” · “2 chunks bought”, “Bank” · “Page 3 unlocked”), also when someone with another language caused them.
- Admins. While the bank carries the currency, the bank admin window gets a Crowns button, and
/kskronenadminopens the currency’s own admin window: switch it on there, and see sources, accounts, settings and the log.
- Safer currency. The currency the bank carries without Core got the same improvements as in Core 2.10.0: what you are told always matches what counts after a restart, one interrupted task can no longer stop all bookings, start balances are paid exactly once, and nothing is written while the currency is off.
- One transfer per second. A second transfer within a second gets “One transfer per second – please wait a moment.”
- Smooth typing in the transfer fields. Typing a name, an amount or a reason redraws the confirmation line at most four times per second, so a quick click on Send is never swallowed.
- Names several people had. The bank and
/kskronen payuse the same rule: with several offline accounts of the same name, the right person has to be online. - Switched-off economies are no longer offered. The currency choice in the account tab only lists economies that are switched on, and payments to a switched-off economy are refused instead of failing halfway.
- Payments work without the economy library. With an economy that Core reaches directly, transfers, page purchases and coin withdrawals no longer fail when the separate economy library is not installed.
- No more fixed “Gold”. Prices and balances use the name of the server currency or the name your economy reports. A
defaultCurrencyNameof your own still wins; the old default “Gold” counts as unset. - Correct version in the jar. The plugin manifest always carries the version of the build.
- Every language. The account tab, the transfer texts and the currency’s own windows and messages ship in all 9 languages, with the proper plural forms for Polish and Russian.
Before you update
Section titled “Before you update”- With an older KyuubiSoft Core (before 2.10.0) and the bank carrying the currency, every KS booking shows the source “KyuubiSoft”: the older Core cannot tell the mods apart.
- The currency stays off until an admin switches it on in its admin window, or sets
"enabled": trueinmods/kyuubisoft_kronen/config.json. Bank pages then cost Crowns (default 250 / 500 / 1000 / 2500); changeupgrade.defaultCostsfor other prices.
v2.6.6 — 2026-11-09 — Design & Feature Update
Section titled “v2.6.6 — 2026-11-09 — Design & Feature Update”Release of the Design & Feature Update. It sums up the changes since 2.5.4.
- New bank window.
/ksbankand the bank NPC open one window in the new KyuubiSoft look: the vault with search, sorting by name, rarity or amount and a page or scroll view, plus your storage and hotbar, with a rarity ring on every slot. - Account, History and Pages tabs. Account shows your balance with its currency name, deposit all coins, withdraw as coins and transfers to other players. History is grouped by day with search and filters, and Pages lists every tier with its price and a Buy button.
- Search by item name. The vault and history search find the item names players see in their game language and in their
/kslanglanguage, not only item IDs. - New admin panel.
/ksbank adminputs everything in one window: General, Economy, Ranks, Coins and Restrict for the settings, Players, History and Worlds for managing banks. With KyuubiSoft Core installed it also has a tile in the/ksadminhub.
- Open banks are saved. The 60-second auto-save never ran, so a crash could lose what was stored since the bank was opened. Open banks are now saved every 60 seconds and when the server stops.
- No more deleted items. Changing
slotsPerPageno longer deletes items or stops banks from opening: pages are fitted, and items without a free slot wait until there is room. Items of removed mods stay stored and come back when the mod is installed again. - Unreadable data is kept. A bank page that cannot be read is locked instead of being saved empty, and an unreadable bank file is kept as a copy. An unreadable
config.jsonno longer stops the bank and is no longer replaced. - Admin changes stick.
/ksbank give,adminupgrade,resetand the page changes in the admin panel are no longer undone by the player’s open bank window. - No more lost money. Withdrawing as coins keeps the part that does not fit into a whole coin in the account, and a failed transfer is refunded.
- Rights are checked everywhere. Every way into the admin panel, including the citizen used on the KyuubiSoft Showcase, checks
ks.bank.admin, and admins viewing another player’s bank can no longer move that player’s money. On servers with Hytale’s own permissions, rank pages count only when the player really has the node; before, every player could buy up to the highest rank. - Restrictions are enforced. Wildcards such as
Quest_*work, and click transfers and drag and drop respect the restriction list. - Works without KyuubiSoft Core. The bank and its commands start and work without KyuubiSoft Core.
- Proper texts. Every language uses its proper letters, Russian is written in Cyrillic and missing translations are filled in. Messages show the whole sentence instead of only the inserted value, history entries show ”›” instead of ”?”, and
/kslangwithout an argument answers in chat.
Before you update
Section titled “Before you update”- Grant
ks.bank.admin. All admin commands, the admin panel and/ksbank open --player=<name>use onlyks.bank.admin; the oldbank.adminis no longer read. - Check your
config.json. The feature permissions (permissions.upgrade,transfer,withdraw,deposit),upgrade.enabledandhistoryMaxEntrieshad no effect before and now apply. Items that a restriction wildcard now matches stay in the bank and can still be taken out.
v2.6.3 — 2026-10-23
Section titled “v2.6.3 — 2026-10-23”- Coin and transfer entries in the bank history no longer show ”?”. They used an arrow that no game font has (“Coins ? 1,250 Gold”). New entries use ”›”, and entries saved before are shown with ”›” as well: in the History tab, in the admin panel’s history and in
/ksbank historyand/ksbank log.
v2.6.2 — 2026-10-21
Section titled “v2.6.2 — 2026-10-21”- Tile in the
/ksadminhub: with KyuubiSoft Core 2.8.0 or newer installed, the bank admin panel appears as a tile in Core’s “KyuubiSoft Management” hub. It opens withks.bank.admin. Showcase visitors get it read-only, the same as the showcase bank admin NPC.
Changed
Section titled “Changed”- The admin panel’s “no permission” message is shown in the player’s language, no longer in the server language.
- The shared language system follows Core 2.8.0: it honours the server’s default player language and the “players may choose” switch, and language choices are no longer lost when several KyuubiSoft mods save them at the same time.
v2.6.1 — 2026-10-19
Section titled “v2.6.1 — 2026-10-19”Security and data-loss fixes. Not tested in game yet.
Security
Section titled “Security”- The showcase admin citizen no longer opens the admin panel for everyone. A Core citizen with the ID
showcase_bankadminopens it only for admins (ks.bank.admin), or as a read-only panel while Core’s showcase mode is on. Before, it opened the full panel for every player. - The admin panel never changes anything without
ks.bank.admin, in addition to Core’s showcase guard. Open Bank in the panel counts as a change too. - Rank pages without LuckPerms use Hytale’s own permission system: a node counts only when the player has it. Before, every node counted as granted and every player could buy up to the highest rank value.
Fixed: data loss
Section titled “Fixed: data loss”- Open banks are saved every 60 seconds (the auto-save never wrote anything before) and when the server stops.
- Changing
slotsPerPagekeeps every item. Saved pages are fitted when the bank opens: larger pages grow, items from cut-off slots move to free slots, and items without a free slot wait in the player’s file until there is room (with a chat message). Before, lowering the value deleted items and raising it stopped banks from opening. - Admin changes stick while the bank is open.
/ksbank give,adminupgrade,resetand the admin panel’s reset and page buttons first save and close the player’s open bank window. Before, closing the window undid the change.addItemOrDrop(API) works the same way. - Moves in a bank window whose session was already closed no longer put items into a container nobody saves.
- A damaged bank page is no longer overwritten empty. Its slots are locked in the window, its saved data stays untouched, the log names it and the player gets a chat message.
/ksbank giveand the API skip it. - Items of removed mods are kept. They are still hidden in the window, but stay stored and show up again once the mod is back; the player gets a chat message with their number.
- An unreadable bank file is kept as
<uuid>.json.unreadable-<time>before the player gets a new, empty bank.
Fixed: restrictions
Section titled “Fixed: restrictions”- Wildcards work (
Quest_*,*_Key,Ore_*_Raw) and matching ignores case. Before, patterns with*matched nothing. - Clicks and drag and drop respect the restriction list. A restricted item stays in the inventory (“This item cannot be stored in the bank”).
- Note: because wildcards now match, items already in a bank can become restricted. They stay there and can still be taken out.
Fixed: other
Section titled “Fixed: other”- Admins need only
ks.bank.admin.bank.adminis no longer used, also not by/ksbank open --player=<name>. - The commands work without KyuubiSoft Core.
- The bank starts without KyuubiSoft Core. The
config.jsonwritten on the first start without Core had a text note inside theEcotalecoin list, so the plugin stopped during setup. The file now holds exactly the built-in defaults (notes only outside the lists). An unedited old file is replaced on the first start and kept asconfig.json.old-template-<time>; the values stay the same. - An unreadable
config.jsonno longer stops the bank or gets replaced. The log names the reason (SEVERE), the file stays as it is and the bank runs on the built-in defaults, or on the settings loaded before when it was a reload;/ksbank reloadanswers “Error loading config: …”. Before, with Core the file was silently overwritten with defaults. When the admin panel saves over such a file, the old one is kept asconfig.json.unreadable-<time>. Servers that still have the 2.6.0 template on disk get this error on every start until the file is fixed (they already ran on the defaults). - Admin and command messages show the full sentence (“Bank of Steve has been reset.” instead of “Steve”).
- The feature permissions in
config.jsonwork (permissions.upgrade,transfer,withdraw,deposit). Empty (the default) still allows everyone. See Permissions. historyMaxEntriesis applied: players see their newest entries (default 100) in the History tab and in/ksbank history;0= no limit. The database keeps everything for/ksbank logand the admin panel.- The vault and history search find item names in the player’s game language and in their
/kslanglanguage, not only item IDs. - The balance shows the currency name (
upgrade.providerDisplayNames, else the name the economy reports) instead of the economy provider’s name. - The “Upgrades Enabled” switch works (
upgrade.enabled, defaulttrue). Off: players cannot buy pages; admins still grant them. - The bank’s item texts have their own language file (
Server/Languages/<lang>/bank.langin the jar) instead of sharing the game’sserver.lang. The History item’s name and description were missing in 7 languages. - Localization version 13 (7 new texts in all 9 languages). Older files are backed up as
<lang>.json.backup-v<old>and replaced.
v2.6.0 — 2026-10-17
Section titled “v2.6.0 — 2026-10-17”New: one bank window in the Goldfiligran look
Section titled “New: one bank window in the Goldfiligran look”The bank window and the admin panel use the KyuubiSoft “Goldfiligran” look. See UI Pages and Admin Panel.
- One window instead of three. The separate settings and economy windows and the page overview are gone; the window is 944 px wide (was 1330).
- Left: item search, sort pills (Name / Rarity / Amount; click again to switch sorting off), the vault (9 x 5), a view switch (Pages / Scroll), a pager with one diamond per page (click to jump), then your storage (4 x 9) and hotbar in one panel.
- Right, three tabs:
- Account: currency dropdown (only with more than one provider), balance, “Deposit all coins”, “Withdraw as coins”, transfer to a player.
- History: search, filters All / Deposited / Withdrawn, 10 entries per page grouped by day (Today / Yesterday / date), with translated item names, item icons with rarity ring and green or red amounts.
- Pages: one row per page (owned / buy / later / higher rank needed / not for sale). The next page has a gold frame and a Buy button (Unlock on a bank without pages). “Pay with” choice when provider prices are set. Shop info button.
- A status line at the bottom of the panel (green success, red error).
- Rarity rings in the vault, storage and hotbar replace the vanilla quality background, so filled and empty slots share the same frame.
- Rarity sort follows the real rarity order.
- Bank without pages: a lock over the vault explains how to unlock the first page; the Pages tab opens by itself.
- Buying a page and switching between Pages and Scroll view reopen the bank in the new state instead of just closing it.
/ksbank page <page>now really opens on that page. - Clicking an inventory item stores it on the shown page (Pages view) or anywhere in the vault (Scroll view) instead of always on page 1; a full page shows a status message.
- Amounts accept thousands separators (“1.250”, “1,250”, “1 250”); decimals are rejected instead of being misread.
Changed: admin panel
Section titled “Changed: admin panel”- One window with a navigation column (Config: General, Economy, Ranks, Coins, Restrict; Management: Players, History, Worlds) and one content panel. The navigation shows how many ranks, coins, restrictions and world groups exist.
- The three checkboxes are toggle buttons. “Upgrades enabled” and “Show shop info” apply on Save; “World banking” switches and saves at once (the separate Apply button is gone).
- New: delete buttons per rank and per restriction; green/red status line; translated item names in the history list; pagers only appear with more than one page; empty state for world groups.
- All earlier actions are kept.
- Withdrawing as coins no longer swallows the remainder: only the part that fits into whole coins is taken from the balance (15 with a smallest coin of 10 pays out 10 and keeps 5). The payout is refunded if handing out the coins fails.
- Admins viewing another player’s bank can no longer move that player’s money (the Account tab is hidden), buy pages for them or change their sort and view settings (“Only possible in your own bank”).
- A click that arrives after the window closed itself (for example a second “Buy”) is ignored, so a page cannot be bought twice.
- More than 10 page rows are listed and buyable (custom
maxPagesor rank pages); the pager hides its diamonds above 10 pages. - Typing in the vault or history search only redraws that part of the window.
- An outdated slot number from the client is rejected.
- Transfers can no longer lose money: if crediting the receiver fails after the sender was charged, the sender gets the money back.
- The status messages of the bank window (“Sent … to …”, “No results for …”) showed only their value; they now show the full sentence. (Chat answers of the admin commands and the admin panel’s status messages kept this problem until 2.6.1.)
- Saving after a page purchase could skip the file save.
- A late close event of a replaced bank window could remove the new session and skip its save.
Removed
Section titled “Removed”- The unused files
Pages/Bank/History.ui,Hud/Bank/Sidebar.uiandPages/Bank/BankSlot.png.
- The UI textures come from the shared KyuubiSoft UI kit inside the jar; nothing extra to install.
- Localization version 11 in all 9 languages (48 new texts). Older language files are backed up as
<lang>.json.backup-v<old>and replaced. manifest.json: authorKyuubiDDragon, description “KyuubiSoft Bank - Personal vault with pages, history and economy”.
- The Upgrades Enabled switch (
upgrade.enabled) and the feature permissions inconfig.jsonare not checked. - Item restrictions:
*patterns match nothing, and the click and drag-and-drop transfers of the bank window skip the list. - Without an economy every page is free.
- Changes made while a bank window is open are only saved when it closes; the 60 second auto-save never writes anything.
- Changing
slotsPerPageon a server with saved banks loses items (lower) or stops banks from opening (higher). - In 2.6.0 the bank does not work without KyuubiSoft Core.
All of these were fixed in 2.6.1 (except that pages are still free without an economy).
v2.5.4 — 2026-10-12
Section titled “v2.5.4 — 2026-10-12”- Rebuilt against the final Hytale server 0.7.0 release (Update 7). No source changes.
v2.5.3 — 2026-10-06
Section titled “v2.5.3 — 2026-10-06”- Rebuilt against the Hytale server 0.7.0-pre.5.1 (Update 7 pre-release). No source changes.
v2.5.2 — 2026-09-06
Section titled “v2.5.2 — 2026-09-06”- Rebuilt against Hytale server 0.6.3. No source changes. (An earlier 2.5.2 build of 2026-08-27 marked the release as ready for Update 6.)
v2.5.1 — 2026-08-27
Section titled “v2.5.1 — 2026-08-27”- Rebuilt against the Hytale 0.6.0 release. Jars built for the 0.6.0 pre-releases do not load on the release server.
v2.5.0 — 2026-08-21
Section titled “v2.5.0 — 2026-08-21”Changed
Section titled “Changed”- Built against Hytale server 0.6.0 (Update 6). Jars built for 2026.05.26 no longer load.
- Command permissions follow the new 0.6.0 model: the player subcommands declare no required permission and keep their
ks.bank.user.*checks; the admin subcommands requireks.bank.admin.
- Item moves are safe on 0.6.0: storing an item from the inventory leaves the inventory untouched when the bank refuses it, and rolls the bank back when the inventory refuses the removal (no duplicates, no losses). A refused drag-and-drop swap restores the source slot.
- Coin deposits are reverted when the coins cannot be removed (before, the coins stayed and the balance was credited).
- No error on shutdown when the setup had failed.
- Admin subcommands also check the older node
bank.admin, so admins needks.bank.adminandbank.admin.
v2.4.0 — 2026-05-26
Section titled “v2.4.0 — 2026-05-26”- Built against the Hytale server release 2026.05.26.
- From the 2026.04/05 pre-release builds: the bank was adapted to the new server API, and the commands now look up the player through KyuubiSoft Core to avoid a thread crash. Since then the commands need Core.
v2.3.12 — 2026-04-14
Section titled “v2.3.12 — 2026-04-14”- EcotaleCoins value changes were ignored. The bank kept old coin values from
config.json. TheEcotalecoin list is now rebuilt from EcotaleCoins on every load. - Coins disabled in EcotaleCoins stayed in the bank. They are now removed; if EcotaleCoins reports no enabled coins, the
Ecotalelist is emptied. Your own providers are not touched. - Old built-in coin values came back. The legacy
coinItemsmap no longer starts with six fixed coins, and those six are removed on load when they still have their old default values.
v2.3.7 — 2026-04-03
Section titled “v2.3.7 — 2026-04-03”- Language handling no longer needs KyuubiSoft Core.
v2.1.0 — 2026-04-01
Section titled “v2.1.0 — 2026-04-01”- Every text of the bank window is translated (47 new texts in all 9 languages, including placeholders, economy messages and the page overview). Localization version 7.
v2.0.0 — 2026-03-22
Section titled “v2.0.0 — 2026-03-22”- New bank window with a native item grid (drag and drop), settings, bank and economy panels, a page overview with buy buttons, sort modes, scroll mode and item search.
- Economy through VaultUnlocked with several providers, EcotaleCoins detection, coin deposits and payouts, provider display names and provider-specific page prices.
- World banking with world groups, a “Want more pages?” shop button, rank-based page limits.
- Admin panel with eight tabs.
- Events
BankDepositEvent/BankWithdrawEvent,BankService.addItemOrDrop(), item storage in Hytale’s container format (older files are converted).
v1.0.0 — 2026-03-15
Section titled “v1.0.0 — 2026-03-15”- First release: a persistent bank per player with pages, bank NPCs, blacklist and whitelist restrictions, an SQLite history, admin commands and 9 languages.