Advanced Rank

AdvancedRank

Simple, beautiful rank management powered by LuckPerms & Vault

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

About AdvancedRank

Managing ranks with raw permission commands can be clunky and slow.
AdvancedRank makes rank management effortless for server owners and staff.

Built directly on top of
LuckPerms and
Vault, it gives you intuitive commands, clean chat & nametag styling, automatic tablist sorting, and instant economy rank-up rewards — all without touching complex permission node syntax or lagging your server.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why You'll Love It

• Easy Rank Commands — Set permanent ranks or timed temporary ranks (like 3d or 1mo) in seconds.
• One-Click Promote & Demote — Move players up or down your ladder with /rank promote and /rank demote.
• Rank-Up Cash Rewards — Give players cash rewards when they earn or buy higher ranks via Vault economy.
• Accident-Proof Rank Deletion — Prevents you from deleting a rank if players are still using it, keeping your permissions clean.
• Organized Tablist — Automatically organizes the player list by rank priority, so Staff and VIPs stay nicely on top.
• Nametag Health Indicator — Clean hearts display right beneath player nametags (can be toggled on/off).
• Modern Colors Everywhere — Use classic color codes (&a, &l), HEX colors (&#rrggbb), or MiniMessage gradients.
• English & Vietnamese Ready — Comes pre-translated in both English and Vietnamese out of the box.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands & Permissions

Base command:
/rank (features full smart tab-completion)

• /rank set <player> <rank> — Set a player's rank permanently (rankplugin.admin)
• /rank temp <player> <rank> <time> — Grant a temporary rank, e.g. 2h, 7d, 2w (rankplugin.mod)
• /rank promote <player> — Promote player to the next ladder rank + give reward (rankplugin.mod)
• /rank demote <player> — Demote player to the previous rank (rankplugin.mod)
• /rank info <player> — View player's rank, prefix, and remaining time (rankplugin.mod)
• /rank remove <player> — Reset player back to default rank (rankplugin.admin)
• /rank list — View all ranks, weights, and rewards (rankplugin.mod)
• /rank listplayers <rank> — See everyone who holds a specific rank (rankplugin.mod)
• /rank create <name> <prefix> — Create a new rank on the fly (rankplugin.admin)
• /rank delete <name> — Safely remove an unused rank (rankplugin.admin)
• /rank reload — Reload config, language, and scoreboards (rankplugin.admin)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration

Everything is customizable in
config.yml:

Spoiler: Click to view config.yml

Code (YAML):

Language setting: "en" (English) or "vi" (Vietnamese)

language
:
"en"

Default rank for new players or when reset

default-rank
:
"guest"

Ladder order for /rank promote and /rank demote

hierarchy
:
 -
"guest"

  -
"member"

  -
"vip"

  -
"mod"

  -
"admin"

  -
"owner"

Configure prefixes, priorities (weight), and rank-up money rewards

ranks:

  guest:

    prefix
:
"&7[Guest] "

    weight
: 10

    reward
: 0.0

  member:

    prefix
:
"&a[Member] "

    weight
: 20

    reward
: 250.0

  vip:

    prefix
:
"&6[VIP] "

    weight
: 30

    reward
: 1000.0

  mod:

    prefix
:
"&9[Mod] "

    weight
: 40

    reward
: 2500.0

  admin:

    prefix
:
"&c[Admin] "

    weight
: 50

    reward
: 5000.0

  owner:

    prefix
:
"&4&l[Owner] "

    weight
: 100

    reward
: 10000.0

Health under nametag

nametag-health:

  enabled
: true

  objective-name
:
"health_display"

  display-text
:
"&c❤"

Tablist format

tablist:

  enabled
: true

  format
:
"%prefix%&f%player%"

Chat formatting

chat:

  enabled
: true

  format
:
"%prefix%&r%player%&7: &f%message%"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Getting Started

• Make sure you have Paper or Purpur (1.21.1 - 1.26.3+) running on Java 21.
• Ensure LuckPerms and Vault (with an economy provider like EssentialsX) are installed.
• Drop AdvancedRank-1.2.0.jar into your plugins folder.
• Restart your server.
• Edit config.yml to fit your ranks, run /rank reload, and you're good to go!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Need help or have suggestions? Open an issue on GitHub!