🪐 AliienCommunityQuests

Get your server together with AliienCommunityQuests! This high-performance, fully asynchronous plugin adds global goals where players must collaborate with each other to earn rewards. Whether it's mining blocks, slaying mobs, or crafting items, your community will have to work as a team to get amazing rewards!

Built from the ground up for modern Minecraft servers (Java 21+), it supports massive player bases, real-time objective tracking, and flawless Folia compatibility with zero main-thread lag.

---

✨ Key Features

• Dynamic Quest Rotations: Made with an automated background logic to seamlessly track quest expirations, purge old data, and generate fresh objectives from your configuration pool without any admin intervention.
• Offline Loot Stash: Players who contribute to a community goal but are offline when the quest is completed won't miss out! Their rewards are safely stored in a claimable menu stash for the next time they log in.
• Optional Deepslate Ores Detection: Easily toggle an option to automatically count deepslate variations of ores toward standard ore objectives.
• 100% Customizable GUI: A fully paginated menu that natively supports custom model data, expanding list placeholders, native hex colors, and real-time progress tracking—all protected by strict shift-click and dupe-protection locks.
• Multi Databases Support: Natively supports H2, SQLite, MySQL, and MariaDB (Single-server only). Every single read, write, and reward distribution query is executed asynchronously to ensure your server never skips a tick.
• Extensive Objective Types: Hooks seamlessly into vanilla events. Set community goals for Block Breaking, Entity Killing, Smelting, Breeding, Fishing, Taming, and more!

---

⚙️ Configuration Previews

AliienCommunityQuests is designed to be incredibly easy to configure while offering deep customization. Here is a quick look at how simple it is to set up a rotating quest:

Example quests.yml snippet:

quests:
  weekly-miner:
    settings:
      duration: 7d
      objectives-amount: 1
      objective-format: "&8- &f%target%: %current%/%amount%"
      priority: 1
    menu-options:
      name: "&d&lWeekly Mining Goal &r&7(%time_left%)"
      lore:
        - "&7Work together to mine these blocks"
        - "&7before the week ends!"
        - ""
        - "&dStatus: %status%"
        - ""
        - "&dObjectives:"
        - "%active_objectives%"
        - ""
        - "&dRewards:"
        - "&8- &f$25,000 for all participants"
      material: DIAMOND_PICKAXE
    objectives:
      1:
        type: BLOCK_BREAK
        target: DIAMOND_ORE
        amount: 1500
    rewards:
      - "eco give %player% 25000"

Example settings.yml snippet:

# Display formats for the GUI
time-display: SHORT

status:
  completed: "&a&lCOMPLETED"
  in-progress: "&e&lIN PROGRESS"

# Should deepslate ores automatically count towards regular ore objectives?
count-deepslate-ores: true

---

🚀 Getting Started

Prerequisites

• Java 21 or higher.
• Paper / Folia 1.21 or higher.

Installation

1. Drop the AliienCommunityQuests.jar into your server's plugins folder.
2. Start the server to generate the default configuration files.
3. Configure your database credentials and display preferences in settings.yml.
4. Define your custom objectives and rewards in quests.yml.
5. Restart the server or run /cq admin reload to apply changes!

---

💻 Commands & Permissions

Command	Permission	Description
/cq	aliien.communityquests.menu	Opens the main active quests menu.
/cq admin reload	aliien.communityquests.admin.reload	Reloads configurations and messages without restarting.
/cq admin reset <id>	aliien.communityquests.admin.reset	Forcefully wipes an active quest and triggers a new one.
/cq admin resetall	aliien.communityquests.admin.resetall	Clears all active quests and generates new ones immediately.

Note: Granting aliien.communityquests.admin provides access to all admin subcommands.

---

📚 Documentation & Support

Detailed guides on creating custom quests, formatting your menus, and configuring your database can be found on our official Wiki.

👉 Read the Official Wiki Here

Need help configuring your quests, or found a bug? Join our community!

👉 Join the Aliien's Plugins Discord Server