FrozenOrders

A powerful, fully-featured player order system for Paper & Folia servers. Players post buy orders for items, other players fulfill them and get paid — creating a natural, player-driven economy loop.

---

🧊 What is FrozenOrders?

FrozenOrders lets players place buy orders for any item in the game. Other players can browse open orders, deliver matching items, and earn money instantly. It's a seamless bridge between buyers and sellers without needing a traditional auction house or shop plugin.

---

✨ Features

• Full GUI System — Browse, create, manage, and deliver orders through a clean inventory interface
• Player-Driven Economy — Buyers lock in funds upfront; deliverers get paid instantly on delivery
• Order Expiry System — Orders automatically expire and get cleaned up after configurable durations
• Enchantment Support — Orders can specify exact enchantments required on items
• Sort & Filter — Browse orders sorted by most paid, most delivered, recently listed, or price per item; filter by item category
• Search — Search orders by item name
• Cross-Server Support — MySQL backend for BungeeCord / Velocity network setups
• Folia Support — Fully compatible with Folia's regionized threading
• PlaceholderAPI Ready — Integrates with economy plugins via Vault or FrozenVault
• Per-Player Order Limits — Configurable limits per permission group
• Announcement System — Broadcasts new orders to all online players
• Fully Configurable — Messages, GUI layouts, sounds, colors, expiry times, price limits, and disabled items are all configurable
• SQLite by Default — Zero setup required out of the box; switch to MySQL in config whenever ready

---

📋 Commands

Command	Description
/order	Open the FrozenOrders main menu
/order reload	Reload plugin configuration

---

🔑 Permissions

Permission	Description	Default
frozenorders.use	Access to /order	Everyone
frozenorders.admin	Full admin access + bypass restrictions	OP
frozenorders.8	Up to 8 active orders (default)	Everyone
frozenorders.10	Up to 10 active orders	False
frozenorders.15	Up to 15 active orders	False
frozenorders.25	Up to 25 active orders	False
frozenorders.max	Unlimited active orders	OP

---

⚙️ Requirements

• Paper 1.21+ or Folia 1.21+
• Java 21+
• Vault (or FrozenVault) + a compatible economy plugin

---

🗄️ Database

• SQLite — enabled by default, no setup needed
• MySQL — enable in config.yml for multi-server networks

---

📦 How It Works

1. A player opens /order and creates a new order — selecting an item, amount, and price per item
2. The total cost is charged from their balance upfront
3. Other players browse open orders in the main GUI and deliver matching items
4. Deliverers are paid instantly per item delivered
5. The order owner collects their delivered items from their order panel
6. Once fully filled or expired, the order closes automatically

---

🧑‍💻 Author

Made by DrFrozenXD