# Nicknames

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

## Commands

| 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` | `false` | Finds the real name behind a nick (ignores color codes and case) |
| Set other's nick | `/nick setother <player> <nickname>` | `nick.admin` | `false` | Sets another player's nick |
| Reset other's nick | `/nick resetother <player>` | `nick.admin` | `false` | Resets another player's nick |
| Nick list | `/nick list` | `nick.admin` | `false` | All active nicks and their owners |
| Reload | `/nick reload` | `nick.admin` | `false` | Reloads stored nicks |

## Additional permissions

| Permission | Default | Description |
|---|---|---|
| `nick.minimessage` | `false` | Lets regular players use color and formatting tags in their nick (admins with `nick.admin` always may) |

> **Note:** Click, hover and insertion effects are ALWAYS stripped from nicks, regardless of permissions. Only colors and formatting can be unlocked via `nick.minimessage`.

> **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](teams.html)).

## 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
  # Allows MiniMessage color tags like <red>, <green> in nicks.
  allow-colors: true
  # Allows formatting tags like <bold>, <italic> in nicks.
  allow-formatting: true
```

## Complete example config

```yaml
enabled: true

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