GlobalQuests v1.0

GlobalQuests
Quests to be completed by everyone.

Overview
GlobalQuests is a Minecraft plugin that enables players to collaborate on server-wide challenges. Players contribute collectively to complete objectives such as:

1. Mining a specific number of blocks
2. Collecting experience points (EXP)
3. Killing mobs
4. Farming specific items
5. Crafting x amount of items
6. Placing x amount of blocks

All progress is tracked globally, and rewards are given when the quest is completed by the community. The plugin is fully configurable and supports custom quest types, dynamic reward distribution, and persistent data saving using simple JSON files.

Quest Progress
Quest progress is tracked globally, meaning all players on the server contribute to the same active quest. Each player's contributions are also tracked individually, enabling features like top contributor tracking and leaderboard-style rewards.

Reward System
You have full control over how rewards are distributed once a quest is complete:

1. Top Contributors: Configure different rewards for the top 3 contributors.
2. All Participants: Optionally give rewards to everyone who participated.
3. Configurable Logic: Fully adjustable through the plugin’s settings.

Data Storage
All quest and player contribution data is stored locally in a JSON file, ensuring your data survives server restarts without requiring a database. The plugin saves:

1. Current active quest
2. Progress and total contribution amounts
3. Time remaining on the quest
4. Player contribution data

Commands & Permissions
Main Command: [icode]/gquest[/icode]
Aliases: [icode]/gq[/icode], [icode]/quests[/icode]
Permission: [icode]gquest.use[/icode]

Command                          Permission              Description
/gquest forcestart [questName]   gquest.forcestart       Force start a specific quest
/gquests progress                gquest.progress          View current quest progress
/gquests forcecomplete [name]    gquest.forcecomplete     Instantly complete a quest
/gquests cancel [questName]      gquest.cancel            Cancel a quest without rewards
/gquest reload                   gquest.reload            Reload the plugin configuration

Placeholders
Use these with PlaceholderAPI to display quest data anywhere:

1. %gquest_name% - Display name of the quest
2. %gquest_amount% - Current amount completed
3. %gquest_contribution% - Player's contribution
4. %gquest_type% - Type of quest
5. %gquest_amount_required% - Amount required
6. %gquest_progress% - Quest progress bar
7. %gquest_percent% - Completion percentage
8. %gquest_time_remaining% - Time remaining
9. %gquest_leader% - Top contributor
10. %gquest_leader_amount% - Amount by top contributor

Bring your community together!