DOCS berries.games ↗

Installation

Install

  1. Install Vault and an economy plugin (EssentialsX, CMI, ...) if you don't have them.
  2. Download BerryOrders.jar from BuiltByBit. One jar works on both Paper and Folia.
  3. Put it in your server's plugins/ folder and restart (don't use /reload).
  4. Join and run /order.

On first start BerryOrders creates its folder:

plugins/BerryOrders/
├── config.yml       limits, prices, durations, input, tax, webhook
├── databases.yml    SQLite or MySQL, Redis
├── messages.yml     every chat message and sign prompt
├── hooks.yml        where item prices come from, the currency
├── items.yml        which vanilla items can be ordered
├── blacklist.yml    items nobody can order or deliver
├── prices.yml       your own item prices and search aliases
├── sounds.yml       menu sounds
├── orders.db        the orders (with the default SQLite storage)
└── gui/             one file per menu

Coming from another orders plugin

The config files use the same keys and the menus the same slots as the most popular orders plugin, so you can bring your old config.yml, messages.yml and gui/ values across. Orders themselves aren't imported; let the old ones expire first.

Updating

Replace the jar and restart. Your files are never overwritten: new settings and messages are added to them with their comments, and nothing you changed is touched.

Heads up: command aliases need a restart. Everything else applies with /order reload.