Metoor's Player Contracts

A fully-featured player-to-player contract system with GUI menus, escrow economy, and smart filtering.

Turn your server into a living marketplace. Players can post item-delivery contracts, set rewards, and let other players fulfill them — all secured by a built-in escrow system powered by Vault.

---

✨ Features

🤝 Contract System

• Create contracts — Request any item, set a reward, choose total or per-item reward mode, and optionally set an expiry duration
• Escrow economy — Rewards are locked from the employer's balance upon creation and only released when the contract is fulfilled. Cancelled or expired contracts refund automatically
• Partial delivery — Workers can deliver items in batches with proportional payouts
• Contract expiry — Contracts automatically expire and refund the employer if the time limit is exceeded

🖥️ Beautiful GUI Menus

All interactions happen through clean, glass-bordered inventory GUIs — no complicated commands needed.

Menu	Description
Main Menu (/con)	Spacious hub with icons for every feature
Open Contracts	Browse available contracts with player head icons
My Active Contracts	Deliver items with a single left or right click
My Listings	View and cancel your own posted contracts
Claim Rewards	Pick up items earned from completed contracts
Contract History	Review past completed, cancelled, or expired contracts
Stats & Profile	See your completion count, total earnings, and listing stats
Language Selection	Switch your language in-game

🏷️ Smart Filtering & Sorting

• Category filter — All / Mining / Farming / Mob Drops / Blocks / Other
• Sort modes — Newest / Highest Reward / Expiring Soon
• Toggle both with a single click from the contract list

👤 Player Head Icons

Every contract shows the employer's player head so you always know who posted it.

🎉 Celebration Effects

Complete or claim a contract and enjoy a burst of particles + a level-up sound!

🔙 Back Buttons

Every sub-menu has a ← Back arrow button for smooth, intuitive navigation.

🌍 Multi-Language Support

Built-in English and Turkish with automatic locale detection. Add your own language in config.yml.

🔄 Live Reload

Admins can reload config without restarting via /con reload.

---

📦 Requirements

Requirement	Details
Server	Paper 1.20.6+ (1.21.x supported)
Java	Java 17+
Economy	Vault + any economy plugin (e.g. EssentialsX)

---

🎮 Commands

Command	Description
/con	Open the main GUI menu
/con open	Browse open contracts
/con active	View your active contracts
/con mine	View your posted listings
/con claim	Claim pending reward items
/con create	Open the contract creation GUI
/con stats	View your stats & profile
/con history	View your contract history
/con language	Change your language
/con reload	Reload config (admin only)
/con cancel <id>	Cancel a contract by ID

---

🔑 Permissions

Permission	Default	Description
playercontracts.use	true	Use all player contract features
playercontracts.admin	op	Access /con reload and admin commands

---

📖 How It Works

1. Employer opens /con create, picks an item, sets amount, reward & duration → clicks Create
2. The reward is locked from their balance instantly
3. Worker finds the contract in Open Contracts, reviews it, and accepts
4. Worker gathers items and delivers via Active Contracts (left-click = all, right-click = partial)
5. On completion, the worker receives the reward and the employer can claim the delivered items
6. If cancelled or expired, the reward is fully refunded

---

🗄️ Storage

Uses SQLite (bundled — zero setup required). All data is stored persistently and legacy databases are auto-migrated.

---

Built with ❤️ by Metoor