Simple Ranks

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