MyColorName

MyColorName

A simple Paper plugin for English and French 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 English and French - `/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: ```text /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` ```yaml 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.