ColorPrefix

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur spigot

标签： decoration management social

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.

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.

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

Commands

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