Skip to content

FAQ

Version: 1.0.0

What happens to my reward when I post an order?

Section titled “What happens to my reward when I post an order?”

It is taken at once and held in escrow: coins from your wallet, item stacks from your inventory, with all their properties. Nobody can spend it twice. Every delivery is paid from the escrow. When the order ends before it is complete, the unpaid rest goes back to your pickup box.

  • No economy is connected. Coin rewards need KyuubiSoft Core and an economy that Core connects to: Core’s own server currency Kronen or a different economy. The window says “items only, no economy connected”.
  • The admin switched coin rewards off.

Why does the Post order button say something else?

Section titled “Why does the Post order button say something else?”

It names what is missing: “Item missing”, “Item blocked”, “Check quantity”, “No economy”, “Reward too small” (less than 1 per piece), “Not enough in wallet”, “Choose stacks”, “Name missing” (direct orders), “No guild”, “Limit reached” (5 open orders by default) or “Not allowed” (no ks.orders.user.post).

Not by default. The admin can set a fee of up to 50 % on coin rewards. It is taken on top of the reward when you post, and it is not refunded, also not when you withdraw the order or it expires. Item rewards have no fee. The New order tab shows the fee under Held now.

What does the Kronen history show for my orders?

Section titled “What does the Kronen history show for my orders?”

With Core’s server currency Kronen, every coin booking of the board names its order: “Order #412 posted · reward and fee held in escrow” when you post, “Delivery reward · order #412” for your share of a delivery, “Unpaid rest back · order #412” for a refund and “Given back after a check · order #412” after an admin checked an unclear booking. Collecting entries of several orders at once shows “Collected from the pickup box”. The full list is on Configuration.

What happens when my order expires, or when I withdraw it?

Section titled “What happens when my order expires, or when I withdraw it?”
  • The unpaid rest of the reward goes to your pickup box. With item rewards you get the exact stacks back, with their properties.
  • Goods already delivered stay in your pickup box.
  • The order stays under My orders for 14 days. Post again fills New order with the item, the rest quantity and the same price per piece.

Orders are checked every 30 seconds, so an order ends at most half a minute after its time ran out.

Only with KyuubiSoft Guilds. Choose Guild under Visibility: only members of your guild see the order and deliver into it. You pay the reward, not the guild. When you leave the guild (or are removed), or the guild is disbanded, your open guild orders close and the rest comes back to your pickup box. Guild membership is checked again at every delivery.

Choose Directly to … and type a name. The person must have been on the server before. Only that person sees the order and can deliver into it; they get the notice “Order for you”. You cannot post an order to yourself.


Only plain, undamaged pieces of the wanted item. Enchanted, soulbound or damaged items and heirlooms do not count; they stay in your inventory. Blocked items cannot be delivered at all. The board shows how many matching pieces you carry.

Your share per piece, rounded down. The rounding rest goes to the delivery that fills the order, so the sum is always exactly the reward.

OrderDeliveriesShares
200 Iron Ingot for 1,000 coins34 pieces170 coins (5 per piece)
300 Copper Ore for 1,000 coins100, 100, 100333, 333, 334 coins
40 Bread for 10 Gold Ingots1 bread at a timea gold ingot every fourth bread

Item rewards are paid the same way per stack, in whole pieces. If your share is not a whole piece yet, the window says “the share of this delivery is not a whole piece yet”; it comes with the next pieces.

Coins into your wallet, items into your inventory. What does not fit waits in your pickup box. If the economy is not connected at that moment, the coins wait in your pickup box and are paid into your wallet at your next login.

You carry none of the wanted item, or only pieces that do not count: damaged, enchanted or soulbound ones, or heirlooms. Repaired or fresh pieces work.

”Your inventory cannot be reached right now”

Section titled “”Your inventory cannot be reached right now””

The board only touches inventories in worlds where the game saves the player. In minigame worlds and similar instance worlds you cannot post item rewards, deliver or collect. Go back to a normal world and try again.

Can two people deliver into the same order at the same time?

Section titled “Can two people deliver into the same order at the same time?”

Yes, but the board handles them strictly one after the other. Nobody can deliver more than is still missing, and an order never gets more than it asked for. The second person gets only what is left, or “Order #412 is not running any more.”

No, not even as an admin.


  • Goods others delivered into your orders.
  • The unpaid rest of an order that expired, that you withdrew or that an admin removed.
  • Reward shares that did not fit into your wallet or inventory.
  • Entries given back after an admin checked an unclear booking.

Entries stay until you collect them; they never run out. You can collect them while you are online, also long after the order ended.

Collect all gives what fits and keeps the rest in the box. Nothing is dropped on the ground. Make room and collect again.

Coins go straight into your wallet when you collect, but only while an economy is connected. Without one they stay in the box: “Stays here while no economy is connected.”

The booking for it is unclear and an admin has to decide what happened. Until then the entry cannot be collected. Nothing gets lost; see the next section.


Every movement of coins or items is first saved as a booking, then the inventory or wallet is touched, then the booking is finished. If the game or the economy gives no clear answer in that moment (or the server stops right then), the board does not guess. The booking waits for an admin:

  • The admin overview shows “1 unclear booking waits for your decision” with Check, and /ksorderadmin review lists them.
  • The admin checks the player’s inventory or wallet and decides It happened or It did not happen (/ksorderadmin review <booking> yes|no).
  • Entries that belong to the booking are held (“being checked”) until then.

After a normal crash or restart the board finishes everything it can by itself. Collecting several entries books each entry on its own, so a problem only ever concerns one entry. A server stop waits a few seconds for bookings that are still running.

A data file with coins or items in it (orders.json, a pickup box or a booking) could not be read at the start. The board keeps a copy as <file>.broken, overwrites nothing and stops posting, delivering and collecting. The server log and the admin overview name the file. Repair or remove it and restart the server.

Server orders posted by an admin in the game send their delivered goods to that admin’s pickup box. Server orders without a person behind them (posted from the console) send them to the server box. Admins open it from the overview: Collect gives the goods to you (what does not fit moves to your own pickup box), Discard … removes an entry for good, with a reason the protocol keeps.

With ks.orders.admin: Create server order in the admin window, or Server under Visibility in your own order window. The reward comes from the server; nothing is taken from you. Item rewards of server orders must be plain items. When a server order ends, the unpaid rest lapses.

What does “Unusual” in the overview mean?

Section titled “What does “Unusual” in the overview mean?”

Hints for admins, nothing more. Nothing is blocked or removed on its own.

HintWhen
Delivers almost only to one personAt least 75 % of a person’s deliveries in 7 days went to the same person (from 5 deliveries)
Reward far above / below usualAn open coin order pays at least 5 times more or less per piece than the median of the other open coin orders of that item (at least three of them)
Lets many orders expireAt least 5 expired orders of one person in 7 days

The values can be changed in config.json, see Configuration.

In the admin window (/ksorderadmin) under Rules; changes apply at once and are written to config.json. A few options are only in the file (reward stacks, unread notices, unusual patterns, retention) or in integration.json (quest and achievement triggers). Edit them and run /ksorderadmin reload. See Configuration.


The board works on its own. These mods add a part when they are installed:

ModWhat it adds
CoreCoin rewards through Core’s economy connection (Kronen or a different economy, main currency only); the item picker for new orders; the Order Board tile in the /ksadmin hub; the Order Board page in /kssettings; notice cards in Core’s shared card row
GuildsGuild orders, only for members of your guild
WhisperstoneNotices as notes on the whisper stone while you are offline, and an Orders tile that opens /ksorder
QuestsThe objective types order_post, order_deliver and order_fulfil
AchievementsThe same three types as achievement triggers

Not to start the board, but in practice yes: without Core there are no coin rewards and no item picker, so players can only pick items from their own recent orders. Admins can still type an item id for server orders.

order_post when someone posts an order, order_deliver with the number of pieces delivered, and order_fulfil when someone’s own order is complete. The target is the item id of the order, or any. Limits per day keep them from being farmed with a second account. The board adds no quests or achievements of its own. Details are on Configuration.