🎖 zQuestRank
Players climb configurable ranks by completing per-rank quests and requirements, then claim rewards.
By zArrowTan, part of Arrow Plugins.
Players climb configurable ranks by completing per-rank quests and requirements, then claim rewards.
By zArrowTan, part of Arrow Plugins.
OverviewzQuestRank gives your server a real rank progression system. Every player advances through the ranks you define, one at a time, by finishing a set of quests for their current rank and meeting any extra requirements you attach to it (money, votes, playtime, job levels, and so on). When both are done, they click Claim Rank, the rewards fire, and the next rank unlocks. Everything is config-driven, no rank count, quest count, or menu slot is hardcoded.
DependenciesNo required dependencies. zQuestRank runs on its own, drop it in and go. Three optional plugins each unlock more of what it can do:
- Vault (optional) enables money as a rank requirement and money as a reward. Get it here
- PlaceholderAPI (optional) unlocks placeholder quests and placeholder requirements, so votes, job levels, island levels, ScrollQuest counts, or any numeric placeholder from another plugin can gate a rank. Also resolves inside rank and quest
display-name,description, and lore (great for ItemsAdder emojis), and exposes%zquestrank_...%placeholders for scoreboards and tab. Get it here - ItemsAdder (optional) lets you use ItemsAdder custom items as rank and quest icons in the menus. Get it here
The Rank MenuPlayers open
/rank to see every rank on their journey, one clean icon per rank. Locked ranks, ranks they've already earned, and the one they're working on all have their own visual state, so it's always obvious where they are and what's next. Only the current rank is clickable, previous ranks stay viewable but locked from progress, and future ranks are locked until they arrive.Clicking the current rank opens the Quest Menu, all of that rank's quests laid out with objective, live progress, and completion state.
The rank menu, every rank on the ladder at a glance
Hovering the current rank shows its progress and quests
Screenshots use a custom resource pack (menu icons appear recoloured); the default look is standard vanilla items.
Six Quest Types- Break Block: mine cobblestone, break coal, chop logs, collect leaves. Blocks a player placed themselves don't count, no place-and-break cheese
- Harvest: harvest wheat, potatoes, carrots, only fully-grown crops count
- Kill Mob: any mob type, or a specific one (zombies, blazes, ender dragons, and so on). Players are excluded
- Craft Item: craft any item, with shift-click properly counting the full stack
- Deliver Item: bring items back to the quest menu, click to deliver, the items are consumed and progress saves
- Placeholder: tie a quest to any numeric placeholder from another plugin, ScrollQuest counts, job levels, or anything else PlaceholderAPI exposes
A Break Block quest, mine 300 cobblestone
A Deliver Item quest, bring 256 wheat seeds to the menu
🎚 Extra Requirements
Quests alone are the core of it, but you can also gate a rank behind extra prerequisites so a player has to meet them all before Claim Rank works:
- Money via Vault (have it, or optionally take it on claim)
- XP levels (have them, or optionally take them on claim)
- Playtime hours (tracked from the vanilla statistic)
- Permission (grant it via LuckPerms, PermissionsEx, and so on)
- Any placeholder via PlaceholderAPI, gate a rank on votes, island level, job level, ScrollQuest count, anything numeric
Every requirement laid out inside the rank menu
Hovering a locked rank to see exactly what's still needed
Flexible RewardsEvery rank pays out any mix of these when the player claims it:
- Money via Vault
- XP levels
- Items (any material, any amount)
- Console commands with a
{player}placeholder, so you can run LuckPerms rank sets, crate key giveaways, cosmetic unlocks, whatever a command can do - An optional promotion broadcast to global chat, toggleable per rank
Client-Language Item Names (Paper)On Paper servers, quest icons for blocks, items, and mobs render in each viewer's own game language. A French player sees "Blé", a Japanese player sees "小麦", every player reads the quest in their own tongue with no work from you. Spigot servers fall back to clean English names, so nothing breaks.
CommandsMain command
/rank (aliases /ranks, /zqr, all configurable).Players
/rankopen the rank menu
Admin
/rank admin setrank <player> <rank>set a player's rank directly/rank admin resetquests <player>reset a player's current-rank progress/rank admin placeholdertest placeholder values on yourself/rank admin reloadreload all config and language files
🎛 Fully Configurable
ranks.ymlevery rank, its quests, its requirements, and its rewards. Ships with three example ranks, fully commentedconfig.ymlmenu layout, command name and aliases, promotion broadcasts, and general settings- Auto-migrating configs: new keys merge into your files on upgrade without touching your edits
- Rename the command to anything you like (
/prestige,/tiers, and so on) right from the config, no plugin changes needed - Full color support both
&codes and&#rrggbbhex everywhere
Permissionszquestrank.useopen the rank menu (default: everyone)zquestrank.adminall/rank adminsubcommands (default: op)
Requirements- Minecraft: 1.18 and newer
- Server software: Spigot or Paper (Paper unlocks client-language item names)
- Java: 17 or higher
- Languages: English and French bundled, with easy custom translations
Support & DocsFull setup and configuration guides are in the documentation. Need help, found a bug, or want to suggest a feature? Join the Discord.
