SimpleRanks

A lightweight and customizable rank management plugin for PaperMC (1.20.1+).
Easily create, assign, and manage colored ranks that appear in chat and the tab list. Compatible with Placeholder API.

---

Features

• Create unlimited custom ranks
• Colored rank prefixes using & codes
• Show ranks in chat and tab list
• Per-player rank assignment
• Default rank support
• Optional importanttext toggle (white vs gray chat)
• Tab completion for commands
• Configurable through config.yml
• Compatible with Placeholder API
• Rank hierarchy for tab list
• Bracket customization options

---

Configuration (config.yml)

default-rank: default
ranks: {}
player-ranks: {}

Ranks and players will be added to this file automatically.
Customize rank prefix colors using & codes (e.g., &c[Admin]).

---

Chat & Tab Display

Players will have their rank prefix automatically shown:

• Chat: [&cAdmin&7] PlayerName: Hello world!
• Tab list: [&cAdmin&7]PlayerName or [&cAdmin&7] PlayerName if V1.1
• Message color: white (importanttext: true) or gray (false)

(these are just examples for a red colored Admin rank)

---

Commands

All commands use /rank:

• /rank create <rank> – Create a new rank
• /rank delete <rank> – Delete a rank
• /rank setdefault <rank> – Set the default rank
• /rank set <player> <rank> – Set a player’s rank
• /rank give <player> <rank> – Alias for set
• /rank get <player> – View a player’s current rank
• /rank list – List all ranks
• /rank importanttext <rank> true|false – Toggle white/gray message color
• /rank bracketcolor <rank> color - Change a rank's bracket color

You can also use /r, as that is the alias for /rank, for quick and easy use.

---

Notes

• Rank colors and brackets show up in chat and tab list
• Color codes like &c, &6, &l, etc. are supported
• Config saves everything automatically

Placeholder API:

Using example rank &cAdmin:

%simpleranks_rank% Admin (RED if prefix is &cAdmin) The colored prefix of the player, no brackets

%simpleranks_raw_rank% &cAdmin The plain rank name, uncolored, exactly as in the config

%simpleranks_prefix% [Admin] (Gray brackets and red prefix) Colored prefix with brackets

%simpleranks_important% true / false Whether importantText is set for this rank