TownOrders

TownOrders
Wholesale Player Procurement & Global Buy-Order Board Engine
Compatible with 1.20.x - 1.21+ | Universal Vault & TownEconomy Support | 100% GUI Driven

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

What is TownOrders?
Unlike traditional auction houses where players can only sell items they already own, TownOrders introduces a complete reverse-market economy (Wholesale Procurement & Buy Orders).

Need 5,000 Oak Logs or 500 Netherite Ingots for your megaproject? Instead of grinding for days or waiting for auctions to pop up, simply create a Procurement Order (/order create) specifying the requested item, quantity, and unit price. The required funds are securely held in server escrow, and other players can fulfill parts or all of your order for instant cash!

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Flexible Economy Compatibility
TownOrders works on ANY server setup without requiring hard dependencies:

• TownEconomy Integration: Seamless native hook with our standalone TownEconomy engine.
• Universal Vault Support: Don't use TownEconomy? No problem! TownOrders automatically hooks into Vault and supports EssentialsX, CMI, TheNewEconomy, CoinsEngine, and any standard Vault economy provider.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✨ Key Features at a Glance
Interactive Global Order Board (/order)

• Browse Active Demands: View high-demand resource requests posted by other players across the server.
• Categorized Filtering: Filter orders by Building Blocks, Farming, Ores & Minerals, Combat Gear, or Custom Items.
• Partial Deliveries: Players don't need the whole requested amount to get paid! If someone orders 1,000 cobblestone, you can deliver just 64 and instantly receive payment for that stack.

Secure Escrow & Auto-Refunds

• Guaranteed Payouts: When an order is created, the total payment budget is safely locked in server escrow — sellers are always guaranteed instant payment upon delivery.
• Easy Order Management: Buyers can view their active orders, claim delivered items in a secure collection stash, or cancel unfilled orders to receive full refunds.
• Transaction History Log: Track who delivered your items and inspect past order completions.

In-Game Creation Flow

• Simply hold any item in hand or select from the visual item picker.
• Set your desired quantity and price per unit with simple numeric chat/sign input.
• Orders appear immediately on the global board for the whole community to fulfill!

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

⌨️ Commands & Permissions
Player Commands:

• /order (or /orders) - Open the Global Order Board GUI (townorders.use)
• /order create - Create a new procurement buy order for the item in your hand (townorders.create)
• /order my - Open your active orders & collection stash (townorders.use)
• /order history - View recent delivery ledger records (townorders.use)

Admin Commands:

• /order reload - Reload configuration and locale files (townorders.admin)

Permissions:

• townorders.use - Allows players to browse orders, deliver items, and access their collection stash (Default: Everyone)
• townorders.create - Allows players to post new buy orders (Default: Everyone)
• townorders.admin - Access to administrative reload and management commands

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬