DOCS berries.games ↗

Menus

Every menu is a file in plugins/BerryOrders/gui/. Change the title, rows, every button's name, lore, material, slot, custom model data and sound. /order reload applies it.

File Menu
orders.yml /order: every open order, with paging, search, sort and filter
order_delivery.yml Where you put the items you deliver
order_delivery_confirm.yml "Deliver these?"
your_orders.yml Your orders and the new order button
edit_order.yml One of your orders: collect or cancel
edit_order_confirm.yml "Cancel this order?"
collect_items.yml The items delivered to an order
select_item.yml Picking what to order
pick_enchantments.yml Enchantments the ordered gear must have
new_order.yml Amount, price and confirm

Buttons

next:
  name: "#E63A35ɴᴇxᴛ"
  lore:
    - "&fNext page"
  material: "ARROW"
  slot: 53
  customModelData: -1
  sound: click        # a name from sounds.yml

slot can be one number, a list ([0, 8]) or ranges ("0-44"). Leave name blank and lore empty to hide the tooltip (good for glass panes).

Any entry under items: that isn't one of the menu's own buttons is decoration: it's drawn in its slots if they're free. That's how you add borders.

Order icons

actual_order is each order in the lists. Its material is replaced by the ordered item. These placeholders work in its name and lore:

Placeholder
{playerName} Who placed it
{itemAmount}, {itemType}, {itemPrice} How many, what, price each
{currentlyDelivered}, {totalDelivery}, {remaining} Progress
{totalPaid}, {totalPrice} Money paid out so far, and in total
{formattedExpirationTime}, {formattedDeletionTime} Time left
{storedItems} Items waiting to be collected
{orderId} The order's number

Menu titles can use {currentPage} and {maxPages}.

Sort and filter

sort:
  name: "#E63A35sᴏʀᴛ"
  material: "CAULDRON"
  selected_color: "#E63A35"
  unselected_color: "&f"
  bullet_icon: "▪ "
  slot: 47

The options are listed under the name, the current one in selected_color. Click for the next, right-click for the previous. Their names are in messages.yml (sorts:, filters:).

Sorts: most paid, most delivered, recently listed, most money per item. Filters: all, blocks, tools, food, combat, potions, books, ingredients, utilities.