🎯 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

Download the latest GigHub.jar
Place in your /plugins/ folder
Restart your server
Configure economy integration (Vault required)
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)

Browse available contracts with /gig list
Accept contracts that match your skills
Complete the work as specified
Submit for verification with /gig complete
Get Paid automatically when approved!

For Server Owners

Players create jobs and services for others
Economy flows between players naturally
Community builds through work relationships
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

Contract Creation GUI - Easy contract setup
Contract Browser - Browse available jobs
My Contracts Panel - Track your work
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