Plugin Minecraft NametagEdit

🔌 O NametagEdit

NametagEdit to plugin do Minecrafta, który pozwala administratorom serwera zmieniać tekst wyświetlany nad głowami graczy oraz to, jak gracze pojawiają się na liście TAB serwera. Plugin oferuje konfigurowalne prefiksy i sufiksy (dla pojedynczych graczy lub grup), obsługuje formatowanie kolorów, w tym kolory hex w obsługiwanych wersjach, i może sortować lub stosować tagi na liście TAB.

🎯 Cel

NametagEdit rozwiązuje problem ograniczonych lub statycznych etykiet graczy, umożliwiając dynamiczne, zależne od uprawnień prefiksy/sufiksy oraz sortowanie listy TAB. Jest przeznaczony dla właścicieli i administratorów serwerów, którzy chcą kosmetycznego rozróżniania nazw, etykiet opartych na rangach lub bardziej elastycznego sortowania listy TAB bez zmiany skinów ani nazw kont graczy.

⚙️ Funkcje

• Konfigurowalny prefiks i sufiks dla pojedynczych graczy lub nazwanych grup.
• Personalizacja nazwy na liście TAB i sortowalne tagi grup/graczy.
• Obsługa kolorów hex w nowoczesnych wersjach Minecrafta (potwierdzona dla 1.16+).
• Integracje z popularnymi systemami uprawnień i grup, dzięki czemu tagi aktualizują się automatycznie, gdy zmienia się grupa użytkownika.
• Back-endy przechowywania i narzędzia migracyjne: obsługa FlatFile z konwerterami oraz obsługa MySQL z connection pooling.
• Obsługa placeholderów przez popularne API placeholderów (wymienione w oficjalnej dokumentacji).
• Dostępne API dla deweloperów, aby autorzy pluginów mogli współpracować z funkcjami NametagEdit.

🧩 Dla kogo

• Administratorzy serwerów potrzebujący wizualnych tagów dla pojedynczych graczy lub grup.
• Serwery Survival/SMP i społeczności używające rang lub kosmetycznych prefiksów.
• Serwery korzystające z zewnętrznych pluginów uprawnień i chcące, aby tagi odzwierciedlały uprawnienia/grupy.

🏗️ Przykładowe zastosowania

• Nadanie kolorowego prefiksu staffowi lub rangom darczyńców, widocznego zarówno nad graczem, jak i na liście TAB.
• Używanie placeholderów do wyświetlania dynamicznych informacji w prefiksie lub sufixie gracza.
• Migracja istniejących danych tagów z plików flat do MySQL dla przechowywania w sieci.

⌨️ Komendy i uprawnienia

Plugin dokumentuje dostępne komendy i węzły uprawnień w swoim oficjalnym repozytorium oraz dokumentacji pomocniczej. Właściciele serwerów powinni przed wprowadzeniem zmian zapoznać się z dokumentacją repozytorium pluginu, aby poznać dokładną składnię komend i węzły uprawnień.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR NametagEdit i umieść go w katalogu plugins/ swojego serwera zgodnego ze Spigotem.
• Zrestartuj serwer i sprawdź konsolę serwera, aby potwierdzić, że plugin się ładuje.

📦 Zależności

NametagEdit zapewnia integracje z kilkoma systemami uprawnień i placeholderów. Potwierdzone integracje obejmują GroupManager, PermissionsEx, zPermissions, LuckPerms, LibsDisguises oraz popularne API placeholderów. Informacje o opcjonalnych krokach integracji znajdziesz w dokumentacji pluginu.

🧠 Uwagi techniczne

• Potwierdzone przetestowane wersje Minecrafta obejmują 1.7 do 1.20. Różne wersje Minecrafta nakładają różne limity znaków i obsługę funkcji:
  • Minecraft 1.7.x–1.12.x: limity znaków prefiksu/sufiksu są krótsze (legacy limit 16 znaków dotyczy tabliczki z nazwą nad głową).
  • Minecraft 1.13.x–1.20.x: większe limity (znacznie zwiększona pojemność listy TAB dla dłuższych tagów).
  • Minecraft 1.16.x+: potwierdzona obsługa kolorów hex.
• Plugin używa pakietów i drużyn scoreboard; może to powodować konflikty z innymi pluginami, które również manipulują drużynami lub tworzą NPC o identycznych nazwach użytkownika.
• Licencja: GPL-3.0.

❓ FAQ

• P: Czy to zmieni skin lub nazwę konta gracza?
  • O: Nie — NametagEdit zmienia nametagi za pomocą pakietów/drużyn scoreboard; nie modyfikuje skinów ani nazw kont Mojang.
• P: Dlaczego klienci mogą się wyłączać, gdy nametagi są aktualizowane?
  • O: Klienci mogą się wyłączać, jeśli wiele pluginów próbuje umieścić tego samego gracza w różnych drużynach scoreboard albo jeśli dwa pluginy manipulują tymi samymi ID drużyn; to ograniczenie sposobu działania scoreboard i drużyn.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz konfigurowalnych, uwzględniających uprawnienia tagów wizualnych dla graczy oraz lepszego sortowania listy TAB (w tym obsługi kolorów i placeholderów), NametagEdit oferuje utrzymywaną bazę kodu i integracje, które pozwalają dopasować widoczne tagi do systemu rang i grup na Twoim serwerze.