How orders work

Posting an order

Use /order and the creation wizard, or type it directly:

/order create DIAMOND 64 10.5

That is an order for 64 diamonds at 10.5 each. The wizard also lets players pick enchantments for items that have them, and set the highlight.

• The money is held up front. The total, amount times price, is taken from the player when the order is posted. If they cannot afford it, the order is refused.
• Checks. The player must be under their order limit, the item must not be blacklisted, and the price must be inside the allowed range.
• Staff. Players with alphaorder.admin, and operators, post orders for free and are not held to the order limit.
• Broadcast. A new order whose total reaches settings.broadcast.min-total-price (1000 by default) is announced to the server when broadcast is on.

Browsing

/order opens the browser, a 54-slot menu with sorting, filtering, search and pages. Highlighted orders are listed first. Shortcuts open a filtered view directly:

Filling an order

1. Open an order from the browser and choose to deliver.
2. Place items into the delivery inventory. Only the ordered item is accepted, and wrong items are rejected.
3. Confirm. The payout is amount times the order price, paid instantly through Vault. Items beyond what the order still needs are given back.

A partial delivery is fine, and the order keeps its remaining amount. When the last item arrives the order is marked completed and the buyer is told if they are online.

Your orders

The Your Orders panel shows each of your orders with a progress bar. Delivered items wait there until you collect them. Shift-right-click an order to cancel it.

Cancelling and expiry

• Cancelling refunds the part that has not been delivered, as remaining items times the price.
• An order that reaches its expiry is closed in the same way, with the same refund, and expired rows are cleaned from the database.
• The highlight fee is not refunded.

Highlights

A highlighted order glows in the browser and is listed first. It costs settings.highlight-fee percent of the order total on top of the order itself, so 2.5 means 2.5 percent. Players need alphaorder.highlight, and the features.highlight switch must be on.

Limits and lifetimes

• Order limit. How many orders a player can have at once. The default is 5. Give alphaorder.limit.<number> to change it.
• Lifetime. How long an order lives before it expires. The default is 7 days. Give alphaorder.expiration.<days> to change it.
• The highest matching number wins. With LuckPerms installed the values are read through it.

Price limits

Every order price must fit between min-price-per-item and max-price-per-item in settings. The shipped range is 0.01 to 1000. A section under per-item-price overrides it for one material, and the shipped file does so for the shulker box (20 to 100) and the diamond (10 to 500). Items under blacklist-items cannot be ordered at all.