Configuration
Everything is in plugins/BerryOrders/config.yml, with a comment on each setting. /order reload applies changes (aliases need a restart). Colours work everywhere: &a, &l, hex (#E63A35 or &#E63A35) and MiniMessage (<gradient:#E63A35:#A14444>).
Limits
permissions:
order-admin: order.admin
order-limits:
- "order.default:3"
- "order.vip:5"
- "order.mvp:8"
- "order.admin:26"
See permissions.
Prices
pricing:
total: # the whole order: amount x price per item
min: 100.0
max: 999999999.0
per-unit: # one item (-1 = no limit)
min: -1
max: -1
max-amount: 1000000
Players type amounts like 64, 1.5k, 2m.
Item prices for sorting the item picker come from prices.yml, then EssentialsX's worth.yml (set shop: "Essentials" in hooks.yml). prices.yml can also add search words:
prices:
diamond: 100
netherite_ingot:
price: 2500
aliases: [netherite, ingot]
potion:swiftness: 40
How long orders last
duration:
public: 7 # days an order is listed and takes deliveries; then the rest is refunded
expiration: 999 # days until it's removed completely, with anything nobody collected
Typing amounts, prices and searches
input: sign # sign, anvil or chat
sign opens a sign; players type on the first line. The other lines are hints, set in messages.yml (signs:). chat takes the next chat message (cancel to stop).
Menus
| Setting | What it does |
|---|---|
quick-search | /order <item> searches the order list (true), or opens the item picker to place an order (false). |
remember-filters | Each player's sort and filter come back next time. |
skipEnchants | Ordering enchantable gear skips the "pick enchantments" step. |
click-cooldown-ms | Shortest time between two clicks. |
localization | Item names in each player's own Minecraft language. |
fullLorePAPISupport | PlaceholderAPI placeholders in every menu item's lore. |
Orders
| Setting | What it does |
|---|---|
announce | Tells everyone in chat about new orders (order_announcement in messages.yml). |
require-full-durability | Only undamaged tools and armour can be delivered. |
tax.enabled, tax.percentage | Keeps a cut of what deliverers earn. The buyer still pays the full price. |
notifications.enabled | "Bob delivered 64 Diamond to your order" and "you have items to collect". |
notifications.toggle | Lets players turn those off with /order togglenotifications. |
Which items
items.yml turns vanilla items on or off and leaves some out (exempt). blacklist.yml blocks items from being ordered or delivered, by material (DIAMOND_SWORD) or by the key the menus show (potion:swiftness, enchanted_book:mending1).
Discord log
webhook:
enabled: true
url: "https://discord.com/api/webhooks/..."
username: "BerryOrders"
events:
order-create: true
order-deliver: true
order-collect: true
order-expire: true
order-cancel: true
Set server-name so you can tell your servers apart in the log.
Network
cross-server-support, server-name and poll-seconds: see cross-server.