BeastAuction

BeastAuction
By the BeastDev Team

A polished auction house and player buy-order system for Paper. Browse the market through chest menus, sell items, and post escrow-backed orders for items you want to buy.

FEATURES

• Search listings by item name and browse by category; manage sales in My Listings.
• Post buy orders and track remaining quantity and escrow.
• Accept partial deliveries. Sellers are paid per delivered amount; items go to the buyer's collection chest in /orders.
• Review confirmation screens before purchases, order creation, deliveries, and cancellations.
• Get on-screen and sound alerts when an item sells or an order is fulfilled.
• Operators can remove listings or orders with a reason. Items are returned, remaining order escrow is refunded, and actions are logged.
• Listings, orders, and deliveries persist across restarts.

REQUIREMENTS & INSTALLATION

1. Paper 1.21.11+ and Java 21.
2. Install Vault and a Vault-compatible economy provider (EssentialsX Economy works).
3. Place BeastAuction.jar in plugins and restart. Data is saved in plugins/BeastAuction/market.yml. Existing DonutMarket market data migrates automatically.

COMMANDS

• /ah — Open the auction house.
• /ah sell <price> — List the item in your main hand.
• /ah cancel <id> — Review and cancel a listing.
• /ah search <item> — Search listings.
• /ah category <all|blocks|ores|food|drops|tools> — Filter listings.
• /ah mine — View your active listings.
• /ah page <number> — Open a page directly.
• /orders — Browse buy orders and collect deliveries.
• /orders create <material> <amount> <unit-price> — Preview and post an order.
• /orders cancel <id> — Cancel an order and refund unused escrow.
• /orders mine — View your open orders and remaining escrow.
• /ah remove <id> <reason> / /orders remove <id> <reason> — Operator-only moderation.

PRICES, ESCROW & PERMISSIONS
Prices and total order escrow are capped at 100 billion. Orders reserve the full amount when posted; partial deliveries pay sellers for delivered items, and cancellation refunds the unfilled portion. Player commands need no special permission. Only server operators can moderate with the remove commands.