Nicknames
Custom nicknames with MiniMessage formatting, blacklist enforcement, and configurable hover and click behaviour.
Overview
Players can set a custom nickname that replaces their username in chat, tab list, and anywhere else EssentialsC displays player names. Nicknames support MiniMessage formatting for colors, gradients, hover events, and click actions. A configurable indicator character is prepended so players can tell nicknames apart from real usernames.
Commands
| Command | Description |
|---|---|
/nick <nickname|off> |
Set your nickname. Use off or clear to remove it. |
/realname [player] |
Look up the real username of a player by their nickname, or check a specific player's real name. |
Admins can set nicknames for other players with
/nick <player> <nickname> (essentialsc.nick.others) and clear them with /nick <player> off (essentialsc.nick.reset).
Configuration
Nickname settings live under the nickname section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
nickname.enabled |
Boolean | true |
Disable the nickname system and unregister /nick. |
nickname.min-length |
Integer | 3 |
Minimum characters for a nickname. |
nickname.max-length |
Integer | 16 |
Maximum characters for a nickname. |
nickname.blacklist-enabled |
Boolean | true |
Enable the nickname blacklist check. |
nickname.blacklist-words |
List | empty | Words that cannot appear in a nickname. |
nickname.normalize-enabled |
Boolean | true |
Normalize input before length and blacklist checks. |
nickname.unique |
Boolean | true |
Prevent two players from using the same nickname. |
nickname.update-tab |
Boolean | true |
Update the player's TAB list entry to show their nickname. |
nickname.indicator |
String | ~ |
Character(s) prepended to nicknames to distinguish them from real usernames. |
nickname.show-realname-on-hover |
Boolean | true |
Show the real username when hovering a nickname in chat. |
nickname.hover-format |
String | <gray>Real name: <white><realname> |
Hover text format. Placeholders: <realname>, <nick>, <prefix>, <suffix>. |
nickname.click-suggest-msg |
Boolean | true |
Clicking a nickname in chat suggests /msg <player>. |
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.nick |
Set your own nickname. | Operators |
essentialsc.nick.others |
Set nicknames for other players. | Operators |
essentialsc.nick.reset |
Reset/remove other players' nicknames. | Operators |
essentialsc.nick.minimessage |
Use MiniMessage tags (colors, gradients) in nicknames. | Operators |
essentialsc.nick.color |
Use legacy colour codes in nicknames. | Nobody |
essentialsc.nick.format |
Use legacy format codes in nicknames. | Nobody |
essentialsc.realname |
Look up real names by nickname. | Operators |