Introduction
What zQuestRank does and where to start.
zQuestRank is a quest-based rank progression plugin for Spigot and Paper. Players work through a ladder of ranks that you design. Each rank has its own set of quests (break blocks, kill mobs, fish, deliver items, and more) plus extra requirements like money, votes, playtime, or an island level. When everything is done, the player claims the rank, gets the rewards, and the next rank unlocks.
New here? Start with Installation, then build your ladder on Creating ranks.
Quick facts
| Platform | Spigot or Paper, Minecraft 1.18 and newer |
| Java | 17 or newer |
| Hard dependencies | none |
| Optional | Vault (money requirements and rewards), PlaceholderAPI (placeholder quests, requirements, and the plugin's own placeholders) |
| Main command | /rank (aliases /ranks, /zqr) |
How progression works
- A player opens the rank menu with
/rankand clicks their current rank. - The quest menu shows every quest for that rank with live progress.
- Once all quests are done and all extra requirements are met, the Claim Rank button turns green.
- Claiming runs the rewards, announces the promotion in chat (optional), and unlocks the next rank.
Everything is configurable: how many ranks, how many quests per rank, which requirements, which rewards. Nothing is hardcoded.
Feature overview
Rank menu
One icon per rank with locked, current, and completed states, plus a quest menu per rank.
Quests
Seven quest types: block breaking, harvesting, mob kills, crafting, deliveries, fishing, and any numeric placeholder.
Requirements
Money, XP levels, playtime, permissions, and anything PlaceholderAPI can count: votes, island level, job level.
Rewards
Money, XP, items, and console commands, on rank claim and per completed quest.
Where to go next
- Download to get the plugin.
- Installation for the setup steps.
- Creating ranks to design your own ladder in
ranks.yml. - FAQ for common questions, and Support if you are stuck.