TAB - plugin na listę graczy i nametagi

Co to jest TAB

TAB to darmowy, open-source plugin serwerowy Minecraft, który daje administratorom pełną kontrolę nad warstwą wizualną interfejsu gracza — listą graczy (Tab List), nametagami nad głowami, paskiem bossa (bossbar) oraz scoreboardem bocznym. Projekt prowadzi deweloper znany jako NEZNAMY; kod źródłowy jest dostępny na GitHubie.

Plugin jest instalowany na dziesiątkach tysięcy serwerów i jest de facto standardem branżowym, gdy mowa o customizacji tablista. Jego główne przewagi nad konkurencją to:

• Kompleksowość — tablist + nametagi + bossbar + scoreboard w jednym pliku .jar
• Tryb Layout — stałe, ponumerowane sloty w tablistcie (np. zawsze 60 slotów z ikonami rang)
• Wsparcie proxy — natywna obsługa BungeeCord i Velocity bez osobnych patchów
• Integracja z PAPI — dowolny placeholder z PlaceholderAPI działa w każdym elemencie TAB
• Brak limitów wersji — obsługuje Minecraft od 1.8 do najnowszych wersji 1.21.x

TAB instalujesz jak każdy plugin — plik .jar wrzucasz do folderu plugins/ na serwerze Paper lub Spigot i restartujesz serwer. Na proxy (BungeeCord/Velocity) instalujesz go analogicznie w folderze plugins/ po stronie proxy.

Tablist - nagłówek, stopka i formatowanie graczy

Tablist (lista graczy otwierana klawiszem Tab) to pierwsze miejsce, gdzie TAB pokazuje swoje możliwości. Plugin pozwala na:

• Nagłówek (header) — wieloliniowy tekst wyświetlany nad listą graczy, obsługuje animacje, kolory i placeholdery
• Stopka (footer) — analogiczny blok tekstowy pod listą
• Prefiks i sufiks gracza — kolorowy tag przed i za nazwą w tablistcie (np. [VIP], [Admin])
• Kolor nazwy gracza — różne kolory dla różnych rang bezpośrednio w liście
• Ping gracza — możliwość nadpisania lub ukrycia ikonki opóźnienia

Konfiguracja nagłówka i stopki w pliku config.yml:

header:
  - "&6&l» minecraft.pl «"
  - "&7Graczy online: &e%online%"
footer:
  - "&7Forum: &bforum.minecraft.pl"
  - "&7Twoja ranga: &e%luckperms_prefix%"

Prefiks i sufiks ustawia się per-grupa w pliku groups.yml lub pobiera automatycznie z LuckPerms przez integrację luckperms-prefix-suffix. To drugie rozwiązanie jest zalecane — zmiana rangi w LuckPerms od razu aktualizuje wygląd w tablistcie bez restartowania TAB.

Nametagi

Nametag to etykieta nad głową gracza widoczna w grze. TAB pozwala w pełni ją customizować — zmienić kolor, dodać prefiks rangi, sufiks, a nawet całkowicie ukryć tag dla określonych grup graczy.

Przykładowa konfiguracja nametagów w groups.yml:

groups:
  Admin:
    tabprefix: "&c[Admin] "
    tabsuffix: ""
    tagprefix: "&c[Admin] "
    tagsuffix: ""
    namecolor: "&c"
  VIP:
    tabprefix: "&6[VIP] "
    tabsuffix: ""
    tagprefix: "&6[VIP] "
    tagsuffix: ""
    namecolor: "&6"
  default:
    tabprefix: "&7"
    tabsuffix: ""
    tagprefix: ""
    tagsuffix: ""
    namecolor: "&7"

Ważna opcja to unlimited-nametag-mode dostępna na wersjach 1.8-1.20. W trybie standardowym Minecraft ogranicza prefiks i sufiks nametagu do 16 znaków — tryb unlimited obchodzi to ograniczenie przez pakietowanie dodatkowych danych, umożliwiając wieloliniowe i długie nametagi. Uwaga: tryb unlimited może kolidować z pluginami wykorzystującymi PacketEvents lub ProtocolLib.

Nametagi można też ukrywać warunkowo — przydatne np. w trybach PvP, gdzie gracze nie powinni widzieć wrogów przez ściany. Opcja invisible-nametags w konfiguracji grupy ustawia tag na niewidoczny gdy gracz jest poza zasięgiem wzroku.

Bossbar

TAB umożliwia wyświetlanie komunikatów w pasku bossa — szerokiego paska u góry ekranu, pierwotnie przeznaczonego dla Elder Dragona i Withera. Bossbar to świetne miejsce na:

• Aktualny czas na serwerze lub czas do eventu
• Wiadomości witające gracza po dołączeniu
• Dynamiczne informacje pobierane przez PAPI (np. pozycja na rankingu, saldo, poziom)
• Animowane banery serwerowe wyświetlane cyklicznie

Konfiguracja bossbara w config.yml:

bossbar:
  enabled: true
  bars:
    - text: "&6Witaj na serwerze, &e%player%&6!"
      color: YELLOW
      style: SOLID
      announcement-bar: true
      display-time: 5

Dostępne kolory paska: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE. Style: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20. Wartość progress (0.0–1.0) ustawia wypełnienie paska — możesz ją podpiąć pod placeholder, np. poziom życia gracza.

Scoreboard

Scoreboard w TAB to lista po prawej stronie ekranu (sidebar), najczęściej używana do wyświetlania statystyk gracza, czasu do eventu lub ogólnych informacji o serwerze. TAB obsługuje zarówno statyczny scoreboard, jak i animowany z podmianą linii w określonym interwale.

Przykładowa konfiguracja scoreboardu:

scoreboard:
  enabled: true
  scoreboards:
    default:
      title: "&6&lminecraft.pl"
      lines:
        - "&7Gracz: &e%player%"
        - "&7Ranga: %luckperms_prefix%"
        - "&7Saldo: &a$%vault_eco_balance_formatted%"
        - "&7Ping: &e%ping%ms"
        - ""
        - "&bforum.minecraft.pl"

Osobna funkcja to belowname — małe oznaczenie pod nametagiem gracza, widoczne tylko gdy gracz stoi w pobliżu. Tradycyjnie używana do wyświetlania liczby żyć lub poziomu, działa przez wbudowany mechanizm scoreboarda Minecrafta (objective displayslot belowName).

belowname-objective:
  enabled: true
  text: "&cHP"
  value: "%player_health_rounded%"

Layout - stałe sloty w tablistcie

Tryb Layout to jedna z najbardziej unikalnych funkcji TAB — pozwala na przydzielenie konkretnych slotów w tablistcie do określonych kategorii graczy lub informacji statycznych, niezależnie od tego, ilu graczy jest online.

W trybie normalnym tablist Minecrafta wyświetla tylko aktualnie zalogowanych graczy. Layout zmienia to podejście: definiujesz siatkę (np. 4 kolumny × 20 wierszy = 80 slotów) i każdy slot może być:

• Przypisany do konkretnej rangi graczy (np. sloty 1-10 dla adminów, 11-30 dla VIP)
• Statyczną ikoną lub etykietą (np. logo serwera, informacja o IP)
• Dynamiczną wartością z PAPI
• Pustym slotem wypełniaczem

Dzięki temu tablist wygląda schludnie nawet przy 3 graczach online — zamiast trzech losowych rzędów widzisz zorganizowaną siatkę z wyraźnie oznaczonymi kategoriami.

layout:
  enabled: true
  default-skin: "mineskin:STEVE"
  layouts:
    default:
      condition: null
      groups:
        Admins:
          slots: "1-5"
          condition: "%luckperms_has_group_admin%:true"
        VIP:
          slots: "6-15"
          condition: "%luckperms_has_group_vip%:true"
        Players:
          slots: "16-60"

Sortowanie graczy

TAB pozwala określić kolejność graczy na liście według wielu kryteriów. Domyślnie Minecraft sortuje alfabetycznie — TAB umożliwia sortowanie według rang, uprawnień lub wartości placeholderów.

Konfiguracja sortowania w config.yml:

sorting:
  - "GROUPS:Admin,Moderator,VIP,default"
  - "PLACEHOLDER_A_TO_Z:%player_name%"

Dostępne metody sortowania:

Najczęstszy setup to GROUPS z ręcznie ustaloną hierarchią rang, a następnie PLACEHOLDER_A_TO_Z z %player_name% jako kryterium sekundarne — gracze tej samej rangi sortują się alfabetycznie.

Integracja z PlaceholderAPI

TAB natywnie wspiera PlaceholderAPI — nie wymaga żadnej dodatkowej konfiguracji. Jeśli PAPI jest zainstalowane na serwerze, możesz użyć dowolnego placeholdera w każdym polu TAB: nagłówku, stopce, nametagu, bossbarie, scoreboardzie i layoutcie.

Najczęściej używane placeholdery w połączeniu z TAB:

TAB posiada też własne wbudowane placeholdery dostępne bez PAPI: %online%, %ping%, %world%, %staffonline%. Są lżejsze wydajnościowo niż odpowiedniki PAPI, więc warto ich używać gdy nie potrzebujesz zaawansowanych danych zewnętrznych.

Możesz też definiować własne statyczne i dynamiczne placeholdery w sekcji placeholders.yml — przydatne gdy chcesz raz zdefiniować złożone wyrażenie i używać go wielokrotnie.

Tryb proxy - BungeeCord i Velocity

TAB obsługuje sieci serwerów pracujące za proxy BungeeCord lub Velocity. W trybie proxy plugin zapewnia spójny wygląd tablista we wszystkich podserwerach sieci bez potrzeby duplikowania konfiguracji.

Instalacja na sieci proxy:

1. Wrzuć plik TAB.jar do folderu plugins/ na BungeeCord/Velocity
2. Wrzuć ten sam plik TAB.jar do folderu plugins/ na każdym serwerze backend
3. Na backendach w config.yml ustaw bungeecord-mode: true (lub velocity-mode: true)
4. Restartuj najpierw backendy, potem proxy

W trybie proxy konfiguracja TAB (nagłówki, stopki, grupy, layout) zarządzana jest z poziomu pluginu zainstalowanego na proxy — backendy jedynie przesyłają dane graczy (pozycja, rang, świat) do centralnej instancji. Dzięki temu zmiana wyglądu tablista wymaga edycji tylko jednego pliku konfiguracyjnego, a nie N plików na N serwerach.

Ważna różnica między BungeeCord a Velocity: Velocity wymaga włączenia player-information-forwarding w velocity.toml (tryb modern lub legacy). TAB automatycznie wykrywa typ proxy na podstawie konfiguracji.

Komendy

TAB oferuje prosty zestaw komend administracyjnych do zarządzania pluginem w czasie rzeczywistym:

Komenda /tab parse jest szczególnie przydatna podczas debugowania — pozwala sprawdzić jak plugin przetworzy konkretny ciąg z placeholderami dla wybranego gracza, bez wychodzenia z konsoli.

Konfiguracja

TAB generuje kilka plików konfiguracyjnych w folderze plugins/TAB/:

• config.yml — główna konfiguracja: tablist, bossbar, scoreboard, belowname, sortowanie, tryb proxy
• groups.yml — prefiksy, sufiksy i kolory dla poszczególnych rang
• users.yml — nadpisania per-gracz (używasz /tab player by automatycznie tu trafiały)
• placeholders.yml — własne placeholdery i ich interwały odświeżania
• layout.yml — konfiguracja trybu Layout (jeśli włączony)

Przykład minimalnej konfiguracji config.yml z włączonymi podstawowymi funkcjami:

mysql:
  enabled: false

header: "&6minecraft.pl | &7Graczy: &e%online%"
footer: "&7forum.minecraft.pl"

tablist-name-format: "%luckperms_prefix%%player%"

nametag-prefix-suffix-mode: false
unlimited-nametag-mode: false

scoreboard:
  enabled: true
  toggle-command: "/scoreboard"
  remember-toggle-choice: true
  scoreboards:
    default:
      title: "&6&lminecraft.pl"
      lines:
        - "&eGracz: &f%player%"
        - "&ePing: &f%ping%ms"
        - ""
        - "&bforum.minecraft.pl"

belowname-objective:
  enabled: false

bossbar:
  enabled: false

sorting:
  - "GROUPS:Admin,Moderator,VIP,default"
  - "PLACEHOLDER_A_TO_Z:%player_name%"

Kilka wskazówek przy konfiguracji:

• Używaj /tab reload po każdej zmianie — nie musisz restartować serwera
• Przetestuj placeholder przez /tab parse Gracz tekst zanim wstawisz go do konfiguracji — oszczędza czas szukania literówek w nazwach placeholderów
• Nie włączaj jednocześnie scoreboardu z zewnętrznym pluginem scoreboardu (np. FeatherBoard) — konflikty powodują migotanie lub pusty pasek po stronie gracza
• Ogranicz interwał odświeżania PAPI w placeholders.yml — domyślnie każdy placeholder odświeżany jest co 500ms, co na dużych serwerach generuje zbędne obliczenia. Dla statycznych danych jak prefix rangi ustaw refresh: 10000 (10 sekund)
• Tryb Layout wymaga Minecrafta 1.9+ — na serwerach z obsługą 1.8 należy go wyłączyć lub używać warunkowej konfiguracji per-wersję

Pełna dokumentacja TAB dostępna jest w wiki projektu na GitHubie. Plugin jest aktywnie rozwijany — changelog i nowe wersje znajdziesz w zakładce Releases repozytorium.

Powiązane pluginy: LuckPerms (system rang i uprawnień, idealne źródło prefiksów dla TAB), PlaceholderAPI (rozszerzone placeholdery dla TAB). Pozostałe polecane pluginy znajdziesz w katalogu pluginów.