Custom Ranks

★ 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)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Owner] — Weight 100
[Admin] — Weight 90
[Mod] — Weight 80
[Helper] — Weight 70
[MVP] — Weight 30
[VIP] — Weight 20
[Member] — Weight 0 ← Default rank (auto-assigned)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Player Commands:
/rank info <rank> — View rank details
/rank list — List all ranks
/ranks — Open rank browser GUI

Staff Commands:
/rank get <player> — Check a player's rank
/rank set <player> <rank> — Set a player's rank

Admin Commands (hidden from normal players):
/rank create <id> [prefix] [suffix] [weight]
/rank delete <rank>
/rank setprefix <rank> <prefix>
/rank setsuffix <rank> <suffix>
/rank reload
/rank gui

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DEVELOPER
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Author : Kirtan
Version : 2.0.0
Built with performance, simplicity and server owners in mind.