GigHub

🎯 GigHub

Create, accept, and complete contracts with secure escrow payments!

---

📖 Overview

GigHub is a powerful contract management system that allows players to create jobs, accept work from others, and get paid securely through an escrow system. Perfect for economy servers looking to add a structured way for players to offer and complete services!

> ⚠️ ALPHA VERSION - This is an early release. Some features may be incomplete and bugs are possible. Please report issues on GitHub.

---

✨ Key Features

🎪 Contract Types

- 🎯 Custom Tasks - Resource collection contracts - 🎯 Custom Tasks - Construction projects with location requirements - 🎯 Custom Tasks - Monster hunting and PvP tasks - 🎯 Custom Tasks - Crop harvesting and agricultural work - 🎯 Custom Tasks - Custom item delivery contracts - 🎯 Custom Tasks - Create your own contract types

💰 Secure Escrow System

- 🛡️ Fraud Protection - Funds are securely held when contracts are created - 🛡️ Fraud Protection - Contract creators must verify completion before payment - 🛡️ Fraud Protection - Automatic payment to contractors upon verification - 🛡️ Fraud Protection - Built-in dispute resolution system

🎨 Modern GUI Interface

- 🎮 User-Friendly - Intuitive graphical interface for all operations - 🎮 User-Friendly - See contract status changes instantly - 🎮 User-Friendly - No complex command memorization required

🏆 Reputation System

- 🏅 Trust Building - Players build reputation through completed contracts - 🏅 Trust Building - Detailed statistics on completion rates - 🏅 Trust Building - Higher reputation = more contract opportunities

---

🚀 Installation

1. Enjoy! the latest GigHub.jar 2. Enjoy! in your `/plugins/` folder 3. Enjoy! your server 4. Enjoy! economy integration (Vault required) 5. Enjoy! 🎉

Requirements

- Java 17+ - Java 17+ (for economy integration) - Java 17+

💱 Payments & Currency

- GigHub uses only in-game currency through the Vault economy API. - No real money is used anywhere in this plugin. - Rewards and escrow balances come from the player's balance provided by your server's economy plugin (e.g. EssentialsX Economy, CMI, or any Vault-compatible provider). - The escrow system is server-side and only holds/releases in-game funds. - There are no external payment gateways, microtransactions, gambling, or loot boxes.

---

📋 Commands

| Command | Permission | Description | |---------|------------|-------------| | `/gig` | gighub.use | Main contract menu | | `/gig create` | gighub.create | Create new contract | | `/gig list` | gighub.list | Browse available contracts | | `/gig my` | gighub.my | View your contracts | | `/gig accept <id>` | gighub.accept | Accept a contract | | `/gig complete <id>` | gighub.complete | Mark contract as done | | `/gig confirm <id>` | gighub.confirm | Verify & pay for completed work | | `/gig cancel <id>` | gighub.cancel | Cancel your contract | | `/gig info <id>` | gighub.info | View contract details | | `/gig reputation [player]` | gighub.reputation | Check player reputation | | `/gigadmin` | gighub.admin | Administrative commands |

---

🔧 Configuration

Basic Setup

```yaml

config.yml

economy: commission-percentage: 5.0 # % fee taken from each contract

database: type: sqlite # or mysql for larger servers

gui: refresh-interval: 30 # seconds between GUI updates ```

Permissions

- `gighub.*` - All permissions - `gighub.admin.*` - All admin permissions - `gighub.user.*` - All user permissions

---

🎮 How It Works

For Players (Contractors)

1. Get Paid available contracts with `/gig list` 2. Get Paid contracts that match your skills 3. Get Paid the work as specified 4. Get Paid for verification with `/gig complete` 5. Get Paid automatically when approved!

For Server Owners

1. Server activity jobs and services for others 2. Server activity between players naturally 3. Server activity through work relationships 4. Server activity increases with player interaction

---

🐛 Known Issues (Alpha)

- Localization: Large contract lists may cause slight lag - Localization: MySQL optimization needs improvement - Localization: Some animations may be choppy on slower connections - Localization: Currently only English & Russian supported

Planned for v1.1: - Advanced filtering system - Contract templates - Performance optimizations - Multi-language support expansion

---

📞 Support & Feedback

- 📧 Support: 📧 Support - 📧 Support: %%MD1%% - 📧 Support: Discord (coming soon!)

---

📸 Screenshots

*Add screenshots of the GUI interface here*

1. Reputation Display - Easy contract setup 2. Reputation Display - Browse available jobs 3. Reputation Display - Track your work 4. Reputation Display - Player stats overview

---

📜 License

This plugin is released under the MIT License. Feel free to modify and distribute as needed.

---

⭐ Reviews

Help us improve! If you enjoy GigHub, please consider: - ⭐ Leaving a review on SpigotMC - 🐛 Reporting bugs on GitHub - 💡 Suggesting features for future updates

---

Made with ❤️ for the Minecraft community

*GigHub © 2024 - Transform your server's economy today!*