CustomRanks is a powerful, modern and fully customizable rank system designed for Minecraft servers.
With an extremely clean design and zero unnecessary features, this plugin focuses on speed, flexibility, and easy rank management.

Whether you’re running a small SMP or a large network, CustomRanks gives you complete control over:

✔ Prefixes
✔ Suffixes
✔ Permissions
✔ Inheritance
✔ Chat Format
✔ Tablist Custom Names
✔ Weight-Based Rank Priority

Everything is stored in a simple YAML file. No database needed. No lag.
Just smooth management.


---

✨ FEATURES

Fully Customizable Prefix & Suffix

Use Minecraft color codes, bold, underline, gradients, emojis — anything you like!
Examples:
&6[VIP] &r, &c&l[Owner]&r, &b⭐

Permissions Per Rank

Give ranks unlimited permissions or remove them in one command.

Rank Inheritance

Create advanced rank structures:

Owner → Admin → Mod → Helper → Default

Weight-Based Sorting

Higher weight = higher priority.
Used for sorting and UI display.

Clean YAML Storage

Everything saved in ranks.yml automatically.

No Dependencies

Works without LuckPerms or Vault.
(Compatible with them if you want mixed usage.)

Lightweight & Lag-Free

Only essential operations — optimized for big servers.


---

COMMANDS

/rank create <id>
/rank delete <id>
/rank list
/rank set <id> <display|weight|prefix|suffix> <value>
/rank perms <id> add/remove <permission>
/rank inherits <id> add/remove <parentRank>
/rank give <player> <rank>
/rank remove <player>
/rank info <rank|player>
/rank reload

Permission

customranks.admin


---

️ CONFIG (ranks.yml Example)

ranks:
vip:
display: VIP
weight: 10
prefix: "&6[VIP] &r"
suffix: ""
permissions:
- essentials.fly
inherits: []

players: {}


---

CHAT FORMAT

Automatically formats chat as:

[prefix] Player: Message

Example:

[VIP] Kirtan: Hello everyone!


---

TABLIST FORMAT

Players automatically get:

✔ Prefix
✔ Name
✔ Suffix

Applied on join and rank update.


---

⚡ PERFORMANCE

Async operations used safely

No reflection

No packet hacks

Lightweight permission attachments

Tested on Paper 1.20–1.21.1

Memory usage extremely low



---

UPCOMING FEATURES (Optional)

GUI Rank Editor (Inventory Based)

Rank Badges

Chat Gradient System

MySQL Sync

PlaceholderAPI Support



---

❤️ DEVELOPER

Created by: Kirtan
Made with performance, simplicity and server-owners in mind.


---

INSTALLATION

1. Download the JAR


2. Drop into /plugins/


3. Start your server


4. Configure everything in ranks.yml or use commands


5. Enjoy!