Skip to content

Changelog

Core brings a server currency of its own. Not released yet and not tested in game.

  • Kronen, the server’s own currency (off by default). For servers without another economy. Switch it on in the new admin window, or with "enabled": true in mods/kyuubisoft_kronen/config.json. While it is off, everything works as before. See Kronen.
  • Every KS mod pays with it at once. Claims, Guilds, Quests, Events, Shops, Bank, Season Pass, the NPC shops and dialog coins already pay through Core, so with Kronen on they book in Kronen without any change. Kronen only take over when no other economy is installed: Core decides once every plugin has started and steps back when a different economy is there (balances are kept). "economyProvider": "kronen" in Core’s config.json uses Kronen anyway; "internal" still means “no economy”.
  • Force Kronen. "force": true in mods/kyuubisoft_kronen/config.json keeps Kronen even when a different economy is installed (off by default).
  • Other plugins see Kronen too. When the shared economy interface is installed and no other economy is enabled there, Core registers Kronen with it and removes them again on shutdown.
  • Safe bookings. Every booking is written to a journal (mods/kyuubisoft_kronen/journal/, one file per month) before a balance changes. After a crash, Core finishes or undoes open bookings on the next start. Balances never go below zero, a transfer locks both accounts, and every booking records which mod paid and why.
  • What you are told is what counts. A booking counts once it is safely on the disk. If the disk does not confirm it, the booking is refused and stays refused after a restart: a refused purchase never costs money later, and a refused reward is never paid twice.
  • Start balance exactly once. The start balance is paid once per person, also when the balances are restored from the backup or rebuilt from the journal, and two logins at the same moment never pay it twice.
  • One transfer per second. Each person can send one transfer per second, with /kskronen pay, in the bank and in other mods alike, so nobody floods another person’s chat with tiny transfers.
  • /kskronen for players. /kskronen shows your balance, /kskronen pay <person> <amount> [reason] sends money, also to people who are offline (a mistyped name gets “did you mean …?”), and /kskronen history lists your last 10 bookings. If several people had the same name (after a rename), the right one has to be online. Recipients get a short note at the top of the screen (a chat line when that is not possible), or a summary at their next login. ks.kronen.user.balance and ks.kronen.user.pay are allowed by default.
  • Names in every language. “Crown” and “Crowns” in English, “Krone” and “Kronen” in German, and the right forms for Polish and Russian (three forms) and Turkish. Names, symbol, decimals, transfer limits, the report threshold and a start balance for new players (0 by default) are set in the config. Amounts use each language’s own separators.
  • Admin window for Kronen. /kskronenadmin or the new Crowns tile in /ksadmin (needs ks.kronen.admin) opens one window with five areas:
    • Overview: the state, the money in the game, money in and out per day for the last 7 days, the biggest sources and sinks, the richest accounts and what looks suspicious (a transfer above the report threshold, many small transfers to one person).
    • Money sources: reads the settings of every installed KS mod (read only) and shows what pays out, refunds or costs money, whether it is on, its factory default, a jump to that mod’s admin page, the start balance for new players and a warning when a shop buys something back for more than another shop sells it.
    • Accounts: search (also people who are offline), filters, the details of an account and give, take and set, which only work with a reason.
    • Settings: the main switch (it asks first and lists what will cost money from then on), the name in every language, symbol, decimals, transfers and their limits, and moving all balances to a different economy once, with a preview and an exchange rate.
    • Protocol: the last 30 days with filters for type, source and person.
  • Notes for money received. People who receive a transfer, or whose balance the server team changed, see a short card at the top of the screen, in line with the other KS notes. The server team stays anonymous. Every admin online gets a chat line about bookings made in the window.
  • Readable reasons in every language. Bookings of the KS mods say what they were for, in the language of whoever looks at the history later: “Claims · 2 chunks bought”, “Events · 1st place · Autumn market”, “Bank · Page 3 unlocked”. /kskronen history, the protocol in the admin window and the bank show them translated. Reasons that people type (transfers, the server team) stay exactly as typed.
  • Kronen bring their own texts. The currency’s texts ship with the currency itself, so they work the same with Core and with KyuubiSoft Bank. A server can still change them in Core’s custom_<language>.json files.
  • For mod authors. CoreAPI.currency() (balance, has, deposit and withdraw with source and reason, transfer, format, name), new ExternalEconomyBridge.deposit/withdraw(uuid, amount, source, reason) overloads, RewardGrantHelper.grantCurrency(player, currency, amount, reason) and CurrencyProvider.spend(player, amount, reason). A reason can be a code with arguments ("claims.chunks_bought|2") whose text kronen.reason.<code> is shown in each reader’s language.
  • Nothing written while Kronen is off. Core no longer creates mods/kyuubisoft_kronen/ while Kronen is off. The config file appears when you switch Kronen on or save its settings in the admin window. By hand, a config.json with {"enabled": true} in that folder is enough.
  • The admin window stays smooth. Switching Kronen on or off, saving settings and saving the balances after an admin booking happen in the background.
  • Moving balances is careful with unclear answers. When the other economy fails while an account is moved, the account is not paid back (that could double the money). It stays marked, the window and the server log list it, and it is never moved twice.
  • Whole crowns only. With "decimals": 0 a withdrawal below half a crown is refused instead of counting as paid.
  • Smaller fixes. An unreadable balances backup is kept as balances.json.broken-<time> and never replaces the good one; cards for money received wait until the player has finished loading; a stale carrier.lock after a crash is taken over with a log line; the money total can no longer overflow.
  • Guilds in /ksadmin. The Guilds tile in the management hub shows a banner instead of the default lantern.
  • Order Board in /ksadmin. The Order Board tile shows a sign instead of the default lantern.
  • Texts for /kskronen, the admin window and the booking reasons ship in all 9 languages, with the proper plural forms for Polish and Russian.
  • The money in the game counts every account. Shop tills and money letters of Player Shops are not included yet.

v2.9.9 — 2026-11-09 — Design & Feature Update

Section titled “v2.9.9 — 2026-11-09 — Design & Feature Update”

Release of the Design & Feature Update. It sums up the changes since 2.7.1.

  • /ksadmin hub. “KyuubiSoft Management” shows every KS mod that runs on your server with its real version and opens its admin window; mods without one get a “Config file” tile. The Status tab shows locked NPC files, paused player saves and “Reload all”, and the Language tab sets the server language, the default player language and whether players may choose their own.
  • /kssettings for players. One language choice for every KS mod (“Automatic” or one of 9 languages) and a page per installed mod with its own options. A language chosen there, in /kslang or in any KS window applies to every KS mod at once, and Core ships its texts in all 9 languages.
  • New NPC dialog window. It sits at the bottom of the screen so the world stays visible: the speaker on a live 3D stage, up to 4 numbered answers with tags such as “Opens shop”, and a history with “Step back”. Click the text to show it at once; stepping back never repeats commands, shops or rewards.
  • New NPC shop window. Buy and Sell tabs with your balance in the shop’s currency, the rotation timer, categories, today’s limit, a quantity stepper and the total. The Sell tab shows the price per piece, daily limits and “Sell all”.
  • NPC management window. /kscitizen edit [id] or the /ksadmin hub: search and groups; teleport, bring here, respawn, hide/show, clone and delete; tabs General, Appearance, Behaviour, Talk and Reactions with Undo, Save and Discard. New NPCs start from 7 templates, names can be set per language, and before an ID changes the window lists everything that points at it.
  • Skin editor. Take a skin from a player in your world, any player name, another NPC or your last 3 skins, or build one part by part with colours, variants, randomise and up to 30 undo steps. A live 3D view shows the result, and the NPC in the world changes only when you press “Apply”.
  • NPC viewer. /kscitizen viewer or the hub lists every NPC, mod NPC, orphan, mount and world creature in a loaded world with a 3D portrait. Teleport to it (also in other worlds), bring it here, remove it, “Adopt as NPC”, or clear leftover copies with “Clean up orphans”.
  • Dialog editor with actions. Write nodes and answers with their texts in every language, start from templates, “Check” one or all dialogs and “Test as player” without running anything. Answers can give or take items or coins, start a quest (with KyuubiSoft Quests), open a shop or window, teleport, play a sound or set a fact, each every time, once, or once per hour, day or week per player; an answer the player cannot pay for is greyed out with the reason.
  • NPC shop editor. Edit NPC shops in the game: switch entries off, sort and duplicate them, set buy-back lists and prices, preview the shop as a player and change prices with a price tool (−99 % to +1000 %). New shops start from a template, a shipped shop or a copy, and renaming a shop moves its NPCs along.
  • Item update window. /ksitemupdate lists your outdated items with their old and new durability and warns when durability goes down; update them one by one or all at once.
  • Web editor restore points. Before a send from /kseditor is applied, Core keeps a copy of every file it replaces (the newest 20). The editor’s Backup page goes back to the state before any send, also undoing changes made in game since then, and needs ks.core.admin.dialog.console.
  • Toasts no longer overlap. Short messages at the top center from Achievements, Quests, Season Pass and Showcase line up right below the compass and never cover each other.
  • Simpler admin permissions. /ksadmin and its reload need only ks.admin, which the NPC shop editor also checks when saving. /kscitizen and the NPC tools accept ks.citizen.admin or ks.admin; the old citizen.admin still works.
  • NPC shops have their own command. /ksnpcshop open|sell|list opens NPC shops, because the KyuubiSoft Shops mod uses /ksshop. Without that mod, /ksshop still works.
  • The web editor needs your confirmation in game. A /kseditor session applies changes only after you confirm it with /kstrusteditor <code> (also from the console); codes work once, and a confirmed session ends after 30 minutes without changes (webEditor.trustIdleTimeoutMinutes in Core’s config.json). Imports can only write a mod’s own config files, and modules.webEditor: false now stays off after a restart.
  • NPCs. The proximity “Sound” and the animation triggers “On attack” and “Default” now work, and name tags show the NPC name in each player’s language. Teleports no longer use the console tp command, “Move here” always respawns the NPC, proximity reactions also check height, and new installs no longer spawn the example NPC.
  • Player data and NPC files are safe. After a failed read (database error or broken file) nothing is saved over the data until it can be read again, and two saves at logout no longer lose data. Broken NPC files and KyuubiSoft Pets or Shops settings files with a typo are kept instead of overwritten, the regular NPC save no longer reverts hand edits, and NPC files keep their last 10 backups in citizen-backups/.
  • No more stacked NPCs. After a restart, NPCs far from players were spawned again and again and left nameless copies; Core now takes over the NPC that is already there, and “Clean up orphans” in the NPC viewer removes old copies. NPCs in every world with players animate, react and follow their schedules again, admin actions act in the NPC’s own world, respawns leave no duplicates, and the cleanup no longer deletes ridden mounts.
  • Shops, rewards and lootbags. A purchase with a full inventory is refused before you pay, a sale never takes items without paying, a shop command that cannot run is refused or refunded, and currency rewards report a failure instead of vanishing. The standard lootbags load again (none had loaded since March), old ids such as chapter_1_reward work again, and the Lootbags tile in /ksadmin no longer disconnects the client.
  • Dialogs. A double or late click no longer repeats a choice and its commands, far fewer clicks are lost at high ping, and a shop or window opened from a dialog now responds to clicks. A step without a visible answer shows “Close” instead of locking the player in.
  • Distance and zone progress. Distance and zone discovery count for every player again, so those quests, achievements and Season Pass challenges progress. Tracker HUDs hide again while the world map is open.
  • Commands read their arguments. /kscitizen subcommands with an id (create, remove, tp, respawn, info and more), /kscitizen list, /kscitizen wpadd <seconds> and /ksadmin addxp|removexp now work. /kslang without an argument answers in chat instead of risking a disconnect, and /kscitizen tp no longer moves a player whose name only starts the same way.
  • Update Core first. Install this version before the other KS mods; many of their new windows and features need it.
  • Grant the console permission. Only admins with ks.core.admin.dialog.console can add, change or remove commands that run as the server console (dialog, NPC and shop commands), in the windows and through the web editor. Existing console commands keep running.
  • NPC shops in dialogs. With KyuubiSoft Shops installed, change dialog and NPC commands that run ksshop open <shop> to ksnpcshop open <shop>, or use the dialog action “Open shop”.

The changes up to Core 2.9.3 are in the patch notes of the Design & Feature Update.