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
chatandtab list - Per-player rank assignment
- Default rank support
- Optional
importanttexttoggle (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]PlayerNameor[&cAdmin&7] PlayerNameif 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 forset/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
- Added ordered tab list by rank priority (priority: 0 = highest); tab list order stays consistent as players join/leave.
- New command: /rank priority <rank> <num> (alias: /r priority ...) to set priority; can also edit ranks.<rank>.priority in config.yml.
- Added bracket toggle support:
- Global toggle: /rank brackets <on|off> (config: brackets.enabled)
- Per-rank override: /rank brackets <rank> <on|off> (config: ranks.<rank>.brackets)
- Updated tab-completion and command usage text for the new subcommands.
Now supports Placeholder API. Here are the available placeholders used with 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
You can put any color and it will transfer to a color code! Maybe will make this work like that for rank creation too so it's easier to modify and such.
Also added author: TomMustBe12 and website :)
