Minecraft-Plugin NametagEdit

🔌 Über NametagEdit

NametagEdit ist ein Minecraft-Plugin, mit dem Serveradministratoren den Text ändern können, der über den Köpfen der Spieler angezeigt wird, und wie Spieler in der Server-Tab-Liste erscheinen. Das Plugin bietet konfigurierbare Präfixe und Suffixe (pro Spieler oder pro Gruppe), unterstützt Farbformatierung einschließlich Hex-Farben in unterstützten Versionen und kann Tags in der Tab-Liste sortieren oder anwenden.

🎯 Zweck

NametagEdit löst das Problem begrenzter oder statischer Spielernamenanzeigen, indem es dynamische, berechtigungsbasierte Präfixe/Suffixe und eine Sortierung der Tab-Liste ermöglicht. Es richtet sich an Serverbesitzer und Admins, die eine kosmetische Unterscheidung von Namen, rangbasierte Labels oder eine flexiblere Sortierung der Tab-Liste wünschen, ohne die Skins oder Kontonamen der Spieler zu ändern.

⚙️ Funktionen

• Konfigurierbares Präfix und Suffix für einzelne Spieler oder benannte Gruppen.
• Anpassung der Namen in der Tab-Liste und sortierbare Gruppen-/Spieler-Tags.
• Hex-Farben werden in modernen Minecraft-Versionen unterstützt (bestätigt ab 1.16+).
• Integrationen mit beliebten Berechtigungs- und Gruppensystemen, damit Tags automatisch aktualisiert werden, wenn sich die Gruppe eines Nutzers ändert.
• Speicher-Backends und Migrationswerkzeuge: FlatFile-Unterstützung mit Konvertern und MySQL-Unterstützung mit Connection Pooling.
• Placeholder-Unterstützung über gängige Placeholder-APIs (in der offiziellen Dokumentation aufgeführt).
• Entwickler-API für Plugin-Autoren, um mit den Funktionen von NametagEdit zu interagieren.

🧩 Für wen es gedacht ist

• Serveradministratoren, die visuelle Tags pro Spieler oder pro Gruppe benötigen.
• Survival-/SMP- und Community-Server, die Ränge oder kosmetische Präfixe verwenden.
• Server mit externen Berechtigungs-Plugins, die wollen, dass Tags Berechtigungen/Gruppen widerspiegeln.

🏗️ Beispielanwendungen

• Ein farbiges Präfix für Staff oder Spender-Ränge zuweisen, das sowohl über dem Spieler als auch in der Tab-Liste erscheint.
• Platzhalter verwenden, um dynamische Informationen im Präfix oder Suffix eines Spielers anzuzeigen.
• Vorhandene Tag-Daten von Flat Files nach MySQL für netzwerkbasierten Speicher migrieren.

⌨️ Befehle & Berechtigungen

Das Plugin dokumentiert seine verfügbaren Befehle und Berechtigungsknoten in seinem offiziellen Repository und in der Begleitdokumentation. Serverbesitzer sollten vor dem Anwenden von Änderungen die Repository-Dokumentation des Plugins konsultieren, um die exakte Befehlssyntax und die Berechtigungsknoten zu prüfen.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle NametagEdit-Plugin-JAR herunter und lege sie im plugins/-Verzeichnis deines Spigot-kompatiblen Servers ab.
• Starte den Server neu und prüfe die Serverkonsole, um zu bestätigen, dass das Plugin geladen wird.

📦 Abhängigkeiten

NametagEdit bietet Integrationen mit mehreren Berechtigungs- und Placeholder-Systemen. Bestätigte Integrationen umfassen GroupManager, PermissionsEx, zPermissions, LuckPerms, LibsDisguises und gängige Placeholder-APIs. Sieh in der Plugin-Dokumentation nach optionalen Integrationsschritten.

🧠 Technische Hinweise

• Bestätigt getestete Minecraft-Versionen umfassen 1.7 bis 1.20. Verschiedene Minecraft-Versionen haben unterschiedliche Zeichenlimits und Funktionsunterstützung:
  • Minecraft 1.7.x–1.12.x: Die Zeichenlimits für Präfix/Suffix sind kürzer (die alten 16-Zeichen-Limits gelten für das Namensschild über dem Kopf).
  • Minecraft 1.13.x–1.20.x: Größere Limits (deutlich erhöhte Tab-Liste-Kapazität für längere Tags).
  • Minecraft 1.16.x+: Bestätigte Unterstützung für Hex-Farben.
• Das Plugin verwendet Pakete und Scoreboard-Teams; dies kann mit anderen Plugins kollidieren, die ebenfalls Teams manipulieren oder NPCs mit identischen Benutzernamen erstellen.
• Lizenz: GPL-3.0.

❓ FAQ

• F: Ändert das die Skin oder den Kontonamen eines Spielers?
  • A: Nein — NametagEdit ändert Nametags über Pakete/Scoreboard-Teams; es verändert weder Skins noch Mojang-Kontonamen.
• F: Warum können Clients abstürzen, wenn Nametags aktualisiert werden?
  • A: Clients können abstürzen, wenn mehrere Plugins versuchen, denselben Spieler in unterschiedliche Scoreboard-Teams zu setzen, oder wenn zwei Plugins dieselben Team-IDs manipulieren; das ist eine Einschränkung der Funktionsweise von Scoreboards und Teams.

🤝 Wann dieses Plugin nützlich ist

Wenn du berechtigungsabhängige, konfigurierbare visuelle Tags für Spieler und eine verbesserte Sortierung der Tab-Liste benötigst (einschließlich Farb- und Placeholder-Unterstützung), bietet NametagEdit eine gepflegte Codebasis und Integrationen, mit denen du sichtbare Tags an das Rang- und Gruppensystem deines Servers anpassen kannst.