# Permissions

**Version:** 1.0.0

The board has four player nodes, which are allowed by default, and one admin node. The same nodes are checked in the chat commands **and** in the windows: a player without `ks.orders.user.deliver` can neither type `/ksorder deliver` nor click **Deliver**.

Command syntax is on the [Commands](./commands) page.

---

## Player nodes (allowed by default)

These nodes are **allowed unless you set them to `false`**. A player without one gets "You do not have the permission for that.", and the matching button in the window is greyed out with a short reason such as "Not allowed".

| Permission | Unlocks |
|------------|---------|
| `ks.orders.user.open` | `/ksorder` and the order window, `/ksorder list`, `/ksorder help`, withdrawing your own orders (`/ksorder withdraw` and the **Withdraw** button), and the **Orders** tile on the whisper stone |
| `ks.orders.user.post` | Posting orders in the **New order** tab |
| `ks.orders.user.deliver` | `/ksorder deliver` and the **Deliver** button on the board |
| `ks.orders.user.collect` | `/ksorder collect` and the **Collect all** and **Collect only this** buttons of the pickup box |

To keep a group away from the board completely, set `ks.orders.user.open` to `false`. To let them look but not trade, set `post` and `deliver` to `false`.

:::note[Withdrawing is never blocked]
Withdrawing an own order only needs `ks.orders.user.open`, also when `post` was taken away. A player can always get back the reward they put into escrow.
:::

---

## Admin node (not granted by default)

| Permission | What it unlocks |
|------------|-----------------|
| `ks.orders.admin` | `/ksorderadmin` with all subcommands, and the admin window, also from the **Order Board** tile in the `/ksadmin` hub. In the admin window: removing orders with a reason, posting server orders, deciding unclear bookings, the server box and changing the rules. In the player window: the **Server** choice under **Visibility** in **New order** |

- The admin window checks `ks.orders.admin` on opening and again on every click. Taking the node away closes the window.
- The `/ksadmin` hub needs Core's `ks.admin`; the **Order Board** tile in it also checks `ks.orders.admin`.
- The server console counts as an admin for `/ksorderadmin`. It cannot take goods out of the server box (it has no inventory), but it can discard entries.
- There is no bypass node. Admins cannot open other players' pickup boxes or deliver into their own orders.

---

## Showcase servers

On a KyuubiSoft showcase server (Core's showcase mode), visitors can look at the board but not post or deliver. A visitor who has `ks.orders.admin` there can open the admin window and look at everything, but cannot change anything: no server orders, no removing, no decisions on unclear bookings, no server box and no rule changes. The console is never blocked.

If the showcase check itself fails, the board lets the action through and writes one warning to the server log per start, so a fault there does not stop the board on normal servers.

---

## Fixed rules

No permission and no option changes these:

| Rule | Details |
|------|---------|
| Only fresh items can be delivered | Only plain, undamaged pieces of the wanted item count: nothing enchanted, soulbound or damaged, and no heirlooms |
| Nobody delivers into their own orders | Not even admins |
| Guild orders stay in the guild | Only current members of the guild see a guild order and deliver into it. Membership is checked again at every delivery |
| Direct orders are for one person | Only the person named in the order sees it and delivers into it |
| Server orders are for admins | Only players with `ks.orders.admin` post them. Their reward comes from the server, without escrow |
| Item rewards are undamaged | Reward stacks must be undamaged. Server orders only take plain items as a reward, without special properties |
| The block list counts twice | A blocked item can neither be the wanted item nor part of an item reward, and cannot be delivered |

`/kslang` has no permission.