AllianceOrders

# AllianceOrders

Minecraft: 1.8.8 - 1.20+
Java: 8+
Vault: Supported
PlaceholderAPI: Supported
Database: SQLite | MySQL

---

## Video Showcase

YouTube:

---

## What is AllianceOrders?

AllianceOrders is a modern Item Orders & Escrow Contract Plugin for Spigot and Paper servers.

It enables players to request specific resources by offering in-game money, creating an active and dynamic player-driven economy.

### 100% Escrow Guarantee

- No Scams: Money is automatically locked in escrow when an order is created.
- Instant Rewards: Workers receive their payment immediately when items are delivered.
- Safe Item Claiming: Items delivered while the creator is offline or has a full inventory are safely stored in a claim vault using /order claim.
- Full Refunds on Cancellation/Expiry: Creators can cancel unfulfilled orders at any time for an instant refund.

---

## Features

- Multi-Version Native Support (1.8.8 - 1.20+): Works on older PvP/Factions servers and modern Survival/RPG servers.
- Strict Item Matching: Preserves custom names, lores, enchantments, potion effects, NBT, and CustomModelData.
- Flexible Deliveries: Deliver items in stacks of 1, 16, 64, or full inventory.
- SQLite & MySQL: Zero-configuration SQLite or high-performance MySQL with HikariCP.
- Anti-Dupe & Order Locks: Synchronization safeguards prevent race conditions and duplicate exploits.
- Platform Tax: Deduct a configurable server fee percentage from payouts.
- PlaceholderAPI: Full PAPI expansion for Scoreboards, TAB, and chat formatting.

---

## Commands & Permissions

/order
Permission: allianceorders.use
Description: Open the main menu dashboard

/order create
Permission: allianceorders.create
Description: Open the interactive order creation menu

/order search
Permission: allianceorders.use
Description: Browse active market orders

/order mine
Permission: allianceorders.use
Description: View and manage your created orders

/order deliveries
Permission: allianceorders.use
Description: View your delivery history

/order claim
Permission: allianceorders.use
Description: Claim pending delivered items

/order view <id>
Permission: allianceorders.use
Description: View full details of an order

/order cancel <id>
Permission: allianceorders.use
Description: Cancel your order and refund funds

/order reload
Permission: allianceorders.admin
Description: Reload configuration and messages

/order expire
Permission: allianceorders.admin
Description: Force check and process expired orders

---

## Placeholders

%allianceorders_active_orders%
Total active marketplace orders.

%allianceorders_my_orders%
Open orders created by the player.

%allianceorders_my_deliveries%
Deliveries completed by the player.

%allianceorders_reserved_balance%
Balance currently locked in escrow.

%allianceorders_unclaimed_items%
Items waiting to be claimed.

---

## Installation

1. Install Vault and an economy plugin such as EssentialsX.
2. Optional: Install PlaceholderAPI.
3. Place AllianceOrders.jar in your plugins/ directory.
4. Restart your server.