zQuestRank | Quest-Based Ranks 1.2.0

📋 Overview

zQuestRank 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.

🧩 Dependencies

No 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 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 Menu

Players 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 Rewards

Every 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.

⌨️ Commands

Main command /rank (aliases /ranks, /zqr, all configurable).

Players

• /rank open 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 placeholder test placeholder values on yourself
• /rank admin reload reload all config and language files

🎛 Fully Configurable

• ranks.yml every rank, its quests, its requirements, and its rewards. Ships with three example ranks, fully commented
• config.yml menu 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 &#rrggbb hex everywhere

🔐 Permissions

• zquestrank.use open the rank menu (default: everyone)
• zquestrank.admin all /rank admin subcommands (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 & Docs

Full setup and configuration guides are in the documentation. Need help, found a bug, or want to suggest a feature? Join the Discord.