Advanced Rank Management for Paper / Spigot 1.21+ Made by: Kirtan
★ CustomRanks v2.0.0 ★
Advanced Rank Management for Paper / Spigot 1.21+
Made by: Kirtan
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CustomRanks is a lightweight and powerful rank management plugin built for Paper and Spigot 1.21+. Full control over player ranks — chat formatting, tablist prefix/suffix, permissions, and in-game GUI — all with zero external dependencies.
New players automatically get the Member rank on first join. Everything is configurable from ranks.yml. No restart needed for changes — just /rank reload.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✔ Unlimited ranks with custom prefix, suffix, display name
✔ Per-rank chat formatting with full color code support
✔ Hex RGB color support using &#RRGGBB syntax
✔ Tablist prefix, suffix and name color per rank
✔ Weight-based tab sorting (highest rank at top)
✔ Inventory GUI — /ranks for players, /rank gui for admins
✔ Per-rank permission list, applied instantly on join/rank change
✔ Auto Member rank assigned to new players on first join
✔ Offline player support — set rank even when player is offline
✔ Smart help system — admin commands hidden from normal players
✔ Hot reload — /rank reload applies all changes live
✔ Lightweight — no external libraries, no reflection, pure Paper API
✔ YAML storage — clean human-readable files, auto-saves on quit
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DEFAULT RANKS (fully editable in ranks.yml)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
customranks.* — All permissions (OP)
customranks.admin — All admin commands (OP)
customranks.set — Set player rank (OP)
customranks.get — Get player rank (OP)
customranks.info — View rank info (Everyone)
customranks.list — List ranks / open GUI (Everyone)
1. Download CustomRanks.jar
2. Drop into /plugins/ folder
3. Start your server
4. Edit plugins/CustomRanks/ranks.yml to customize
5. Use /rank reload to apply changes — no restart needed!
Requirements: Paper / Spigot 1.21+ | Java 21+ | No dependencies