# Nicknames

Spieler passen ihren Anzeigenamen an, Admins auch fremde. Nicks unterstützen MiniMessage-Formatierung und wirken automatisch auf [Chat-Format](chat.md) und [Tablist](tab.md).

## Commands

| Command | Syntax | Permission | Default | Beschreibung |
|---|---|---|---|---|
| Nick setzen | `/nick set <nickname>` | `nick.set` | `true` | Setzt den eigenen Nickname |
| Nick zurücksetzen | `/nick reset` | `nick.reset` | `true` | Zurück zum echten Spielernamen |
| Nick suchen | `/nick who <nickname>` | `nick.who` | `true` | Findet den echten Namen hinter einem Nick (ignoriert Farbcodes und Groß-/Kleinschreibung) |
| Fremden Nick setzen | `/nick setother <spieler> <nickname>` | `nick.admin` | op | Setzt den Nick eines anderen Spielers |
| Fremden Nick zurücksetzen | `/nick resetother <spieler>` | `nick.admin` | op | Setzt einen fremden Nick zurück |
| Nick-Liste | `/nick list` | `nick.admin` | op | Alle aktiven Nicks und Besitzer |
| Neu laden | `/nick reload` | `nick.admin` | op | Lädt gespeicherte Nicks neu |

## Weitere Permissions

| Permission | Default | Beschreibung |
|---|---|---|
| `nick.minimessage` | `true` | Erlaubt Farb- und Formatierungs-Tags im eigenen Nick. Welche Tags durchgehen, begrenzen zusätzlich `allow-colors` und `allow-formatting` in `modules/nick.yml`; ohne das Recht oder bei abgeschaltetem Schalter werden die betroffenen Tags entfernt, der Nick wird trotzdem gesetzt |

> **Hinweis:** Klick-, Hover- und Insertion-Effekte werden IMMER aus Nicks entfernt, egal welche Permission. Farben und Formatierung brauchen `nick.minimessage` (Default `true`) UND den passenden Schalter `allow-colors` bzw. `allow-formatting`; fehlt eines davon, werden die betroffenen Tags beim Setzen entfernt. Mit `allow-colors: false` schaltest du Farben also serverweit ab, ohne Rechte anzufassen. Überall, wo der Nick erscheint (Chat, Tablist, Join/Leave), gelten dieselben Einschränkungen. Ein Nick darf nicht dem Namen eines bekannten Spielers oder dem Nick eines anderen Spielers entsprechen; der eigene Realname bleibt erlaubt.

> **Tipp:** `nick.max-length` begrenzt den sichtbaren Text, nicht die Eingabe: `<red>Test` zählt als 4 Zeichen. Bei Team-Mitgliedern überschreibt die Team-Tablist-Formatierung die Nick-Anzeige zusätzlich (siehe [Teams](teams.md)).

## Konfiguration (modules/nick.yml)

```yaml
# Schaltet das Nick-Modul ein oder aus.
enabled: true

nick:
  # Maximale Länge des Nicks, gemessen am SICHTBAREN Text nach dem
  # Entfernen aller Formatierungs-Codes.
  max-length: 8
  # Nur druckbare ASCII-Zeichen plus allowed-symbols im sichtbaren Nick
  # (keine Umlaute, Emojis, unsichtbare Zeichen). Alle erlaubten Zeichen: siehe [Nick-Zeichen](nick-chars.md).
  ascii-only: true
  # Zusätzlich erlaubte Symbole, solange ascii-only an ist.
  allowed-symbols: "★☆✦✧♥♡♦♣♠•◆◇●○■□▲▼►◄→←↑↓↔♪♫☀☾✓✗❀✿"
  # Erlaubt MiniMessage-Farb-Tags wie <red>, <green> im Nick (zusätzlich
  # zur Permission nick.minimessage). false entfernt Farb-Tags aus neuen Nicks.
  allow-colors: true
  # Erlaubt Formatierungs-Tags wie <bold>, <italic> im Nick, gleiche Regel.
  allow-formatting: true
```

## Komplette Beispiel-Config

```yaml
enabled: true

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