Skip to content

Changelog

First version: the Order Board. Not released yet and not tested in game.

  • A server-wide board for buy requests. /ksorder opens the order window: “I need 200 Iron Ingots and pay 1,000 coins”. Others deliver all of it or just a part and get their share of the reward right away. The board is the counterpart to player shops: there people sell, here people ask.
  • Rewards held in escrow. The reward is taken when the order is posted: coins from the wallet (with an economy) or items from the inventory, with durability and all their properties. Every delivery pays its share per piece (rounded down; the delivery that fills the order gets the rest), so nobody delivers for nothing and nobody pays twice.
  • Partial deliveries, strictly in order. Several people can deliver into the same order. Deliveries run one after the other, and an order never gets more than it asked for. Only plain, undamaged items count (nothing enchanted, soulbound or damaged, no heirlooms); the window shows how many matching pieces you carry.
  • Four kinds of orders. Public orders, guild orders (only members of your guild see and fill them; the person posting pays, and leaving the guild closes them with a refund), direct orders for one person, and server orders that admins post with a reward from nothing, for example for events.
  • Pickup box. Delivered goods, refunds and rewards that did not fit into the inventory wait in your pickup box, also while you are offline. Collect all gives what fits and never drops anything on the ground; the rest stays. Equal items are shown bundled (“80 Iron Ingots · from 3 people”) and can be unfolded.
  • My orders. See your open and recently closed orders with all deliveries, withdraw an order at any time (goods already delivered stay yours, the unpaid reward comes back), or post it again with the rest quantity and the same price per piece.
  • Price hint. When at least three open coin orders want the same item, the window shows what others pay per piece right now.
  • Notices your way. Deliveries, payments, expired orders, removed orders and orders the board closed (for example when you left the guild) come as a notice at the top of the screen, most of them also as a chat line. While you are offline they come as a Whisperstone note, otherwise as a short summary at your next login (“Since your last visit: 3 deliveries, 1 order expired”). Every player chooses the channels in /kssettings; admins can switch channels off for everyone.
  • Admin window. /ksorderadmin (needs ks.orders.admin): an overview with open orders, coins in escrow, deliveries and expired orders of the last 7 days, recent activity, waiting pickup boxes and suspicious patterns (someone delivering almost only to one person, prices far above or below the usual, many expired orders); all orders with search, filters and details; removing an order with a reason and a refund; creating server orders; and the protocol of every booking for 30 days with filters by type, person and order.
  • Rules in one place. Orders per person (5 by default), allowed quantities and durations (1, 3 or 7 days), coin and item rewards, guild and direct orders, a block list for items (exact ids or patterns with *), the notice channels, and an optional fee on coin orders (0 % by default, at most 50 %, kept and not refunded).
  • Server box. Goods delivered into server orders that were posted from the console wait in the server box of the admin window. Admins take them into their own inventory (what does not fit moves to their own pickup box) or discard single entries with a reason that the protocol keeps.
  • Safe against crashes. Every movement of coins or items is booked and saved before the inventory or wallet is touched, and finished afterwards. After a crash or a restart the board finishes what can be finished by itself. Only bookings whose outcome nobody can know wait for an admin as “unclear”, with two buttons: “it happened” or “it did not happen”. Nothing is guessed, nothing is paid twice.
  • Works with other KyuubiSoft mods. Coins, the item picker, notices, the /ksadmin hub tile and the settings page with Core; guild orders with Guilds; offline notes and an Orders tile with Whisperstone; the quest and achievement triggers order_post, order_deliver and order_fulfil for Quests and Achievements. The board also runs without any of them, then with item rewards only.
  • Coin bookings say what they were for. With the server currency Kronen, every coin booking names its order in the reader’s language: Order #12 posted · reward and fee held in escrow, Delivery reward · order #12 for each delivery, Delivery to the server · order #12, Unpaid rest back · order #12 and Given back after a check · order #12. Several entries of different orders collected at once show Collected from the pickup box. See Coin bookings in the Kronen history.
  • Nine languages. de, en, es, fr, it, pl, pt-BR, ru and tr. Every text follows the player’s language. Polish and Russian counts use three plural forms (1 / 2–4 / 5+).
  • Commands. /ksorder (also /orders) with list [mine|box], deliver <order> [amount], withdraw <order>, collect [entry] and help; /ksorderadmin with remove <order> <reason>, expire <order>, review [<booking> yes|no], reload and help, also from the console. The yes or no of review is understood in all nine languages. See Commands.
  • Permissions. ks.orders.user.open, ks.orders.user.post, ks.orders.user.deliver and ks.orders.user.collect are open by default; withdrawing your own order only needs open. Admin actions need ks.orders.admin.
  • Unclear bookings. If the game or the economy does not answer while coins or items move (or the server stops in that very moment), the booking waits for an admin in the overview or under /ksorderadmin review. Collect all books each entry on its own, so such a case only ever concerns one entry. A server stop waits a few seconds for bookings that are still running.
  • Coins and the economy. Coin rewards rely on the economy’s answer. If an economy fails internally after moving coins and still answers “not paid”, the board cannot notice that.
  • Showcase servers. Visitors of a KyuubiSoft showcase server can look at the board but not post or deliver. With the admin permission they can view the admin window but not change anything.
  • Damaged data files. If a file with coins or items in it cannot be read at the start, the board pauses (no posting, delivering or collecting), keeps a .broken copy and overwrites nothing until the file is repaired and the server restarted.
  • Item choice. Choosing the wanted item for a new order uses the item picker of KyuubiSoft Core.