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

• ⛏️ Mining - Resource collection contracts
• 🏗️ Building - Construction projects with location requirements
• ⚔️ Combat - Monster hunting and PvP tasks
• 🌾 Farming - Crop harvesting and agricultural work
• 📦 Item Requests - Custom item delivery contracts
• 🎯 Custom Tasks - Create your own contract types

💰 Secure Escrow System

• 🔒 Automatic Payment Holding - Funds are securely held when contracts are created
• ✅ Verification Required - Contract creators must verify completion before payment
• 💸 Instant Payouts - Automatic payment to contractors upon verification
• 🛡️ Fraud Protection - Built-in dispute resolution system

🎨 Modern GUI Interface

• 🖱️ Click-Based Management - Intuitive graphical interface for all operations
• 📊 Real-Time Updates - See contract status changes instantly
• 🎮 User-Friendly - No complex command memorization required

🏆 Reputation System

• ⭐ Rating System - Players build reputation through completed contracts
• 📈 Success Tracking - Detailed statistics on completion rates
• 🏅 Trust Building - Higher reputation = more contract opportunities

---

🚀 Installation

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

Requirements

• Spigot/Paper 1.20.4+
• Vault Plugin (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

# 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. Browse available contracts with /gig list
2. Accept contracts that match your skills
3. Complete the work as specified
4. Submit for verification with /gig complete
5. Get Paid automatically when approved!

For Server Owners

1. Players create jobs and services for others
2. Economy flows between players naturally
3. Community builds through work relationships
4. Server activity increases with player interaction

---

🐛 Known Issues (Alpha)

• Performance: Large contract lists may cause slight lag
• Database: MySQL optimization needs improvement
• GUI: 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

• 🐛 Bug Reports: GitHub Issues
• 💡 Suggestions: GitHub Discussions
• 📧 Support: Discord (coming soon!)

---

📸 Screenshots

Add screenshots of the GUI interface here

1. Contract Creation GUI - Easy contract setup
2. Contract Browser - Browse available jobs
3. My Contracts Panel - 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!