# \ud83d\udcdc ZyraQuests<\/p>\n
> **A fully custom quest plugin with beautiful GUI menus, 6 objective types, flexible rewards, and native ZyraJobs integration \u2014 built for Spigot 1.21.**<\/p>\n
—<\/p>\n
## \u2728 Overview<\/p>\n
**ZyraQuests** lets you create any quest you can imagine directly from a single YAML file \u2014 no commands, no in-game editor required. Players browse quests through polished inventory menus, track their progress in real time via action bar indicators, and earn XP, items, or custom commands as rewards.<\/p>\n
Works perfectly standalone, and unlocks extra features when paired with **ZyraJobs**.<\/p>\n
—<\/p>\n
## \ud83d\udda5\ufe0f GUI Menus<\/p>\n
ZyraQuests is built around three fully interactive inventory menus:<\/p>\n
**\ud83d\udccb Quest Browser** \u2014 Browse all quests sorted by category (Mining, Farming, Hunting, Brewing, General). Each quest shows its difficulty color, objectives count, your current status (not started \/ in progress \/ completed), and a live XP progress bar if active. Paginated for large quest collections.<\/p>\n
**\ud83d\udd0d Quest Detail** \u2014 Opens on click. Shows the full quest description, each objective with its own progress bar, all rewards previewed as items, and the Accept \/ Abandon button. Border color changes based on difficulty (green = Easy, yellow = Medium, red = Hard, orange = Legendary).<\/p>\n
**\u26a1 Active Quests** \u2014 See all your quests in progress at a glance, with per-objective progress bars. Quick-navigate back to any quest’s detail view.<\/p>\n
—<\/p>\n
## \ud83d\udccb Creating Quests<\/p>\n
Everything lives in `quests.yml`. One quest looks like this:<\/p>\n
“`yaml
\nquests:
\n diamond_hunter:
\n display-name: “Diamond Hunter”
\n description:
\n – “The real treasure lies deep below.”
\n – “Find and mine diamonds.”
\n icon: DIAMOND
\n category: MINING
\n difficulty: HARD
\n repeatable: false
\n objectives:
\n – type: MINE_BLOCK
\n block: DIAMOND_ORE
\n amount: 10
\n display: “Mine Diamond Ore”
\n – type: REACH_JOB_LEVEL
\n job: miner
\n level: 20
\n display: “Be Miner Level 20”
\n rewards:
\n – type: XP
\n amount: 20
\n – type: JOB_XP
\n job: miner
\n amount: 1000
\n – type: ITEM
\n material: DIAMOND_PICKAXE
\n amount: 1
\n name: “&b&lDeep Earth Pickaxe”
\n lore:
\n – “&7Forged from the deepest veins.”
\n“`<\/p>\n
That’s it \u2014 reload with `\/qadmin reload` and the quest is live.<\/p>\n
—<\/p>\n
## \ud83c\udfaf Objective Types<\/p>\n
| Type | What it tracks |
\n|——|—————|
\n| `MINE_BLOCK` | Breaking specific blocks underground |
\n| `HARVEST_CROP` | Harvesting fully grown crops |
\n| `KILL_MOB` | Killing any entity by type |
\n| `BREW_POTION` | Brewing potions at a brewing stand |
\n| `COLLECT_ITEM` | Picking up or crafting specific items |
\n| `REACH_JOB_LEVEL` | Reaching a level in ZyraJobs *(ZyraJobs required)* |<\/p>\n
—<\/p>\n
## \ud83c\udf81 Reward Types<\/p>\n
| Type | Effect |
\n|——|——–|
\n| `XP` | Give vanilla experience levels |
\n| `JOB_XP` | Add ZyraJobs XP to a specific job *(ZyraJobs required)* |
\n| `ITEM` | Give an ItemStack with optional custom name & lore |
\n| `COMMAND` | Run any console command with `%player%` placeholder |<\/p>\n
—<\/p>\n
## \ud83d\udd17 ZyraJobs Integration<\/p>\n
ZyraQuests integrates with **ZyraJobs** as a soft-dependency \u2014 install both plugins and the integration activates automatically. No configuration needed.<\/p>\n
When ZyraJobs is present:
\n– `JOB_XP` rewards give XP directly into the player’s job level
\n– `REACH_JOB_LEVEL` objectives track job progression in real time
\n– If ZyraJobs is absent, `JOB_XP` rewards fall back to vanilla XP automatically<\/p>\n
—<\/p>\n
## \ud83d\udcc8 Player Experience<\/p>\n
– \ud83d\udd14 **Level-up style chat message** when a quest is completed, listing all rewards
\n– \ud83d\udcfa **Screen title** on completion
\n– \ud83d\udcca **Action bar progress** updates every time an objective advances
\n– \ud83d\udd0a **Sounds** on quest accept and completion
\n– \ud83d\udd01 **Repeatable quests** \u2014 configure any quest to be completable multiple times
\n– \ud83c\udf10 **Server broadcast** on completion (optional, disabled by default)
\n– \ud83d\udcac **Join message** reminding players of their active quests<\/p>\n
—<\/p>\n
## \ud83c\udff7\ufe0f Quest Difficulties<\/p>\n
| Difficulty | Color | Border |
\n|———–|——-|——–|
\n| Easy | \ud83d\udfe2 Green | Lime glass |
\n| Medium | \ud83d\udfe1 Yellow | Yellow glass |
\n| Hard | \ud83d\udd34 Red | Red glass |
\n| Legendary | \ud83d\udfe0 Orange | Orange glass |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
**`config.yml`** \u2014 Global settings:
\n– `max-active-quests` \u2014 how many quests a player can track at once (default: 3)
\n– `actionbar-progress` \u2014 show action bar updates on objective progress
\n– `sounds` \u2014 toggle all sounds
\n– `broadcast-completion` \u2014 announce completions server-wide
\n– All chat messages fully customizable with color codes<\/p>\n
**`quests.yml`** \u2014 All quests. Add, remove, or edit quests freely. No restart needed \u2014 just `\/qadmin reload`.<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Commands<\/p>\n
| Command | Description | Tab-completion is supported on all commands.<\/p>\n —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## \ud83d\udce6 Requirements<\/p>\n – **Minecraft**: 1.21.x —<\/p>\n ## \ud83e\udd1d Part of the Zyra Suite<\/p>\n ZyraQuests is designed to work alongside **ZyraJobs** as a unified gameplay ecosystem. Install both for the full experience \u2014 quests that reward job XP, objectives that track job levels, and a consistent GUI style across both plugins.<\/p>\n —<\/p>\n ## \ud83d\udc64 Credits<\/p>\n Made with by **sti_moi** \u2014 *zyrajobs’s group*<\/p>\n","protected":false},"excerpt":{"rendered":" free quest plugin for your minecraft server<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"zyraquests","_minecraft_project_id":"FK83oXMS","_minecraft_author":"stimoi","_minecraft_license":"MIT","_minecraft_downloads":4,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"zyraquests.zip","_minecraft_size_bytes":77171,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:31.235074Z","_minecraft_date_created":"2026-04-11T21:18:23.132136Z","_minecraft_date_modified":"2026-03-13T11:32:33.836339Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/zyraquests","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T23:24:29+00:00","_minecraft_import_hash":"33fa8f144c71ecd0a19451d66f67c082","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,129],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-174469","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|
\n| `\/quests [category]` | Open the quest browser |
\n| `\/qadmin reload` | Reload config and all quests |
\n| `\/qadmin list` | List all quest IDs |
\n| `\/qadmin give
\n| `\/qadmin complete
\n| `\/qadmin reset
\n| `\/qadmin info
\n|———–|———|————-|
\n| `zyraquests.use` | Everyone | Access to `\/quests` |
\n| `zyraquests.admin` | OP | Access to `\/qadmin` |<\/p>\n
\n– **Server software**: Spigot or Paper 1.21+
\n– **Java**: 21+
\n– **No required dependencies**
\n– **Optional**: ZyraJobs (for `JOB_XP` rewards and `REACH_JOB_LEVEL` objectives)<\/p>\n