DOCS berries.games ↗

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

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.