JobNexus

# ✦ JobNexus — Player-to-Player Job Board **Let your players hire each other.** JobNexus adds a fully GUI-driven marketplace where players can post jobs, accept contracts, and earn rewards all without dropping items on the ground or risking scams. --- ## 🎯 What Does It Do? A player needs 1,024 Stone but doesn't want to mine it. They open `/jobs post`, set the item, amount, and reward — and the money is **held in escrow** by the plugin. Another player sees the job on the board, accepts it, gathers the stone, and delivers it through a secure GUI. The reward is paid out **automatically**. No trust required. --- ## ⚡ Features ### 📋 The Job Board (`/jobs`) - Browse all open jobs in a clean, decorated chest GUI - See the item needed, amount, reward, who posted it, and time remaining - Click to accept — the job is locked to you ### ⚒ Job Creation Wizard (`/jobs post`) - 4-step guided GUI: **Item → Amount → Reward → Confirm** - Only items whitelisted in `config.yml` can be requested (admin-controlled) - Money is taken upfront as **escrow** — workers are guaranteed payment ### ★ Active Jobs Menu (`/jobs active`) - Track your posted and accepted jobs with visual **progress bars** - **Left-click** an accepted job to open the delivery GUI - **Right-click** to abandon a job (returns it to the board) - Cancel your own posted jobs and get a full refund ### 📦 Smart Delivery System - Drop items into the delivery GUI and click "Deliver" - **Strict validation** — wrong items are rejected with a warning - **Progressive delivery** — deliver in batches, progress is saved - Items are **safely returned** if you close the GUI ### ♛ Leaderboard - View the top workers on the server - Workers earn **reputation** for each completed job - Trophy display with 🥇🥈🥉 rankings ### 🔔 Notifications - Employers get notified when someone **accepts** or **completes** their job - New job postings are **broadcast** to the entire server - Sound effects on every major action --- ## 🛡️ Anti-Abuse | Protection | How It Works | |---|---| | **Escrow System** | Money is locked when posting — no scams possible | | **Item Validation** | Only the exact material is accepted — renamed items are rejected | | **Post Limits** | Configurable max active posts per player | | **Accept Limits** | Configurable max jobs a player can work on at once | | **Self-Accept Block** | Players cannot accept their own jobs | --- ## 📝 Commands | Command | Description | Permission | |---|---|---| | `/jobs` | Open the Job Board | `jobnexus.use` | | `/jobs post` | Create a new job | `jobnexus.post` | | `/jobs active` | View your active jobs | `jobnexus.active` | | `/jobs reload` | Reload configuration | `jobnexus.admin` | | `/jobs help` | Show help menu | `jobnexus.use` | **Aliases:** `/job`, `/jn` All commands support **tab completion**. --- ## ⚙️ Configuration Admins have full control over: - **Whitelisted items** — choose exactly which items can be requested - **Tax rate** — server takes a configurable percentage of each payout - **Job expiry time** — how long jobs stay on the board - **Post/Accept limits** — prevent spam - **Currency symbol & name** — customize for your server - **All messages** — fully configurable with color codes --- ## 📦 Dependencies | Plugin | Required? | |---|---| | **Vault** | Required | | **Economy Plugin** (EssentialsX, LiteEconomy, etc.) | Required | --- ## 💡 Why Server Owners Love This - **Player Retention** — gives players a reason to interact and log in daily - **Economic Balance** — money flows between players instead of infinite server shops - **Zero Scam Tickets** — the plugin handles everything securely - **Lightweight** — GUI-based, no entities, no lag - **No Textures Required** — works 100% with vanilla Minecraft --- ## 🔧 Compatibility - **Minecraft:** 1.21+ - **Server Software:** Paper, Spigot, Purpur, Folia-compatible - **Java:** 8+