
QuestCL
Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on ModrinthQuestCL 🎯
QuestCL is an ultra-optimized, highly configurable, and feature-rich quest system plugin designed for Minecraft servers. Break away from basic plugins and give your players an engaging, progression-driven experience with multi-stage missions, custom categories, automated tracking, bossbars, and rich GUI menus.
Engineered with future-proof performance in mind, all heavy task evaluations, database queries, and data tracking run asynchronously to guarantee zero TPS impact and protect your server's performance across PaperMC and compatible forks.
✨ Features
- Multi-Stage Mission Engine: Create immersive quests with multiple stages, automated progression (
auto-advance), instant entry tracking (auto-start), and configurable cancellation rules. - Category & Mission Hierarchy: Organized file structure (
categories/folder with individual category YAMLs and subfolders for mission IDs) making management clean and intuitive. - Granular Access Control & VIP Categories: Support for custom category bypass permissions (
questcl.bypass.category.<category_id>), allowing you to lock exclusive categories (such as VIP or event-only tracks) while letting authorized users and operators open and complete them seamlessly. - Diverse Quest Types: Fully supports a wide array of objective types out of the box, including breaking blocks (
break), placing blocks (place), harvesting mature crops (harvest), chopping trees (chop), hunting mobs (kill), catching fish (fish), crafting items (craft), consuming items (consume), and processing statistics (statisticlike jump, played time, distance, etc.). - Interactive Route Menu: Left-clicking any quest opens an automated, beautifully structured "path/route" GUI visualizing all stages (Completed in Lime, In Progress in Yellow, Next in Orange, and Blocked/Locked in Red), while right-clicking instantly starts or cancels the quest.
- Dynamic BossBars: Optional progress bars that track active quest goals and automatically hide when idle for 10 seconds.
- Rich Rewards System & Lore Integration: Reward players upon stage or quest completion with custom console commands, Vault money, experience points, and items. Stage lores cleanly display formatted preview summaries of rewards (Money, XP, and Item rewards) alongside custom generator tools.
- Aesthetic Formatting ("Whispered Elegance"): Default categories and mission lores come styled in the elegant Whispered Elegance small-caps typography, with generator links included across YAML configurations for easy custom translations.
- Flexible Aliases & Commands: Fully customizable command aliases (e.g.,
/q,/misiones,/mision) configured directly inconfig.ymland hot-reloadable with/quest reload. - Robust SQLite Backend & Safety: Asynchronous data management ensures zero data loss during reloads or shutdowns.
- Multi-Language Localization: Built-in English (
en.yml) and Spanish (es.yml) language support inside a modularlan/folder, allowing full customization of every message and the plugin prefix.
💻 Commands & Permissions
Player & General Commands (/quest / /q / Config Aliases)
/quest— Open the main plugin menu (or configured category view)./quest open <category_id>— Open a specific quest category directly (respects category state and bypass permissions)./quest start <category_id> <quest_id>— Manually start a quest (subject to active quest limits)./quest cancel <category_id> <quest_id>— Cancel an active quest and reset current stage progress.
Admin Commands
/quest reload— Reload all configurations, categories, languages, and aliases safely. Perm:questcl.admin.reload/quest category create <category_id>— Create a new quest category. Perm:questcl.admin.create/quest create <category_id> <quest_id> <type>— Create a new mission inside a specific category. Perm:questcl.admin.create/quest complete <category_id> [quest_id] [stage]— Manually complete a category, quest, or specific stage, granting all associated rewards and unlocking the next stage. Perm:questcl.admin.complete/quest restart <category_id> [quest_id] [stage]— Completely reset progress for a player's category, quest, or specific stage. Perm:questcl.admin.restart
Admin & Bypass Permissions
questcl.admin.*— Grants full administrative access to all management commands.questcl.admin.disabled— Allows viewing and opening disabled categories or individual missions.questcl.bypass.category.<category_id>— Allows players to view, open, and participate in a specific disabled or locked category.questcl.bypass.category.*— Grants bypass access to all disabled or locked categories.
🔌 PlaceholderAPI Placeholders
QuestCL registers comprehensive placeholders under the %questcl_...% identifier:
%questcl_progress_<quest_id>_<stage>%— Current numeric progress of a specific quest stage.%questcl_quest_<quest_id>_<stage>%— Status/name representation of the quest stage.%questcl_amount_<quest_id>_<stage>%— Target requirement amount for the stage.
📥 Installation
- Download
QuestCL.jarand place it in your server'splugins/directory. - Ensure Vault (and an economy provider) and PlaceholderAPI are installed for full economic rewards and placeholder support (both optional).
- Start the server to generate the default configuration (
config.yml), language files (lan/en.yml,lan/es.yml), and default categories & sample quests. - Customize your categories, quests, and language strings in the
plugins/QuestCL/folder!
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21.11, 1.21.10, 1.21.9
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
QuestCL is a free Minecraft Java mod. Compatible with Minecraft 1.21.11, 1.21.10, 1.21.9, 1.21.8 and newer. Downloaded 3 times (via Modrinth). Download it and open it directly in the game.