MyColorName

A simple Paper plugin for Minecraft 1.21.x and 26.1.x that lets each player choose a nickname color through /mycolorname.

• tab nicknames are recolored cleanly
• chat nicknames are recolored in chat messages
• /mycolorname without arguments opens a vanilla Minecraft dialog
• /mycolorname <color> applies a color directly
• /mycolorname help, /mycolorname list, and /mycolorname reset are available
• /mycolorname set <player> <color> lets admins change another player
• /mycolorname all <color> lets admins change every online player
• in-game messages automatically switch between English and French depending on the player's client language

Installation

1. Build the plugin with Gradle.
2. Put the jar into your Paper 1.21.x or 26.1.x server's plugins/ folder.
3. Restart the server.
4. Check that plugins/MyColorName/config.yml is created.

Commands

/mycolorname

Opens the color selection dialog if the sender is a player.

/mycolorname <color>

Changes your own nickname color.
Examples:

/mycolorname red
/mycolorname dark_blue
/mycolorname light_purple

/mycolorname list

Shows the available colors.

/mycolorname reset

Resets your own nickname color.

/mycolorname set <player> <color>

Lets an admin change another online player's color.

/mycolorname all <color>

Lets an admin change the color of every online player.

/mycolorname help

Shows the help message.

Permissions

All permissions below default to true, except the admin permission which defaults to op.

• mycolorname.use - open the dialog
• mycolorname.change - change your own color with /mycolorname <color>
• mycolorname.list - list the available colors
• mycolorname.reset - reset your own color
• mycolorname.admin - change other players or all online players

Configuration

File: plugins/MyColorName/config.yml

allowed-colors:
  - black
  - dark_blue
  - dark_green
  - dark_aqua
  - dark_red
  - dark_purple
  - gold
  - gray
  - dark_gray
  - blue
  - green
  - aqua
  - red
  - light_purple
  - yellow
  - white
respect-existing-list-name: true

allowed-colors

List of colors allowed in the dialog, command, and tab completion.

respect-existing-list-name

• true: if another plugin already set a custom tab name, MyColorName recolors it instead of replacing the text
• false: MyColorName starts from the player's raw Minecraft name

Compatibility

The plugin is designed to stay simple and non-intrusive:

• it depends on no third-party plugin
• it uses native Paper/Adventure APIs
• it recolors the current chat renderer instead of replacing the full format
• it restores tab nicknames on shutdown
  That makes it compatible with plugins like EssentialsX in most cases.

Vanilla dialog

The selection menu uses Minecraft dialogs supported by Paper on both 1.21.x and 26.1.x.
If the client or server cannot open it properly, the command falls back to the text help.