# FAQ

**Version:** 1.0.0

## Posting orders

### 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.

### Why can't I choose coins as a reward?

- No economy is connected. Coin rewards need KyuubiSoft Core and an economy that Core connects to: Core's own server currency [Kronen](https://wiki.kyuubisoft.com/hytale/core/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?

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`).

### Is there a fee?

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?

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](./configuration#coin-bookings-in-the-kronen-history).

### 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.

### How do guild orders work?

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.

### How do direct orders work?

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.

---

## Delivering

### Which items can I deliver?

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.

### How much do I get for a delivery?

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.

| Order | Deliveries | Shares |
|-------|------------|--------|
| 200 Iron Ingot for 1,000 coins | 34 pieces | 170 coins (5 per piece) |
| 300 Copper Ore for 1,000 coins | 100, 100, 100 | 333, 333, 334 coins |
| 40 Bread for 10 Gold Ingots | 1 bread at a time | a 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.

### Where does my reward go?

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 nothing that fits"

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"

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?

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."

### Can I deliver into my own order?

No, not even as an admin.

---

## Pickup box

### Why is something in my pickup box?

- 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.

### My inventory is full

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

### Coins stay in my pickup box

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."

### An entry says "being checked"

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.

---

## Safety and admin

### What is an unclear booking?

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.

### The board says it is paused

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.

### What is the server box?

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.

### How do I post a server order?

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?

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

| Hint | When |
|------|------|
| Delivers almost only to one person | At least 75 % of a person's deliveries in 7 days went to the same person (from 5 deliveries) |
| Reward far above / below usual | An 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 expire | At least 5 expired orders of one person in 7 days |

The values can be changed in `config.json`, see [Configuration](./configuration#unusual-patterns).

### How do I change the settings?

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](./configuration).

---

## Other KyuubiSoft mods

### What do other KyuubiSoft mods add?

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

| Mod | What it adds |
|-----|--------------|
| [Core](https://wiki.kyuubisoft.com/hytale/core/) | Coin rewards through Core's economy connection ([Kronen](https://wiki.kyuubisoft.com/hytale/core/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 |
| [Guilds](https://wiki.kyuubisoft.com/hytale/guilds/) | Guild orders, only for members of your guild |
| [Whisperstone](https://wiki.kyuubisoft.com/hytale/whisperstone/) | Notices as notes on the whisper stone while you are offline, and an **Orders** tile that opens `/ksorder` |
| [Quests](https://wiki.kyuubisoft.com/hytale/quest-system/) | The objective types `order_post`, `order_deliver` and `order_fulfil` |
| [Achievements](https://wiki.kyuubisoft.com/hytale/achievement-system/) | The same three types as achievement triggers |

### Do I need KyuubiSoft Core?

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.

### What do the order triggers count?

`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](./configuration#quest-and-achievement-triggers).