ApxOrder

⚡ ApxOrder — Player Marketplace & Buy Orders

💎 Secure • Fast • Player-Driven • Modern Paper 1.21+

Transform your server economy with ApxOrder, a modern player-to-player marketplace built around Buy Orders.

Instead of relying on traditional chest shops or sign shops, players can create custom orders for the items they need, choose their own price, and let other players fulfill those orders directly from their inventories.

Create. Fulfill. Get Paid.

---

🌟 Why ApxOrder?

ApxOrder gives your players a simple and powerful way to trade items without complicated shop setups.

Players can:

• 📦 Create custom Buy Orders
• 💰 Set their own prices
• 🎯 Request specific items and quantities
• ⚡ Fulfill orders directly from their inventory
• 💵 Receive payment instantly after a successful delivery
• 📥 Collect purchased items whenever they want

Every order is backed by a secure escrow system, keeping the buyer's funds protected throughout the transaction.

---

🔥 Core Features

🔒 Secure Vault Escrow

When a Buy Order is created, the required funds are reserved immediately through your server's economy.

• Funds are secured when the order is created
• Unused funds are automatically refunded
• Cancelled and expired orders return remaining funds
• Prevents orders from spending money they no longer have

🛡️ Transaction-Safe Order Processing

ApxOrder is designed to carefully validate every transaction before completing it.

• Thread-safe transaction handling
• Item validation before delivery
• Protection against duplicate fulfilment
• Safe inventory transactions
• Race-condition protection
• Shift-click and inventory interaction handling

ApxOrder is designed to minimize common marketplace and inventory-related exploits.

📦 Unclaimed Item Storage

Players don't have to worry about filling their inventory when completing orders.

Successfully delivered items are stored securely until the buyer is ready to collect them.

Players can simply open the ApxOrder GUI and claim their available items.

📖 Extensive Item Support

ApxOrder supports a wide range of Minecraft items, including:

• Vanilla blocks and items
• Enchanted books
• Potions
• Splash potions
• Lingering potions
• Tipped arrows
• Fireworks
• Custom item data
• And more

⚡ Powerful Database System

Choose the database that fits your server.

SQLite

• Zero configuration
• Easy setup
• Perfect for single-server setups

MySQL / MariaDB

• Designed for larger servers
• Better suited for high-traffic environments
• HikariCP connection pooling
• Ideal for network environments

🎨 Modern & Customizable GUIs

ApxOrder comes with a clean GUI-based marketplace designed for easy navigation.

Features include:

• 🔎 Item search
• 📊 Dynamic sorting
• 🗂️ Category filtering
• 💰 Price information
• 📦 Order details
• 📥 Unclaimed items
• 📈 Order statistics
• ⚙️ Customizable menus

---

🕹️ How ApxOrder Works

1️⃣ Create an Order

Open /order and create a Buy Order for the item you need.

Choose:

• Item
• Quantity
• Price

Once the order is created, the required funds are secured automatically.

2️⃣ Fulfill the Order

Another player finds your order in the marketplace.

They select Deliver and provide the requested items directly from their inventory.

3️⃣ Get Paid

Once the delivery is successfully verified:

The fulfiller receives the order payment instantly.

The delivered items are then added to the buyer's unclaimed storage.

4️⃣ Claim Your Items

The buyer can open the ApxOrder GUI and collect their purchased items whenever they are ready.

---

🎮 Commands & Permissions

👤 Player Commands

/order

Open the ApxOrder marketplace.

Permission: apxorder.use

/order create <item> <amount> <price>

Create a new Buy Order.

Permission: apxorder.create

---

🛡️ Admin Commands

/orderadmin

Open the ApxOrder administration dashboard.

Permission: apxorder.admin

/orderadmin orders

View and manage active server orders.

Permission: apxorder.admin

/orderadmin info <id>

View detailed information about a specific order and its transaction history.

Permission: apxorder.admin

/orderadmin cancel <id>

Force-cancel an order and refund its remaining escrow balance.

Permission: apxorder.admin

/orderadmin reload

Reload ApxOrder configuration, GUI settings, and item catalog.

Permission: apxorder.admin.reload

---

⚙️ Requirements & Compatibility

Supported Platforms

• Paper 1.21+
• Purpur 1.21+
• Pufferfish 1.21+

Java

Java 21+

Required Dependencies

• Vault
• Any Vault-compatible economy plugin

Examples:

• EssentialsX Economy
• Other Vault-compatible economy systems

Optional Dependency

• PlaceholderAPI

---

🚀 Easy Setup

Getting started with ApxOrder takes only a few steps.

1. Install ApxOrder

Place:

ApxOrder-1.0.0.jar

inside your server's:

plugins/

folder.

2. Install Dependencies

Make sure Vault and a compatible economy plugin are installed and running.

3. Restart Your Server

Restart your server to allow ApxOrder to generate its configuration and database files.

4. Start Trading

Players can now use:

/order

to access the marketplace and start creating or fulfilling Buy Orders.

---

💎 Built for Modern Minecraft Economies

Whether you're running a Survival, Lifesteal, Skyblock, SMP, or Economy server, ApxOrder gives players a flexible way to trade without requiring traditional shops.

Let your players decide what they need, how much they're willing to pay, and how they want to trade.

⚡ ApxOrder

Create Orders • Fulfill Orders • Get Paid