Chunkwright Orders

What it does

Players post buy orders like 64 diamonds at $150 each. The full price is taken from their balance and held by the plugin. Others browse the board with categories, search, four sorts and progress bars, and deliver from their inventory, all at once or a few at a time, and are paid for every item on the spot. The buyer picks the items up from a Collect menu that survives restarts and full inventories. Cancel and expiry refund what was not paid out. Order limits per permission, min and max price, an item blacklist, an optional fee and tax, staff list and delete, and PlaceholderAPI placeholders. Delivery is duplication safe: our lab races players for the same order, double clicks, closes menus mid-click and stops the server mid-delivery, and items and money always match.

• /orders create <item|hand> <amount> <price-each> with a New Order menu, or confirm to place at once
• New Order button: hold an item, click, type the amount and price in chat
• Full price held in escrow; deliverers are paid per item at once
• Board with 6 categories plus All, search, 4 sorts (best paying, lowest price, newest, most wanted), pages and progress bars
• Deliver menu (1, 16, 64 or all) and /orders deliver <id> [amount|all], partial fills
• Item rules: no renamed, enchanted or damaged items unless allowed, shulker boxes must be empty
• Collect menu for the buyer: one stack or all, safe across restarts and full inventories
• Cancel with refund, expiry with refund (default 7 days)
• Delivery and completion notices, and a summary on join for offline buyers
• Order limits per permission group, min and max price, max amount, item blacklist with * patterns
• Optional order fee (flat plus percent) and delivery tax
• Staff: /orders list [player], /orders delete <id> and a delete button, always with a refund
• Duplication-safe deliveries, tested with players racing for the same order
• Transaction log file and PlaceholderAPI placeholders
• Every message in messages.yml (MiniMessage), commented config, safe background saving

Install

1. Put Orders-1.0.0.jar in your plugins folder.
2. Make sure Vault (or VaultUnlocked) and an economy plugin are installed.
3. Start the server. The plugin writes plugins/Orders/config.yml and messages.yml.
4. Change what you like and run /orders reload. Orders and stored items are kept on reload.

Requirements

• Paper or Purpur 1.21.4 to 26.1
• Java 21+
• Vault or VaultUnlocked with an economy plugin (for example EssentialsX)
• Optional: PlaceholderAPI