HomeJavaModsKoraQuest
KoraQuest
ModsJava

KoraQuest

KORAQUEST Modern, Configurable & Folia-Ready Quest System Create daily objectives, reward players with any command and build a quest system that fits your…

⬇ Download on Spigot

KORAQUEST

Modern, Configurable & Folia-Ready Quest System

Create daily objectives, reward players with any command and build a quest system that fits your server.

[​IMG]

Paper • Purpur • Spigot • Folia • Minecraft 1.21.x

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ABOUT KORAQUEST


KoraQuest is a modern and highly configurable quest plugin designed for Minecraft servers that need a clean, expandable and performance-friendly progression system.

Every quest can be configured directly inside quests.yml, including its title, description, objective, required amount, display material and reward commands.

There are no hardcoded economy, crate or storage dependencies. KoraQuest executes the commands configured by the server owner, allowing it to work with almost any economy, currency, crate, storage or custom server plugin.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

MAIN FEATURES

◆ Fully Configurable Quests
Create and edit quests directly through quests.yml without modifying Java code.

◆ Per-Quest Command Rewards
Each quest contains its own rewards section. Add any console command supported by your server.

◆ Daily Quest Rotation
Generate a new selection of quests every 24 hours with configurable difficulty distribution.

◆ Difficulty System
Organize objectives into Easy, Medium and Hard categories.

◆ Built-In and Custom Objectives
Use automatic event tracking or connect any external plugin through CUSTOM quests.

◆ Secure Inventory Interface
Designed to prevent item extraction through right-click, shift-click, hotbar swapping, drag events, double-clicking, drop keys and creative inventory actions.

◆ SQLite Storage
Player progress and completion data are stored efficiently inside data/data.db.

◆ Multi-Language Support
Player-facing interface and command messages are stored inside the message folder.

◆ Paper and Folia Support
Scheduler handling is separated to support region-threaded Folia servers safely.

◆ Marketplace-Ready Structure
Includes bStats metrics, update checking, a startup banner and organized configuration files.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SUPPORTED QUEST TYPES

KILL Kill a specific entity or any entity.

BREAK Break a configured block or material.

PLACE Place configured blocks.

CRAFT Craft configured items.

FISH Catch fish or complete fishing actions.

ENCHANT Enchant items.

BREED Breed animals.

TAME Tame supported entities.

CONSUME Consume configured items.

SMELT Smelt configured materials.

SHEAR Shear supported entities.

CUSTOM Create any objective and update its progress through commands or another plugin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

QUEST CONFIGURATION

Code (Text):

quests:
easy_zombie_cleaner:
difficulty: easy
type: KILL
target: ZOMBIE
required: 15
material: ROTTEN_FLESH

title: '&#75FF75ᴢᴏᴍʙɪᴇ ᴄʟᴇᴀɴᴜᴘ'
lore:
  - '&#8A8A8AKill &f15 Zombies &#8A8A8Afrom your mob farm.'
  - '&#75FF75Reward: money and MobCoins'

rewards:
  - 'eco give %player% {random:100000-200000}'
  - 'mc give %player% 50'

 

The rewards section only contains console commands. Server owners are free to add commands from any installed plugin.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CUSTOM QUEST EXAMPLE

Code (Text):

quests:
medium_server_vote:
difficulty: medium
type: CUSTOM
target: SERVER_VOTE
required: 3
material: EMERALD

title: '&#FFD36Aꜱᴇʀᴠᴇʀ ꜱᴜᴘᴘᴏʀᴛᴇʀ'
lore:
  - '&#8A8A8AVote for the server &f3 times&#8A8A8A.'
  - '&#FFD36AReward: configured custom commands'

rewards:
  - 'eco give %player% 750000'
  - 'opc give %player% uncommon 1'

 
Update progress from the console or another plugin:

Code (Text):

quest admin progress medium_server_vote 1
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

REWARD PLACEHOLDERS

%player% Player name

%uuid% Player UUID

%quest_id% Internal quest ID

%quest_name% Quest display title

%difficulty% Difficulty ID

%progress% Current progress

%required% Required progress

{random:min-max} Generate a random integer inside a reward command

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FILE STRUCTURE

Code (Text):

plugins/KoraQuest/
├── data/
│ └── data.db
├── message/
│ ├── messages.yml
│ └── messages_en.yml
├── config.yml
└── quests.yml
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERFORMANCE AND SECURITY


KoraQuest was designed with marketplace usage in mind.

Quest progress is stored through SQLite instead of large YAML player files. Database work is separated from gameplay logic, while Bukkit operations remain on the correct server or entity scheduler.

The quest menu cancels inventory interactions and prevents common extraction methods such as shift-clicking, hotbar swaps, item dragging, double-click collection, drop actions and creative cloning.

Inventory refreshes are scheduled outside InventoryClickEvent to reduce client and server desynchronization or duplication risks.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

METRICS


KoraQuest uses bStats to collect anonymous usage statistics.

Metrics can be controlled through:


Code (Text):

metric: true
 
No personal player data, quest contents or database information is collected.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COMPATIBILITY


Minecraft: 1.21.x

Platforms: Spigot, Paper, Purpur and Folia

Java: 21

Storage: SQLite

Required dependencies: None


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


BUILD YOUR OWN QUEST EXPERIENCE

From simple daily objectives to fully custom server progression, KoraQuest gives server owners complete control without locking them into a specific economy or reward plugin.

Developed by Ipsecuz_,discord: Habitat_

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

KoraQuest is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 15 times (via Spigot). Download it and open it directly in the game.

Explore more