AlphaOrder | Player Buy Order Market Sys v1.0

# AlphaOrder | Player Buy Order Market System

Advanced player-driven buy order marketplace for Paper/Folia servers with modern GUIs, partial deliveries, automatic refunds, Discord webhooks, database support, and custom item integration.






━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

AlphaOrder | Professional In-Game Order Market

AlphaOrder is a complete buy-order marketplace plugin for Minecraft servers.

Instead of relying only on direct trades or static shops, players can create purchase orders for the items they need, define the quantity, set the price per item, and let other players fulfill those orders for instant profit.

This creates a real player-driven demand economy and gives farming, mining, gathering, and trading much more value.

Perfect for:
[*] Survival servers
[*] SMP servers
[*] Economy servers
[*] Prison servers
[*] Community-driven servers

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Core Features

Player Buy Order Marketplace

• Players can create buy orders for specific materials or supported custom items
• Each order contains quantity, price per item, and buyer information
• Other players can fulfill those orders and receive money instantly

🖥 GUI + Command Order Creation

• Create orders through an intuitive in-game GUI
• Fast direct creation through command input
• Easy access to order details, player filters, and material filters

Partial and Full Deliveries

• Orders can be completed partially or fully
• Players do not need to finish the entire order at once
• Progress updates automatically as items are delivered

Instant Payment on Delivery

• Players who deliver items are paid immediately
• Creates an active and rewarding economy loop

Delivered Item Collection

• Buyers can collect delivered items from a dedicated collection menu
• Includes a convenient take system for received materials

Highlight System

• Orders can be highlighted for an additional fee
• Highlighted orders stand out more in the market GUI
• Great for urgent or high-value requests

Progress Bar

• Each order tracks completion progress visually
• Helps players quickly understand how much of the order is finished

Automatic Expiration + Refunds

• Orders expire automatically after their configured duration
• Remaining unspent money is refunded safely
• Prevents inactive orders from staying forever

Automatic Broadcasts

• Valuable orders can be broadcast automatically to the server
• Minimum total price threshold is configurable
• Helps draw attention to important market requests

Player Statistics

• Track order creation activity
• Track fulfilled deliveries
• Track collection actions
• Track overall market usage and progression

Multi-System Integration

• Optional PlaceholderAPI support
• Optional LuckPerms support
• Discord webhook support for market events
• Custom item support for supported providers

⚙ Flexible Configuration

• Global and per-item price rules
• Blacklisted items
• Highlight fees
• Broadcast thresholds
• Progress bar appearance
• Auto-save interval
• Database options
• Custom item support options

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Order Workflow

AlphaOrder is designed to keep the market process simple and balanced.

When a player creates an order:

• The plugin validates the material and quantity
• Checks blacklists and logical limits
• Validates price using global or per-item rules
• Verifies active order limits based on permissions
• Checks player balance when required

When the order is accepted:

• The total value is charged immediately
• Highlight cost is added if enabled
• The order is saved to the database
• Player stats are updated
• Optional broadcast is sent for high-value orders
• Optional Discord webhook is triggered

When other players fulfill the order:

• They can deliver partially or fully
• They receive payment immediately
• Progress is updated automatically

When the buyer returns:

• Delivered items can be collected from a dedicated GUI
• Expired unfinished orders automatically refund remaining money

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Stored Order Data

Each order stores detailed information, including:

• Order ID
• Buyer UUID and player name
• Material
• Optional custom item ID
• Requested amount
• Price per item
• Delivered amount
• Collected amount
• Creation time
• Expiration time
• Highlight state
• Order status

Supported order statuses include:

• ACTIVE
• COMPLETED
• CANCELLED
• ARCHIVED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🖥 GUI Menus

Main Menu

• Displays all active orders
• Search support
• Refresh support
• Pagination
• Sorting and filtering options

New Order Menu
- Used to create new purchase orders from inside the GUI

Your Orders Menu

• Shows the player’s own orders
• Helps manage and review active requests

Order Details Menu

• Displays detailed information about a selected order
• Used for fulfillment and viewing progress

Order Take Menu
- Used by buyers to collect delivered items

Sorting Options

• Most Paid
• Most Delivered
• Recently Listed
• Most Money Per Item

Category Filters

• All
• Blocks
• Tools
• Food
• Combat
• Potions
• Books
• Ingredients
• Utilities

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

Player Commands:
Code:

/order
/order create <item> <quantity> <price>
/order id:<id>
/order player:<name>
/order material:<name>

Admin Commands:
Code:

/orderadmin reload
/orderadmin info <id>
/orderadmin delete <id>
/orderadmin player <name> [limit]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

AlphaOrder supports permission-based control for:

• Using the order system
• Administrative access
• Highlight usage
• Dynamic order limits
• Dynamic expiration duration

Examples:
Code:

limit.10
expiration.14

LuckPerms can be used to resolve the highest available limit and expiration values more accurately.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PlaceholderAPI Support

If PlaceholderAPI is installed, AlphaOrder registers placeholders using:

Code:

AlphaOrder

Example placeholders:
Code:

%AlphaOrder_orders_total%
%AlphaOrder_order_<id>_material%
%AlphaOrder_player_totalOrders%

Useful for:

• Scoreboards
• Menus
• Holograms
• Other PlaceholderAPI-compatible plugins

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🗄 Database Support

AlphaOrder supports both local and remote storage.

Available database types:

• SQLite
• MySQL

Database behavior:

• SQLite is supported for default/local setups
• MySQL is supported for external database environments
• If MySQL fails, the plugin can automatically fall back to SQLite

Stored tables:

• orders
• player_stats

Additional database features:

• Periodic auto-saving
• Save on server shutdown

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Dependencies & Integrations

Required:
[*] Vault

Optional:
[*] PlaceholderAPI
[*] LuckPerms
[*] ItemsAdder
[*] Nexo
[*] SmartSpawner

Custom item providers supported:

• ItemsAdder
• Nexo
• SmartSpawner

Discord integration:
- Webhook support for market events, especially new order creation

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🖥 Supported Platform

Required:
[*] Paper
[*] Folia

Recommended for:
[*] Modern economy-based servers
[*] Servers using GUI-driven systems
[*] Servers wanting a real player demand market

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙ Important Configuration Options

AlphaOrder includes support for configuring:

• Database type and connection settings
• Pool settings
• Highlight fee
• Global min/max price per item
• Per-item price rules
• Blacklisted items
• Broadcast enable/disable
• Minimum total price for broadcasts
• Progress bar symbols, colors, and length
• Auto-save interval
• Custom item support

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

1. Install Vault
2. Place AlphaOrder inside your plugins folder
3. Start or restart the server
4. Configure the plugin in config.yml
5. Set up your economy provider
6. Open the market using /order

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why AlphaOrder?

AlphaOrder adds a real demand-based economy layer to your server.

Instead of depending only on shops, random trades, or manual deals, players can request exactly what they need, define a fair price, and let other players respond naturally.

This makes farming, mining, gathering, and trading more meaningful while giving your server a feature that feels modern, useful, and active.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support

Need help, want to report a bug, or have a suggestion?

- Discord: [https://discord.gg/7Sgc7MxA8P /i7zo_]

If you enjoy the plugin, please leave a review!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Create a real player-driven demand market on your server with AlphaOrder.