Nicknames
Custom nicknames with MiniMessage formatting, blacklist enforcement, and cross-server sync.
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. An AFK indicator prefix can be shown next to the nickname when the player is away.
If the MySQL expansion is installed, nicknames are synchronised across all servers in the network.
Commands
| Command | Description |
|---|---|
/nick <nickname|off> |
Set your nickname. Use off or reset to clear 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 or clear nicknames for other players by targeting them:
/nick <player> <nickname|off>. This uses the essentialsc.nick.others permission.
Configuration
Nickname settings live under the nicknames section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
nicknames.min-length |
Integer | 3 |
Minimum characters for a nickname. |
nicknames.max-length |
Integer | 32 |
Maximum characters for a nickname. |
nicknames.blacklist |
List | [admin, owner, staff] |
Nicknames that players cannot use. |
nicknames.require-unique |
Boolean | true |
Prevent two players from using the same nickname. |
nicknames.afk-indicator |
String | "~ " |
Prefix shown before the nickname when the player is AFK. |
nicknames.update-tab |
Boolean | true |
Update the player's tab list name to match their nickname. |
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.nick |
Set your own nickname. | Everyone |
essentialsc.nick.others |
Set or clear nicknames for other players. | Operators |
essentialsc.nick.format.color |
Use color codes in nicknames. | Everyone |
essentialsc.nick.format.gradient |
Use gradient formatting in nicknames. | VIP |
essentialsc.nick.format.hover |
Use hover events in nicknames. | Operators |
essentialsc.nick.format.click |
Use click events in nicknames. | Operators |
essentialsc.nick.blacklist.bypass |
Use nicknames on the blacklist. | Operators |
essentialsc.realname |
Look up real names by nickname. | Everyone |