# ColorPrefix<\/p>\n
**Give your players the power to choose their own rank color \u2014 with a beautiful GUI, gradient support, and automatic compatibility with TAB, LPC, and more.**<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Color Selection GUI
\nPlayers open a sleek inventory GUI (`\/colorprefix`) showing all colors they have permission for. Leather chestplates serve as dyed previews, the active color glows, and pagination handles large color lists cleanly.<\/p>\n
### Solid Colors & Gradients
\nSupports single hex colors as well as multi-stop MiniMessage gradients \u2014 Adventure interpolates gradient colors per character automatically. Add as many colors as you want in `colors.yml` with just a few lines.<\/p>\n
### Automatic Multi-Plugin Support
\nColorPrefix detects your installed chat and tab plugins at startup and applies the correct color format for each one \u2014 simultaneously. No manual configuration required.<\/p>\n
| Plugin | Format used | How it’s applied |
\n|—|—|—|
\n| TAB by neznamy 4.x+ | MiniMessage (native) | TAB API `setPrefix()` |
\n| LPC | `&#RRGGBB` per character | LuckPerms prefix node |
\n| EssentialsXChat | `&#RRGGBB` per character | LuckPerms prefix node |
\n| ChatControl \/ Red | `&#RRGGBB` per character | LuckPerms prefix node |
\n| CMI | `\u00a7x` hex per character | LuckPerms prefix node |
\n| VentureChat | `&#RRGGBB` per character | LuckPerms prefix node |
\n| None found | \u2014 | PlaceholderAPI only |<\/p>\n
Having TAB **and** LPC installed at the same time? No problem \u2014 both get the right format simultaneously.<\/p>\n
### PlaceholderAPI Support
\nUse `%colorprefix_prefix%` anywhere PlaceholderAPI is supported to render the colored prefix without touching LuckPerms directly.<\/p>\n
| Placeholder | Returns |
\n|—|—|
\n| `%colorprefix_prefix%` | Colored LP prefix (wrapped in chosen color) |
\n| `%colorprefix_tag%` | Opening MiniMessage color tag |
\n| `%colorprefix_close_tag%` | Closing MiniMessage tag |
\n| `%colorprefix_color_id%` | ID of the selected color, or `none` |<\/p>\n
### Multi-Language
\nShips with **German** (`de`) and **English** (`en`). All messages and GUI texts are fully configurable via MiniMessage. Add your own language by dropping a `lang\/xx.yml` into the plugin folder.<\/p>\n
### Config Auto-Migration
\nWhen you update the plugin, new config keys are added automatically \u2014 without ever overwriting your existing settings. The migration runs silently on startup and logs what was added.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Drop `ColorPrefix.jar` into your `plugins\/` folder
\n2. Install LuckPerms and PlaceholderAPI *(recommended)*
\n3. Restart the server \u2014 the plugin detects everything automatically
\n4. Give players color permissions via LuckPerms (see below)
\n5. Players use `\/colorprefix` to open the GUI<\/p>\n
That’s it. No chat format changes needed if you use TAB or LPC.<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Description | —<\/p>\n ## Commands<\/p>\n | Command | Permission | Description | Aliases: `\/colorprefix`, `\/color`, `\/farbe`<\/p>\n —<\/p>\n ## Adding Colors<\/p>\n Open `colors.yml` and add a block \u2014 then run `\/cp reload`, no restart needed:<\/p>\n **Solid color:** **Gradient:** —<\/p>\n ## Configuration<\/p>\n “`yaml # Chat plugin integration # LuckPerms prefix node weight —<\/p>\n ## Requirements<\/p>\n – Paper \/ Purpur 1.21.x —<\/p>\n *Made with \u2665 by itsLarss*<\/p>\n","protected":false},"excerpt":{"rendered":" Give your players the power to choose their own rank color \u2014 with a beautiful GUI, gradient support, and full compatibility with LuckPerms and PlaceholderAPI.<\/p>\n","protected":false},"featured_media":44161,"template":"","meta":{"_minecraft_slug":"colorprefix","_minecraft_project_id":"y1Ojzk0t","_minecraft_author":"itsLarss_","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":27,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"colorprefix.zip","_minecraft_size_bytes":86276,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:13:08.201167Z","_minecraft_date_created":"2026-04-02T21:42:21.795994Z","_minecraft_date_modified":"2026-04-24T03:10:48.406316Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/colorprefix","_minecraft_icon_attachment_id":44161,"_minecraft_imported_at":"2026-06-02T01:55:51+00:00","_minecraft_import_hash":"176a2055a8b13852675a57390fa3b85a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,126,127,128,867,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-44160","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\n
\n|—|—|
\n| `colorprefix.use` | Open the color GUI *(default: true)* |
\n| `colorprefix.color.
\n| `colorprefix.gradient.
\n| `colorprefix.color.*` | Access all solid colors |
\n| `colorprefix.gradient.*` | Access all gradients |
\n| `colorprefix.*` | Full access including admin commands |
\n| `colorprefix.admin.reload` | Reload config and colors |
\n| `colorprefix.admin.reset` | Reset a player’s color |
\n| `colorprefix.admin.give` | Give a color to a player |<\/p>\n
\n|—|—|—|
\n| `\/cp` | `colorprefix.use` | Open color GUI |
\n| `\/cp reload` | `colorprefix.admin.reload` | Reload config & colors |
\n| `\/cp reset [player]` | `colorprefix.admin.reset` | Reset a player’s color |
\n| `\/cp give
\n“`yaml
\nmy_color:
\n display-name: “My Color”
\n permission: “colorprefix.color.my_color”
\n gradient: false
\n colors:
\n – “#FF0099”
\n“`<\/p>\n
\n“`yaml
\nmy_gradient:
\n display-name: “My Gradient”
\n permission: “colorprefix.gradient.my_gradient”
\n gradient: true
\n colors:
\n – “#FF0000”
\n – “#FF8800”
\n – “#FFFF00”
\n“`<\/p>\n
\n# Language: en or de (or your own lang\/xx.yml)
\nlanguage: en<\/p>\n
\nchat-plugins:
\n auto-apply: true # set false to use PlaceholderAPI only<\/p>\n
\nluckperms:
\n prefix-weight: 100
\n“`<\/p>\n
\n– Java 21+
\n– LuckPerms *(optional but strongly recommended)*
\n– PlaceholderAPI *(optional)*
\n– TAB \/ LPC \/ EssentialsChat \/ CMI \/ etc. *(optional \u2014 auto-detected)*<\/p>\n