ColorPrefix

Give your players the power to choose their own rank color — with a beautiful GUI, gradient support, and automatic compatibility with TAB, LPC, and more.

---

Features

Color Selection GUI

Players 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.

Solid Colors & Gradients

Supports single hex colors as well as multi-stop MiniMessage gradients — Adventure interpolates gradient colors per character automatically. Add as many colors as you want in colors.yml with just a few lines.

Automatic Multi-Plugin Support

ColorPrefix detects your installed chat and tab plugins at startup and applies the correct color format for each one — simultaneously. No manual configuration required.

Plugin	Format used	How it's applied
TAB by neznamy 4.x+	MiniMessage (native)	TAB API setPrefix()
LPC	&#RRGGBB per character	LuckPerms prefix node
EssentialsXChat	&#RRGGBB per character	LuckPerms prefix node
ChatControl / Red	&#RRGGBB per character	LuckPerms prefix node
CMI	§x hex per character	LuckPerms prefix node
VentureChat	&#RRGGBB per character	LuckPerms prefix node
None found	—	PlaceholderAPI only

Having TAB and LPC installed at the same time? No problem — both get the right format simultaneously.

PlaceholderAPI Support

Use %colorprefix_prefix% anywhere PlaceholderAPI is supported to render the colored prefix without touching LuckPerms directly.

Placeholder	Returns
%colorprefix_prefix%	Colored LP prefix (wrapped in chosen color)
%colorprefix_tag%	Opening MiniMessage color tag
%colorprefix_close_tag%	Closing MiniMessage tag
%colorprefix_color_id%	ID of the selected color, or none

Multi-Language

Ships 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.

Config Auto-Migration

When you update the plugin, new config keys are added automatically — without ever overwriting your existing settings. The migration runs silently on startup and logs what was added.

---

Installation

1. Drop ColorPrefix.jar into your plugins/ folder
2. Install LuckPerms and PlaceholderAPI (recommended)
3. Restart the server — the plugin detects everything automatically
4. Give players color permissions via LuckPerms (see below)
5. Players use /colorprefix to open the GUI

That's it. No chat format changes needed if you use TAB or LPC.

---

Permissions

Permission	Description
colorprefix.use	Open the color GUI (default: true)
colorprefix.color.<id>	Access a specific solid color
colorprefix.gradient.<id>	Access a specific gradient
colorprefix.color.*	Access all solid colors
colorprefix.gradient.*	Access all gradients
colorprefix.*	Full access including admin commands
colorprefix.admin.reload	Reload config and colors
colorprefix.admin.reset	Reset a player's color
colorprefix.admin.give	Give a color to a player

---

Commands

Command	Permission	Description
/cp	colorprefix.use	Open color GUI
/cp reload	colorprefix.admin.reload	Reload config & colors
/cp reset [player]	colorprefix.admin.reset	Reset a player's color
/cp give <player> <id>	colorprefix.admin.give	Give a color to a player

Aliases: /colorprefix, /color, /farbe

---

Adding Colors

Open colors.yml and add a block — then run /cp reload, no restart needed:

Solid color:

my_color:
  display-name: "My Color"
  permission: "colorprefix.color.my_color"
  gradient: false
  colors:
    - "#FF0099"

Gradient:

my_gradient:
  display-name: "My Gradient"
  permission: "colorprefix.gradient.my_gradient"
  gradient: true
  colors:
    - "#FF0000"
    - "#FF8800"
    - "#FFFF00"

---

Configuration

# Language: en or de (or your own lang/xx.yml)
language: en

# Chat plugin integration
chat-plugins:
  auto-apply: true   # set false to use PlaceholderAPI only

# LuckPerms prefix node weight
luckperms:
  prefix-weight: 100

---

Requirements

• Paper / Purpur 1.21.x
• Java 21+
• LuckPerms (optional but strongly recommended)
• PlaceholderAPI (optional)
• TAB / LPC / EssentialsChat / CMI / etc. (optional — auto-detected)

---

Made with ♥ by itsLarss