# SimpleRanks<\/p>\n
A lightweight and customizable rank management plugin for PaperMC (1.20.1+).
\nEasily create, assign, and manage colored ranks that appear in chat and the tab list. Compatible with Placeholder API.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– Create unlimited custom ranks
\n– Colored rank prefixes using `&` codes
\n– Show ranks in `chat` and `tab list`
\n– Per-player rank assignment
\n– Default rank support
\n– Optional `importanttext` toggle (white vs gray chat)
\n– Tab completion for commands
\n– Configurable through `config.yml`
\n– Compatible with Placeholder API
\n– Rank hierarchy for tab list
\n– Bracket customization options<\/p>\n
—<\/p>\n
## Configuration (`config.yml`)<\/p>\n
default-rank: default
\nranks: {}
\nplayer-ranks: {}<\/p>\n
> Ranks and players will be added to this file automatically.
\n> Customize rank prefix colors using `&` codes (e.g., `&c[Admin]`).<\/p>\n
—<\/p>\n
## Chat & Tab Display<\/p>\n
Players will have their rank prefix automatically shown:<\/p>\n
– Chat: `[&cAdmin&7] PlayerName: Hello world!`
\n– Tab list: `[&cAdmin&7]PlayerName` or `[&cAdmin&7] PlayerName` if V1.1
\n– Message color: white (`importanttext: true`) or gray (`false`)<\/p>\n
(these are just examples for a red colored Admin rank)<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands use `\/rank`:<\/p>\n
– `\/rank create You can also use `\/r`, as that is the alias for \/rank, for quick and easy use.<\/p>\n —<\/p>\n ## Notes<\/p>\n – Rank colors and brackets show up in chat and tab list # Placeholder API: **%simpleranks_rank%**\tAdmin (RED if prefix is &cAdmin)\tThe colored prefix of the player, no brackets<\/p>\n **%simpleranks_raw_rank%**\t&cAdmin\tThe plain rank name, uncolored, exactly as in the config<\/p>\n **%simpleranks_prefix%**\t[Admin] (Gray brackets and red prefix)\tColored prefix with brackets<\/p>\n **%simpleranks_important%**\ttrue \/ false\tWhether importantText is set for this rank<\/p>\n","protected":false},"excerpt":{"rendered":" Simple rank plugin allowing for custom-colored, ordered ranks in tab list, name tags, chat, and Placeholder API placeholders!<\/p>\n","protected":false},"featured_media":140476,"template":"","meta":{"_minecraft_slug":"simple-ranks","_minecraft_project_id":"IDiHE6wb","_minecraft_author":"TomMustBe12","_minecraft_license":"MIT","_minecraft_downloads":11888,"_minecraft_follows":12,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-ranks.zip","_minecraft_size_bytes":121739,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T01:31:27.393798Z","_minecraft_date_created":"2025-06-19T21:06:21.798136Z","_minecraft_date_modified":"2026-04-29T05:32:59.081978Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-ranks","_minecraft_icon_attachment_id":140476,"_minecraft_imported_at":"2026-06-08T08:08:06+00:00","_minecraft_import_hash":"a9df6dbc996962dbd47425c1a60a4d03","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,867,129,92],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-140475","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `\/rank delete
\n– `\/rank setdefault
\n– `\/rank set
\n– `\/rank give
\n– `\/rank get
\n– `\/rank list` \u2013 List all ranks
\n– `\/rank importanttext
\n– `\/rank bracketcolor
\n– Color codes like `&c`, `&6`, `&l`, etc. are supported
\n– Config saves everything automatically <\/p>\n
\nUsing example rank &cAdmin:<\/p>\n