DecentHolograms - hologramy na serwerze Minecraft

Co to jest DecentHolograms

DecentHolograms to darmowy plugin serwerowy napisany przez dewelopera d0by, dostępny na SpigotMC. Jest to pełnoprawna, aktywnie rozwijana alternatywa dla klasycznego HolographicDisplays, który przestał być aktualizowany do nowszych wersji Minecrafta.

Hologramy to elementy wyświetlane w świecie gry jako unoszący się tekst lub ikony, niewidoczne dla innych obiektów - gracze przez nie przechodzą. Używa się ich powszechnie do:

• informacyjnych tablic przy spawnie, warpach i sklepach
• rankingów top graczy (topka kasy, zabójstw, czasu gry)
• etykiet przy wejściach do aren i dungeonów
• dynamicznych powiadomień o eventach i promocjach
• ozdobnych tytułów nad NPC i bossami

Plugin działa na Spigot, Paper i Purpur w wersjach Minecraft od 1.8 aż po 1.21.x. Nie wymaga żadnych zależności do podstawowego działania - PlaceholderAPI jest opcjonalne, choć zdecydowanie warto je zainstalować.

Instalacja jest standardowa: pobierz plik .jar ze SpigotMC, wrzuć do folderu plugins/ i zrestartuj serwer. Po pierwszym uruchomieniu powstanie katalog plugins/DecentHolograms/ z plikiem config.yml i folderem holograms/ zawierającym pliki każdego hologramu.

Tworzenie hologramów

Nowy hologram tworzysz komendą wpisaną w grze w miejscu, w którym chcesz go postawić. Hologram pojawi się w pozycji, w której stoisz:

/dh create <nazwa> [tekst pierwszej linii]

Przykład: stań przy spawnie i wpisz:

/dh create spawn_witaj &6&lWitaj na serwerze!

Spowoduje to utworzenie hologramu o nazwie spawn_witaj z jedną złotą, pogrubioną linią tekstu. Hologram jest od razu zapisywany do pliku plugins/DecentHolograms/holograms/spawn_witaj.yml - nie musisz niczego ręcznie zapisywać.

Każdy hologram posiada swój plik YAML. Możesz go edytować ręcznie i przeładować przez /dh reload, albo zarządzać wszystkim przez komendy w grze. Struktura pliku hologramu wygląda tak:

location: world,100.5,64.0,200.5,0.0,0.0
display-range: 48
update-range: 48
update-interval: 20
facing: false
pages:
  - lines:
      - type: TEXT
        content: "&6&lWitaj na serwerze!"
        height: 0.3
      - type: TEXT
        content: "&7Dołącz do naszego Discorda!"
        height: 0.3

Parametr display-range określa zasięg widzialności hologramu w blokach (domyślnie 48). update-interval to co ile ticków odświeżane są placeholdery (20 ticków = 1 sekunda).

Linie tekstu i ikon

DecentHolograms obsługuje kilka typów linii, które możesz mieszać dowolnie w jednym hologramie:

Dodawanie linii do istniejącego hologramu:

# Dodaj linię tekstu na koniec
/dh line add <hologram> <strona> TEXT <treść>

# Dodaj ikonę diamentowego miecza
/dh line add spawn_witaj 1 ICON DIAMOND_SWORD

# Dodaj głowę gracza
/dh line add spawn_witaj 1 HEAD Notch

# Wstaw linię na konkretnej pozycji (np. przed linią 2)
/dh line insert <hologram> <strona> <pozycja> TEXT <treść>

Formatowanie tekstu obsługuje standardowe kody kolorów Minecrafta (&0–&f), formatowanie (&l pogrubienie, &o kursywa, &n podkreślenie, &k losowe znaki) oraz od Minecrafta 1.16+ pełne kolory HEX w formacie <#RRGGBB>.

Przykładowy hologram rankingu z ikoną i tekstem:

/dh line add top_kasa 1 ICON GOLD_INGOT
/dh line add top_kasa 1 TEXT &6&lTop Bogaczy
/dh line add top_kasa 1 TEXT &e1. %vault_eco_top_balance_1% - %vault_eco_top_player_1%
/dh line add top_kasa 1 TEXT &72. %vault_eco_top_balance_2% - %vault_eco_top_player_2%
/dh line add top_kasa 1 TEXT &73. %vault_eco_top_balance_3% - %vault_eco_top_player_3%

Animacje

DecentHolograms ma wbudowany system animacji tekstu. Animacje definiujesz w folderze plugins/DecentHolograms/animations/ i odwołujesz się do nich w liniach hologramu przez składnię {animation:nazwa}.

Plik animacji (animations/tetris.yml) wygląda tak:

interval: 10
frames:
  - "&c█&7▒▒▒▒ Serwer Online"
  - "&c█&7█▒▒▒▒ Serwer Online"
  - "&c█&7██▒▒▒ Serwer Online"
  - "&c█&7███▒▒ Serwer Online"
  - "&c█&7████▒ Serwer Online"
  - "&c█&7█████ Serwer Online"

Parametr interval to liczba ticków między klatkami (10 = 0,5 sekundy). Następnie w hologramie:

/dh line set <hologram> <strona> <linia> TEXT {animation:tetris}

Plugin posiada też kilka wbudowanych animacji gotowych do użycia:

• {animation:typewriter:<tekst>} - efekt pisania na maszynie
• {animation:scroll:<tekst>:<szerokość>} - przewijający się pasek tekstu
• {animation:wave:<tekst>} - tekst z falującymi kolorami
• {animation:burn:<tekst>} - efekt płomieni przesuwających się przez tekst
• {animation:rainbow:<tekst>} - tęczowe kolory przemieszczające się przez napis

Animacje możesz też łączyć z placeholderami - na przykład animacja tęczy na nazwie gracza: {animation:rainbow:%player_name%}. Animacje są odświeżane zgodnie z ustawionym update-interval hologramu.

Akcje (click actions)

Jedną z największych przewag DecentHolograms nad HolographicDisplays jest wbudowany system akcji po kliknięciu hologramu przez gracza. Nie potrzebujesz dodatkowego pluginu (jak Citizens czy NPC z DHAPI).

Akcje dodaje się do konkretnej linii hologramu przez plik YAML lub komendę:

/dh line action add <hologram> <strona> <linia> <typ_kliknięcia> <typ_akcji> <wartość>

Typy kliknięcia to RIGHT (prawy przycisk), LEFT (lewy przycisk) i SHIFT_RIGHT / SHIFT_LEFT (z Shiftem). Dostępne typy akcji:

Przykład - hologram menu teleportacji z akcjami:

# Linia "Kliknij aby dostać nagrodę"
/dh line action add daily_reward 1 1 RIGHT CONSOLE daily reward give %player%
/dh line action add daily_reward 1 1 RIGHT MESSAGE &aDzienna nagroda odebrana!

# Linia przenoszenia na inny serwer
/dh line action add hub_menu 1 2 RIGHT CONNECT survival

Akcje można też definiować bezpośrednio w pliku YAML hologramu w sekcji actions każdej linii. Możesz ustawić cooldown per gracz, żeby zapobiec spamowi kliknięć.

Strony hologramu

DecentHolograms wprowadza koncepcję stron (pages) - każdy hologram może mieć wiele stron, a gracz widzi tylko jedną w danym momencie. Strony przełącza się przez akcje kliknięcia (NEXT_PAGE, PREV_PAGE) lub przez komendę.

To niezwykle przydatne do budowania interaktywnych menu NPC, wielostronicowych regulaminów czy poradników bezpośrednio w grze. Gracz klika hologram, żeby przewinąć dalej.

# Dodaj nową stronę do hologramu
/dh page add <hologram>

# Usuń stronę
/dh page remove <hologram> <numer_strony>

# Przejdź do konkretnej strony (jako admin, do podglądu)
/dh page switch <hologram> <strona>

# Skopiuj stronę
/dh page copy <hologram> <strona_źródłowa> <strona_docelowa>

W plikach YAML strony są listowane pod kluczem pages - każda strona to osobna lista linii. Możesz też ustawić per gracz widoczną stronę przez API, co otwiera możliwości dla personalizowanych hologramów (np. wyświetlanie różnych informacji dla różnych rang).

Przykładowy hologram z dwiema stronami i nawigacją:

pages:
  - lines:
      - type: TEXT
        content: "&6&l== Regulamin (1/2) =="
      - type: TEXT
        content: "&71. Zakaz cheating i hacking."
      - type: TEXT
        content: "&72. Szanuj innych graczy."
      - type: TEXT
        content: "&e>> Kliknij aby przejść dalej >>"
        actions:
          RIGHT:
            - type: NEXT_PAGE
  - lines:
      - type: TEXT
        content: "&6&l== Regulamin (2/2) =="
      - type: TEXT
        content: "&73. Zakaz reklamy innych serwerów."
      - type: TEXT
        content: "&74. Stosuj się do poleceń adminów."
      - type: TEXT
        content: "&e<< Kliknij aby wrócić <<"
        actions:
          RIGHT:
            - type: PREV_PAGE

Preset hologramy

Presety to szablony hologramów zapisane w folderze plugins/DecentHolograms/presets/. Preset definiuje wygląd i zachowanie hologramu, który potem możesz błyskawicznie wdrożyć w wielu miejscach bez przepisywania konfiguracji od zera.

# Utwórz hologram z presetu
/dh create <nazwa> --preset <nazwa_presetu>

# Przeładuj presety
/dh presets reload

Przykładowy plik presetu (presets/top_players.yml):

lines:
  - type: ICON
    content: NETHER_STAR
  - type: TEXT
    content: "&5&lTop Graczy"
  - type: TEXT
    content: "&d1. %statistic_top_player_kills_1%"
  - type: TEXT
    content: "&d2. %statistic_top_player_kills_2%"
  - type: TEXT
    content: "&d3. %statistic_top_player_kills_3%"

Presety są szczególnie przydatne na sieci serwerów (BungeeCord/Velocity), gdzie ten sam wzorzec hologramu chcesz szybko wdrożyć na kilku serwerach. Wystarczy skopiować plik presetu i użyć jednej komendy.

Możesz też użyć polecenia /dh import holographicdisplays, które automatycznie importuje wszystkie hologramy z konfiguracji HolographicDisplays do DecentHolograms - bez ręcznego przepisywania.

PlaceholderAPI

DecentHolograms ma natywne wsparcie dla PlaceholderAPI - nie potrzebujesz osobnego PAPI Bridge jak w przypadku HolographicDisplays. Wystarczy zainstalować PlaceholderAPI i od razu możesz używać dowolnych placeholderów w liniach hologramu.

Kilka najbardziej przydatnych kombinacji:

Placeholder %player_name% jest personalizowany per gracz - każdy gracz widzi swoje własne dane, nie wspólne wartości statyczne. To możliwe dzięki temu, że DecentHolograms używa pakietów NMS do renderowania hologramów osobno dla każdego gracza w zasięgu.

Ważne: update-interval hologramu kontroluje jak często placeholdery są odświeżane. Dla rankingów (które zmieniają się rzadko) możesz ustawić 200–600 ticków, żeby nie obciążać serwera. Dla wyświetlania czasu czy HP lepszy jest interwał 20–40 ticków.

Powiązany poradnik: PlaceholderAPI - co to jest i jak korzystać.

Komendy

Wszystkie komendy DecentHolograms zaczynają się od /dh lub /decentholograms. Wymagają uprawnienia decentholograms.admin (lub bardziej szczegółowych nodów).

Uprawnienia można nadać przez LuckPerms. Główny node decentholograms.admin daje dostęp do wszystkich komend. Możesz też nadać konkretne nody, np. decentholograms.command.teleport, żeby moderatorzy mogli się teleportować do hologramów bez możliwości ich edycji.

DecentHolograms vs HolographicDisplays

HolographicDisplays przez wiele lat był standardem dla hologramów na serwerach Minecraft. Jednak od 2022 roku plugin nie jest aktualizowany do nowszych wersji gry, co zmusiło większość adminów do szukania alternatyw. DecentHolograms to aktualnie najlepsza opcja.

Jedyna sytuacja, w której możesz preferować HolographicDisplays, to stary serwer na Minecrafcie 1.12 lub wcześniejszym - DecentHolograms obsługuje wersje od 1.8, więc nawet to rzadko stanowi problem.

Migracja z HolographicDisplays jest prosta: zainstaluj DecentHolograms, usuń HolographicDisplays z folderu plugins, uruchom serwer z samym DH i wykonaj /dh import holographicdisplays. Wszystkie hologramy pojawią się w nowym pluginie.

Powiązane pluginy i poradniki: PlaceholderAPI (dynamiczne placeholdery w hologramach), EssentialsX (komendy serwerowe), Katalog pluginów (wszystkie polecane pluginy).