MrCommunityQuest

---

📖 About the Plugin

MrCommunityQuest is a community-driven quest plugin that brings server-wide challenges and collaborative goals to your Minecraft server. Players work together to complete various tasks, earning rewards based on their contribution.

---

✨ Features

• Community Quests - Server-wide collaborative challenges
• Multiple Quest Types - Break, Place, Donate, and more quest types
• Auto Scheduling - Automatic quest rotation with configurable timers
• Progress Tracking - Real-time progress updates for all players
• Reward System - Position-based rewards with multiple prize tiers
• Customizable GUI - Fully configurable graphical interface
• Vault Integration - Economy support for donate quests
• Persistent Progress - Quest progress saved between restarts
• Gradient Color Support - Beautiful colored GUI titles with hex codes
• PlaceholderAPI Integration - Dynamic placeholders in messages
• Multi-language Support - Localizable messages via messages.yml
• Admin Commands - Full control with /mqc command suite

---

🖼️ Plugin Preview

• Preview images you can find on gallery

---

⌨️ Commands

Player Commands

• /cq – Open the community quest menu
• /cquest – Alternative command to open quest menu

Admin Commands

• /mqc reload – Reload configuration and message files
• /mqc start – Start a new community quest
• /mqc end – End the current community quest
• /mqc list – List all available quests

---

🎯 Quest Types

Break Quests

• Players break specific blocks to contribute to the community goal

Place Quests

• Players place specific blocks to contribute to the community goal

Donate Quests

• Players donate money (via Vault) to contribute to the community goal

Kill Quests

• Players kill specific mobs to contribute to the community goal

---

🏆 Reward System

Position-Based Rewards

• 1st Place - Top contributor receives the best rewards
• 2nd Place - Second highest contributor
• 3rd Place - Third highest contributor
• Participant Rewards - All players who contributed receive rewards

Reward Configuration

• Fully customizable rewards in quests.yml
• Multiple item rewards per position
• Configurable reward amounts and chances

---

🧩 PlaceholderAPI Placeholders

Active Quest Placeholders

• %mrcommunityquests_active_quest_1% - Returns the name of the first active quest
• %mrcommunityquests_active_quest_completed_1% - Returns how much is completed (e.g., 500)
• %mrcommunityquests_active_quest_required_1% - Returns the required amount
• %mrcommunityquests_active_quest_percentage_1% - Returns completion percentage
• %mrcommunityquests_active_quest_myposition_1% - Returns player's position in the quest
• %mrcommunityquests_active_quest_myvalue_1% - Returns player's contribution count
• %mrcommunityquests_active_quest_position_1_1% - Returns the player at position 1 in the quest
• %mrcommunityquests_active_quest_timetoend_1% - Returns minutes until quest ends
• %mrcommunityquests_active_quest_progressbar_1% - Returns a customizable progress bar

General Placeholders

• %mrcommunityquests_active_quests% - Returns the number of active quests
• %mrcommunityquests_quests% - Returns the total number of quests (active and inactive)

Progress Bar Configuration

The progress bar can be customized in messages.yml:

MrCommunityQuest:
  Placeholders:
    ProgressBar:
      Filled: "█"
      Empty: "░"
      Length: 20

Customization Options

• Fully configurable quest goals and rewards
• Custom GUI titles with gradient colors
• Adjustable quest timers and auto-scheduling
• Configurable reward systems
• Localization support for multiple languages

This plugin currently is tested on 1.21.6 and 1.21.8 and is fully functional. (I don't plan to add support for older versions.)