Nicknames

Players customize their display name, admins can change other players' names too. Nicks support MiniMessage formatting and automatically affect the chat format and the tablist.

Commands #

Commands7

Command	Syntax	Permission	Default	Description
Set nick	`/nick set <nickname>`	`nick.set`	true	Sets your own nickname
Reset nick	`/nick reset`	`nick.reset`	true	Back to your real player name
Look up nick	`/nick who <nickname>`	`nick.who`	true	Finds the real name behind a nick (ignores color codes and case)
Set other's nick	`/nick setother <player> <nickname>`	`nick.admin`	op	Sets another player's nick
Reset other's nick	`/nick resetother <player>`	`nick.admin`	op	Resets another player's nick
Nick list	`/nick list`	`nick.admin`	op	All active nicks and their owners
Reload	`/nick reload`	`nick.admin`	op	Reloads stored nicks

Additional permissions #

Permissions1

Permission	Default	Description
`nick.minimessage`	true	Allows color and formatting tags in your own nick. Which tags get through is additionally limited by `allow-colors` and `allow-formatting` in `modules/nick.yml`; without the permission or with the switch off, the affected tags are stripped and the nick is set anyway

ℹ️

Note: Click, hover and insertion effects are ALWAYS stripped from nicks, regardless of permissions. Colors and formatting need nick.minimessage (default true) AND the matching switch allow-colors or allow-formatting; if either is missing, the affected tags are stripped when the nick is set. So allow-colors: false turns colors off server-wide without touching permissions. Wherever the nick shows up (chat, tablist, join/leave) the same restrictions apply. A nick must not equal a known player's name or another player's nick; your own real name stays allowed.

💡

Tip: nick.max-length limits the visible text, not the input: <red>Test counts as 4 characters. For team members, the team tablist formatting additionally overrides the nick display (see Teams).

Configuration (modules/nick.yml) #

YAML

# Enables or disables the nick module.
enabled: true

nick:
  # Maximum nick length, measured on the VISIBLE text after removing
  # all formatting codes.
  max-length: 8
  # Only printable ASCII characters plus allowed-symbols in the visible nick
  # (no umlauts, emoji, invisible characters). Full list: see [Nick Characters](nick-chars.html).
  ascii-only: true
  # Extra symbols allowed while ascii-only is on.
  allowed-symbols: "★☆✦✧♥♡♦♣♠•◆◇●○■□▲▼►◄→←↑↓↔♪♫☀☾✓✗❀✿"
  # Allows MiniMessage color tags like <red>, <green> in nicks (on top of
  # the nick.minimessage permission). false strips color tags from new nicks.
  allow-colors: true
  # Allows formatting tags like <bold>, <italic> in nicks, same rule.
  allow-formatting: true

Complete example config #

YAML

enabled: true

nick:
  max-length: 16
  allow-colors: true
  allow-formatting: false

← BackTeams Next →Chat Format