Minecraft plugin InteractiveChat

🔌 O InteractiveChat

InteractiveChat je plugin pro Minecraft, který vylepšuje herní chat tím, že nahrazuje obyčejná jména hráčů a klíčová slova interaktivním obsahem (hover zprávy, klikací akce) a umožňuje hráčům zobrazovat předměty, inventář a ender truhly přímo v chatu. Je navržen tak, aby fungoval nad existujícími pluginy pro formátování chatu, a to úpravou packetů místo nahrazování chat systémů.

🎯 Účel

InteractiveChat řeší problém statického, pouze textového chatu přidáním interaktivních prvků a bohatých placeholderů, takže hráči mohou sdílet detaily předmětů/nástrojů a obsah inventáře pomocí hover a klikacích interakcí. Podporuje také funkce mezi servery v proxy sítích, což umožňuje interaktivní chat napříč backend servery.

⚙️ Funkce

• Nahrazení jmen hráčů v chatu interaktivním obsahem s hover/klikem.
• Zobrazení náhledu předmětu v ruce v chatu pomocí klíčového slova (např. [item]).
• Zobrazení obsahu inventáře hráče v chatu pomocí klíčového slova (např. [inv]) a výběr rozvržení zobrazení.
• Zobrazení obsahu ender truhly v chatu pomocí klíčového slova (např. [ender]).
• Tvorba vlastních interaktivních klíčových slov/placeholderů pro použití v chatu.
• Zmínění hráče s volitelnými upozorněními (zvuk, title, action bar, boss bar), pokud to podporuje verze serveru.
• Podpora mezi servery pro BungeeCord a Velocity při konfiguraci na proxy i backendu.
• Podpora placeholderů PlaceholderAPI a integrace s překladem názvů materiálů předmětů do jazyka klienta.
• RGB barevné kódy a podpora vlastních fontů pro zprávy na serverech, které je podporují (funkce RGB vyžadují 1.16+).

🧩 Pro koho je to určeno

• Správce serverů, kteří chtějí bohatší chat interakce a hover/klikací obsah.
• Sítě používající proxy (BungeeCord/Velocity), které potřebují interaktivní chat napříč backend servery.
• Komunity, které chtějí, aby hráči ukazovali předměty nebo inventáře v chatu bez externích modů.

🏗️ Příklady použití

• Hráč napíše [item] v globálním chatu, aby zobrazil interaktivní tooltip pro předmět, který drží v ruce, a ostatní si ho mohli prohlédnout.
• Moderátor pošle formátovanou chat zprávu s placeholdery a vloženými náhledy inventáře pro podporu nebo kontrolu.
• Proxy síť zapne plugin na proxy i backendech, aby zmínky a placeholdery fungovaly napříč servery.

⌨️ Příkazy

Poznámka: výše jsou uvedeny pouze příkazy, které jsou výslovně uvedeny oficiálními zdroji. Permission nodes jsou zahrnuty tam, kde je plugin dokumentuje; jinak je ve sloupci permission uvedeno "není uvedeno".

🔐 Permissions

(Pouze permission nodes výslovně uvedené v oficiální dokumentaci pluginu jsou uvedeny výše.)

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR pluginu a požadované dependency pluginy.
• Umístěte InteractiveChat.jar (a dependency JARy) do adresáře serveru plugins/.
• Spusťte server.
• Podle potřeby upravte konfiguraci pluginu a restartujte server, aby se změny projevily.

📦 Závislosti

Potvrzené závislosti vyžadované na backend serverech (Spigot/Paper/etc.):

• ProtocolLib (nebo) PacketEvents (+ příslušný packet modul)
• PlaceholderAPI
• Vault

Poznámky: závislosti nejsou vyžadovány na proxy softwaru; pokud plánujete používat plugin s BungeeCord nebo Velocity, nainstalujte InteractiveChat na proxy i backend servery a na každém backend serveru povolte v konfiguraci InteractiveChat možnost proxy/bungeecord.

🧠 Technické poznámky

• Plugin upravuje chat na úrovni packetů; k zachytávání/úpravě zpráv na backend serverech vyžaduje packet knihovnu (ProtocolLib nebo PacketEvents).
• Podpora proxy: BungeeCord a Velocity jsou podporovány; pro zapnutí placeholderů a zmínek napříč servery musí být plugin nainstalován na proxy i na všech backend serverech s povolenou volbou bungeecord v konfiguraci každého backendu.
• PlaceholderAPI se používá pro vyhodnocování placeholderů a vyžaduje samostatnou instalaci potřebných expansions, aby placeholdery fungovaly.
• Názvy materiálů předmětů se tam, kde je to relevantní, překládají do jazyka klienta každého hráče.
• RGB barevné kódy a vlastní font tagy jsou podporovány na serverech/klientech, kteří tyto funkce podporují (chování RGB vyžaduje podporu serveru/klienta, která je běžně dostupná v 1.16+).

🤝 Kdy je tento plugin užitečný

Pokud chcete přidat kontrolovatelné náhledy předmětů/nástrojů, sdílení inventáře, klikací chat klíčová slova a interaktivní chat napříč servery, a přitom zachovat svůj stávající plugin pro formátování chatu, InteractiveChat nabízí integraci na úrovni packetů, která vrství interaktivní obsah na standardní chat systémy.