Minecraft plugin DecentHolograms

🔌 O Decent Holograms

Decent Holograms je Minecraft plugin, který poskytuje konfigurovatelné plovoucí hologramy (víceřádkový text a zobrazení ikon) pro servery Spigot/Bukkit. Zaměřuje se na flexibilní prezentaci a integraci pro vývojáře a nabízí public API a integrační body pro další pluginy.

🎯 Účel

Plugin řeší potřebu zobrazovat trvalé informace ve světě (popisky, žebříčky, instrukce, stavové displeje) jako plovoucí text nebo malé vizuální ikony. Je určen pro správce serverů a vývojáře pluginů, kteří potřebují přizpůsobitelné, skriptovatelné hologramy bez dalších povinných závislostí.

⚙️ Funkce

• Vytváření víceřádkových plovoucích hologramů (textové řádky, které se otáčejí směrem k hráčům).
• Podpora PlaceholderAPI pro dynamickou náhradu textu.
• Public developer API pro integraci pluginů a vlastní nástroje.
• Podpora ikon (malé vizuály entit/předmětů, které se otáčejí a pohupují).
• Lehké řešení bez povinných externích závislostí.
• Telemetrie používání přes bStats (reportováno repozitářem projektu).
• Výslovně zdokumentovaná omezení Minecraftu od autora (text je vždy otočený k hráči; velikost/písmo textu nelze měnit; některé ikony entit mohou vydávat zvuky).

🧩 Pro koho to je

• Majitelé a administrátoři serverů, kteří potřebují popisky ve světě, informační tabule nebo dekorativní text.
• Vývojáři pluginů, kteří chtějí hologramy integrovat přes API.
• Servery Survival, SMP a minigame, které používají placeholders pro dynamické zobrazení.

🏗️ Příklady použití

• Zobrazení dynamického žebříčku pomocí placeholders pro top hráče.
• Umístění informačních cedulí u spawnu, které se automaticky aktualizují.
• Použití API k vytváření hologramů z jiných pluginů nebo vlastních skriptů.

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR pluginu ze stránky distribuce projektu.
• Umístěte JAR do adresáře plugins/ vašeho serveru (server kompatibilní se Spigot/Bukkit).
• Restartujte server a zkontrolujte konzoli serveru, abyste potvrdili, že se plugin načetl.

📦 Závislosti

• Žádné povinné závislosti. PlaceholderAPI je podporováno pro dynamické placeholders (volitelné).

🧠 Technické poznámky

• Zdrojový kód a vydání jsou spravovány ve veřejném repozitáři projektu.
• Licencováno pod GPL-3.0, jak je uvedeno v repozitáři.
• Projekt poskytuje developer API a instrukce pro sestavení pluginu ze zdrojových kódů.
• Plugin je testován napříč více verzemi Minecraftu (přesné testované verze najdete na oficiální stránce distribuce).

🤝 Kdy je tento plugin užitečný

Pokud potřebujete konfigurovatelný, skriptovatelný text ve světě nebo malé ikonové zobrazení s podporou placeholders a API pro integraci, Decent Holograms nabízí udržované řešení s malým množstvím závislostí pro servery Spigot/Bukkit.