DOCS berries.games ↗

BerryOrders

Buy orders for your economy. Players post what they want and what they'll pay; anyone can fill it from a menu and get paid on the spot. One server or a whole network, Paper and Folia.

Coming soon. BerryOrders isn't out yet. These docs are a preview of what's coming.

Features

  • Post an order in seconds. /order → Your orders → New order, search the item, type the amount and price on a sign, confirm. The money is set aside straight away, so every order can always pay out.
  • Fill orders from a menu. Search with /order diamond, click an order, drop your items in, close. Anything that doesn't match, or that the order no longer needs, comes straight back.
  • Searches find the right thing. /order iron ingot shows iron ingots first, not copper; exact names first, then names starting with what you typed, then the rest.
  • Exact items. Enchanted books and gear by level ("Sharpness V or better"), every potion in all four forms, ominous bottles. Custom items, filled shulker boxes and look-alikes never count as the real thing.
  • No dupes, no lost money. Every delivery, cancel, expiry and collect is one database transaction that only succeeds once. Two players filling the last slots at the same moment can't both get paid, on one server or across a network.
  • Cross-server. Point your servers at the same MySQL/MariaDB database and they share one order book. Redis makes changes show up instantly; without it servers catch up within a few seconds.
  • Collect and cancel. Delivered items wait in your order until you collect them. Cancelling refunds whatever wasn't delivered. Orders expire on their own and refund too.
  • Limits by rank. order.vip:5, order.mvp:8 and so on.
  • Sign, anvil or chat input, sorting and filters that each player's menu remembers, a chat announcement for new orders, tax on payouts, a Discord webhook log.
  • Everything is yours to change. Every menu title, button, slot, colour and message. Hex colours, & codes and MiniMessage all work.
  • PlaceholderAPI placeholders and an API with cancellable create and deliver events.

Requirements

Server Paper or Folia (and Paper forks like Purpur)
Minecraft 1.21.8 or newer
Java 21 or newer
Economy Vault plus an economy plugin (EssentialsX, CMI, ...)
Optional PlaceholderAPI, EssentialsX worth.yml for item prices
Network (optional) A MySQL or MariaDB database shared by the servers; Redis if you want instant sync

Where to next

  1. Install it.
  2. Set the order limits for your ranks.
  3. Running a network? Read cross-server.
  4. Make the menus yours on the menus page.

Tip: stuck? The FAQ covers the usual questions, and our Discord has a Product Support ticket button.