Описание
# 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 ` – Create a new rank
- `/rank delete ` – Delete a rank
- `/rank setdefault ` – Set the default rank
- `/rank set ` – Set a player’s rank
- `/rank give ` – Alias for `set`
- `/rank get ` – View a player’s current rank
- `/rank list` – List all ranks
- `/rank importanttext true|false` – Toggle white/gray message color
- `/rank bracketcolor 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