Installation

Requirements

• Java 21
• Paper or Folia
• A server compatible with the Minecraft 1.21 API

KoraQuest detects the platform once during startup and reports either Paper or Folia.

Install the plugin

1. Stop the server completely.
2. Place KoraQuest-1.1.jar inside the server's plugins folder.
3. Start the server.
4. Wait for KoraQuest to create its files.
5. Run /quest to open the menu.
6. Edit the generated configuration files when required.
7. Apply changes with /quest admin reload.

Generated layout:

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

Warning

Avoid Bukkit's /reload. Restart the server or use /quest admin reload for KoraQuest configuration changes.

Optional dependencies

KoraQuest starts without these plugins, but their related features require them:

Plugin	Purpose
PlaceholderAPI	KoraQuest placeholders and external placeholders inside text/rewards
Vault	Economy-based reroll costs and money objectives
PlayerPoints	Point-based rerolls and point balance tracking
Floodgate	Native Bedrock forms
WorldGuard	Region filters and anti-exploit region validation
MythicMobs	Mythic mob filtering and custom entity detection
SuperiorSkyblock2	Island membership validation
BentoBox	Island membership validation
PlotSquared	Plot ownership/membership validation
Citizens	NPC entity detection
mcMMO	Skill experience objective progress
Jobs Reborn	Jobs experience objective progress
VotingPlugin / Votifier	Vote objective progress
ItemsAdder / Oraxen / Nexo	Custom item identifiers
MMOItems / ExecutableItems	Custom item identifiers

First startup checklist

• Confirm the console shows KoraQuest version 1.1.
• Confirm the platform displays Paper or Folia.
• Open /quest and verify all cycle tabs are visible.
• Run /quest admin validate to check quest configuration.
• Confirm your reward commands work from the console.
• Install PlaceholderAPI before using %koraquest_*% placeholders.

Updating an existing installation

KoraQuest includes migrations for supported older configuration layouts.

1. Back up the KoraQuest folder and database.
2. Replace the old JAR.
3. Start the server normally.
4. Review console migration messages.
5. Run /quest admin validate.

Customized quest IDs are preserved. Bundled quest updates only insert missing quest IDs when settings.install-bundled-quest-updates is enabled.