XyCommunityQuests

Server-Wide Community Quest System

A modern quest system where the entire server works together to complete shared objectives.
Players contribute to global missions such as mining, building, farming, fishing, and combat while competing on contributor leaderboards and unlocking milestone progress together.

Built for survival servers • SMP communities • progression-based gameplay
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Community Quest Menu
The plugin provides a clean and intuitive GUI that displays all active community missions.
Players can easily view active quests, progress bars, rewards, and detailed quest information directly from the menu.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Community-Wide Missions
Every active quest tracks progress across the entire server.
Players contribute through normal gameplay activities such as breaking blocks, placing blocks, harvesting crops, fishing, killing mobs, or simply playing on the server.
The more players participate, the faster the mission progresses.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Milestones & Rush Mode
Community quests include milestone checkpoints that trigger announcements as the server progresses.
Example milestones:
• 25% completion
• 50% completion
• 75% completion
Once the server reaches the configured threshold, the quest enters Rush Mode, multiplying all future contributions and accelerating the final push toward completion.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Top Contributor Rewards
While the quest is shared by the community, the plugin also tracks individual contributions.
At the end of the quest cycle:
• Top contributors receive special rewards
• Participants meeting minimum contribution receive participation rewards
• Rewards can be configured using commands, items, or economy plugins


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Animated Progress Bars
Each quest features a dynamic progress display showing real-time advancement toward the goal.
The animated bar system supports:
• Gradient progress effects
• Smooth animation cycles
• Fully configurable colors and length


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Quest Rotation System
The plugin supports automatic quest rotation so servers always have active missions.
Rotation features:
• Multiple quests active simultaneously
• Automatic reroll when quests complete or expire
• Weekly or timed mission cycles
• Easy configuration through quests.yml


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands
/communityquests
Open the community quest menu.
/communityquestsadmin reload
Reload plugin configuration.
/communityquestsadmin add <player> <questId> <amount>
Manually add progress to a quest.
/communityquestsadmin complete <questId>
Force complete a quest.
/communityquestsadmin reset <questId>
Reset quest progress.
Permission Nodes
communityquests.use
Allows players to open the quest menu.
communityquests.admin
Allows access to administrative commands.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Configuration
The plugin includes multiple configuration files for full control.

config.yml
Main plugin settings, GUI configuration, and progress bar appearance.
quests.yml
Defines all available quests, milestones, goals, and quest behavior.
rewards.yml
Controls participation rewards, leaderboard rewards, and end-of-quest rewards.

All quests can be easily customized to match your server's gameplay style.
Compatibility
Tested Minecraft Version
1.21
Support
Support and feedback can be handled through the Spigot discussion page or through our Discord server.
Join our Discord Support Server
Please test the plugin on your server before deploying it in a live environment, especially if your server runs economy integrations or custom reward systems.
​