Metoor's Player Contracts
A player-to-player item contract system with GUI menus, escrow economy, category filtering, stats, history, and multi-language support.
Автор: Metoor411обновлён 11 окт. 2026 г.
ЭкономикаОбщениеУтилиты
Описание
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
Последние версии
Все версии →release
Metoor's Player Contracts-1.1
1.111 окт. 2026 г.22Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, paper, purpur, spigot
Что нового
# 🚀 Player Contracts v1.1 — Security, Usability & Analytics Update
This update completely overhauls the input system to eliminate physical world exploits, enhances GUI interaction safety, introduces smart contract naming, and adds official bStats metrics support.
---
### ✨ What's New & Changed
#### 🛡️ Safe Interactive Chat Input System
- **Removed Physical Signs:** Completely eliminated physical world oak sign placement. Players and griefers can no longer break input signs, harvest free items, or trap floating blocks.
- **Interactive Chat Prompts:** Item search, reward, amount, and duration inputs are now safely handled directly via chat.
- **Clickable Cancel Button:** Added a clickable `[❌ Cancel]` component with hover tooltips and command fallback (`/contract cancelinput` or typing `cancel`/`iptal`).
- **Input Timeout:** Automatically cancels inactive input prompts after 60 seconds to prevent state leaks.
#### 🏷️ Meaningful Contract Naming & Localization
- **Dynamic Contract Titles:** Contracts are no longer identified by just a raw number (e.g. `Contract #1`). They now display meaningful item names and quantities (e.g. `Diamond Contract (#1)` / `64x Diamond (#1)`).
- **Comprehensive Placeholders:** Full support for `{id}`, `{amount}`, and `{item}` across all language files.
- **Auto-Migration:** Automatically migrates legacy `config.yml` templates without breaking existing server configs.
- **Robust Regex Extraction:** Contract clicks now parse IDs using smart `#(\d+)` pattern matching regardless of custom title formats.
#### 📦 GUI & Inventory Security Overhaul
- **Duplication & Theft Fix:** Added strict `InventoryDragEvent` protection to prevent players from dragging or stealing items/buttons out of menus.
- **Shift-Click Safeguards:** Isolated bottom inventory interactions and blocked illegal shift-transfers into plugin GUIs.
- **Proper Partial Delivery:**
- **Left-Click:** Deliver all available items in inventory.
- **Right-Click:** Deliver 1 stack (64 items) partially.
- **Shift + Right-Click:** Deliver 1 single item partially.
- **Claim Menu Auto-Refresh:** Claim GUI now properly updates and reopens when partial claims occur due to full player inventory.
- **Back Navigation:** Added a `← Back` button to the item search results browser.
#### 📊 bStats Metrics Integration
- Integrated official **bStats** support.
- Added custom charts for:
- **Default Language Distribution** (`default_language`)
- **Total Contracts Count** (`total_contracts`)
---
### 🔧 Configuration Changes
- Updated `contract_name`, `created`, and `accepted` string keys in `en` and `tr` sections with `{item}` and `{amount}` placeholders.
release
Metoor's Player Contracts-1.0
1.017 сент. 2026 г.19Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
Snapshot Release