Metoor's Player Contracts
A player-to-player item contract system with GUI menus, escrow economy, category filtering, stats, history, and multi-language support.
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
- Employer opens
/con create, picks an item, sets amount, reward & duration → clicks Create - The reward is locked from their balance instantly
- Worker finds the contract in Open Contracts, reviews it, and accepts
- Worker gathers items and delivers via Active Contracts (left-click = all, right-click = partial)
- On completion, the worker receives the reward and the employer can claim the delivered items
- 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
Сервер для плагина Metoor's Player Contracts - как у профи
Плагин Metoor's Player Contracts создан для серверов: на своём сервере вы настраиваете его под себя и решаете, кому играть. Создать сервер с плагином Metoor's Player Contracts для друзей можно за пару минут - BungeeHost всё уже подготовил.