Plugin Minecraft DeluxeTags

🔌 O DeluxeTags

DeluxeTags to plugin Spigot do Minecraft, który udostępnia dodatkowe tagi oparte na uprawnieniach (prefiksy), które gracze mogą odblokowywać i przełączać za pomocą GUI w grze lub komend. Tagi są traktowane jako „dodatkowy prefiks” i mogą być wyświetlane na czacie, w tabie oraz w innych integracjach czatu za pomocą placeholderów.

🎯 Cel

DeluxeTags rozwiązuje problem dawania graczom opcjonalnych, odblokowywalnych kosmetycznych tagów oddzielonych od prefiksów rangi/grupy. Jest przydatny dla serwerów, które chcą oferować tagi kupowane/odblokowywane lub przyznawane jako nagrody, które gracze mogą włączać i wyłączać bez zmiany głównej grupy lub rangi.

⚙️ Funkcje

• Tagi oparte na uprawnieniach: dostęp nadajesz przez deluxetags.tag.<identifier> (przykład w konfiguracji: deluxetags.tag.example).
• GUI dla gracza do przeglądania i wybierania dostępnych tagów.
• Komendy do listowania, wybierania i zarządzania tagami (komendy dla gracza i administratora opisane przez projekt).
• Wsparcie PlaceholderAPI i placeholdery do wstawiania aktywnego tagu, identyfikatora, opisu i liczby do formatów czatu.
• Konfigurowalne elementy GUI, nazwy i ustawienia paginacji pokazane we fragmencie konfiguracji pluginu.
• Opcje wczytywania tagu gracza przy dołączeniu, integracji z formatowaniem czatu i sprawdzania aktualizacji.

🧩 Dla kogo

• Serwery Survival / SMP, które chcą kosmetycznych, odblokowywalnych tagów czatu oddzielonych od prefiksów rangi.
• Serwery używające pluginów uprawnień do przyznawania kosmetycznych nagród (np. przez LuckPerms).
• Administratorzy, którzy chcą prostego selektora tagów opartego na GUI dla graczy.

🏗️ Przykłady użycia

• Przyznanie graczowi uprawnienia do tagu VIP jako kupowanego kosmetyku i pozwolenie mu przełączać go przez GUI tagów.
• Nagroda z eventu przyznaje konkretne uprawnienie tagu, aby zwycięzcy mogli wybrać nowy tag spośród dostępnych.
• Administratorzy tworzą własne tagi komendami i określają, którzy gracze mogą ich używać, poprzez uprawnienia.

⌨️ Komendy

Uwaga: dokumentacja projektu potwierdza te komendy; konkretne węzły uprawnień dla komend (poza wzorcem dla tagów) nie są wymienione w głównym źródle.

🔐 Uprawnienia

Plugin używa węzłów uprawnień per tag; inne węzły specyficzne dla komend nie są wyraźnie opisane w dostępnych głównych plikach projektu.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR pluginu z zasobu Spigot projektu lub z oficjalnych artefaktów buildów.
• Umieść JAR w folderze plugins/ serwera.
• Uruchom lub zrestartuj serwer i sprawdź konsolę, aby potwierdzić, że plugin został załadowany.

📦 Zależności

• PlaceholderAPI — obsługiwane (plugin zawiera placeholdery i opcję papi_chat), wymienione w konfiguracji i przykładach placeholderów.

🧾 Konfiguracja

• DeluxeTags używa konfiguracji YAML, która definiuje tagi, ustawienia GUI i wiadomości. Konfiguracja zawiera przykłady wpisów tagów, ustawień elementów GUI, placeholderów i opcji formatu czatu. Często spotykane klucze w konfiguracji: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Uwagi techniczne

• Kod źródłowy projektu jest dostępny w publicznym repozytorium GitHub.
• Projekt na Spigot podaje testowane wersje Minecrafta od 1.8 do 1.21 i zawiera konkretny wpis 1.20.6 na liście testowanych wersji.
• Buildy deweloperskie i artefakty CI są dostarczane przez serwer CI projektu.
• Repozytorium nie pokazuje opublikowanych wydań na hostingu źródłowym; artefakty CI są dostępne osobno.

🤝 Kiedy ten plugin jest przydatny

Jeśli chcesz, aby gracze mieli opcjonalne, oparte na uprawnieniach kosmetyczne tagi, które mogą włączać przez GUI lub komendy bez zmiany grup rangi, DeluxeTags oferuje proste, konfigurowalne rozwiązanie z integracją PlaceholderAPI do wyświetlania na czacie.