Installation
Requirements, install steps, first run, and the plugin folder layout.
zQuestRank works on its own. Vault and PlaceholderAPI are optional and unlock the money and placeholder features.
Requirements
| Server | Spigot or Paper, Minecraft 1.18 and newer |
| Java | 17 or newer |
| Hard dependencies | none |
Optional plugins
| Plugin | What it unlocks |
|---|---|
| Vault + an economy plugin | MONEY requirements and money rewards |
| PlaceholderAPI | PLACEHOLDER quests and requirements (votes, island level, job level, and so on), plus the plugin's own placeholders |
| ItemsAdder | Custom items as menu icons (itemsadder:namespace:id, see icon formats) |
Without them the rest of the plugin runs normally. A money requirement without Vault can never pass, a placeholder quest without PlaceholderAPI stays at 0, and an ItemsAdder icon without ItemsAdder falls back to a vanilla item.
Install
Drop in the jar
Get the jar (see Download) and put it in your server's plugins/ folder.
Start the server once
zQuestRank generates its files on first start: config.yml, ranks.yml, and the lang/ folder.
Set up your ranks
Edit ranks.yml to build your own ladder. It ships with three example ranks and a comment above every option. See Creating ranks.
Apply without restarting
Edits reload on their own a few seconds after you save (general.auto-reload, on by default), or run /rank admin reload to force it. Then open /rank in game and check the menu.
Folder layout
config.ymlholds general, progression, and menu settings. See Configuration.ranks.ymlis your content: ranks, quests, requirements, rewards. The plugin never rewrites it.lang/holds the messages. See Messages.playerdata/stores each player's rank and quest progress. See Storage.
On updates, config.yml and the lang files are migrated automatically: new keys are merged in without losing your edits. ranks.yml is yours alone: an update only ADDS brand new keys to it (via the ranks-version line) and never changes or deletes your ranks, edits or comments.