Plugin Minecraft InteractiveChat

🔌 O InteractiveChat

InteractiveChat to wtyczka do Minecrafta, która ulepsza czat w grze, zastępując zwykłe nazwy graczy i słowa kluczowe interaktywną treścią (wiadomości po najechaniu, akcje kliknięcia) oraz pozwalając graczom pokazywać przedmioty, ekwipunki i skrzynie Endera bezpośrednio na czacie. Została zaprojektowana tak, aby działać na istniejących wtyczkach formatujących czat, modyfikując pakiety zamiast zastępować systemy czatu.

🎯 Cel

InteractiveChat rozwiązuje problem statycznego czatu wyłącznie tekstowego, dodając interaktywne elementy i rozbudowane placeholdery, dzięki czemu gracze mogą udostępniać szczegóły przedmiotów/narzędzi oraz zawartość ekwipunku za pomocą interakcji po najechaniu i kliknięciu. Obsługuje też funkcje między serwerami w sieciach z proxy, umożliwiając interaktywny czat na serwerach backend.

⚙️ Funkcje

• Zastępuje nazwy graczy na czacie interaktywną treścią hover/click.
• Pokazuje podgląd przedmiotu trzymanego w ręce na czacie za pomocą słowa kluczowego (np. [item]).
• Pokazuje zawartość ekwipunku gracza na czacie za pomocą słowa kluczowego (np. [inv]) i pozwala wybrać układ wyświetlania.
• Pokazuje zawartość skrzyni Endera na czacie za pomocą słowa kluczowego (np. [ender]).
• Tworzy własne interaktywne słowa kluczowe/placeholdere do użycia na czacie.
• Wzmianki o graczach z opcjonalnymi powiadomieniami (dźwięk, tytuł, pasek akcji, pasek bossa), gdy obsługuje to wersja serwera.
• Obsługa międzyserwerowa dla BungeeCord i Velocity, gdy skonfigurowano na proxy i backendach.
• Obsługuje placeholdery PlaceholderAPI i integruje tłumaczenie nazw materiałów przedmiotów na język klienta.
• Kody kolorów RGB i niestandardowe czcionki są obsługiwane dla wiadomości na serwerach, które to wspierają (funkcje RGB wymagają 1.16+).

🧩 Dla kogo

• Administratorzy serwerów, którzy chcą bogatszych interakcji na czacie oraz treści po najechaniu/kliknięciu.
• Sieci korzystające z proxy (BungeeCord/Velocity), które potrzebują interaktywnego czatu między serwerami backend.
• Społeczności, które chcą, aby gracze pokazywali przedmioty lub ekwipunki na czacie bez zewnętrznych modów.

🏗️ Przykładowe zastosowania

• Gracz wpisuje [item] na czacie globalnym, aby pokazać interaktywny tooltip trzymanego przedmiotu do obejrzenia przez innych.
• Moderator wysyła sformatowaną wiadomość na czacie z placeholderami i podglądem ekwipunku w treści wiadomości do wsparcia lub oceny.
• Sieć z proxy włącza wtyczkę na proxy i backendach, aby wzmianki i placeholdery działały między serwerami.

⌨️ Komendy

Uwaga: powyżej znajdują się tylko komendy wyraźnie wymienione przez oficjalne źródła. Węzły uprawnień są uwzględniane tam, gdzie dokumentuje je wtyczka; w przeciwnym razie kolumna uprawnień pokazuje nie określono.

🔐 Uprawnienia

(Tylko węzły uprawnień wyraźnie podane w oficjalnej dokumentacji wtyczki są wymienione powyżej.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR wtyczki oraz wymagane wtyczki zależności.
• Umieść InteractiveChat.jar (i pliki jar zależności) w katalogu plugins/ serwera.
• Uruchom serwer.
• W razie potrzeby edytuj konfigurację wtyczki i uruchom serwer ponownie, aby zastosować zmiany.

📦 Zależności

Potwierdzone zależności wymagane na serwerach backend (Spigot/Paper itd.):

• ProtocolLib lub PacketEvents (+ odpowiedni moduł pakietów)
• PlaceholderAPI
• Vault

Uwagi: zależności nie są wymagane na oprogramowaniu proxy; jeśli planujesz używać wtyczki z BungeeCord lub Velocity, zainstaluj InteractiveChat zarówno na proxy, jak i na serwerach backend oraz włącz opcję proxy/bungeecord w konfiguracji InteractiveChat na każdym serwerze backend.

🧠 Uwagi techniczne

• Wtyczka modyfikuje czat na poziomie pakietów; wymaga biblioteki pakietów (ProtocolLib lub PacketEvents), aby przechwytywać/modyfikować wiadomości na serwerach backend.
• Obsługa proxy: BungeeCord i Velocity są wspierane; aby włączyć placeholdery i wzmianki między serwerami, wtyczka musi być zainstalowana na proxy i na wszystkich serwerach backend, z włączoną opcją bungeecord w konfiguracji każdego backendu.
• PlaceholderAPI jest używany do rozwiązywania placeholderów i wymaga, aby potrzebne rozszerzenia były zainstalowane osobno, by te placeholdery działały.
• Nazwy materiałów przedmiotów są tam, gdzie ma to zastosowanie, tłumaczone na język klienta każdego gracza.
• Kody kolorów RGB i niestandardowe czcionki są obsługiwane na serwerach/klientach, które wspierają te funkcje (działanie RGB wymaga obsługi serwera/klienta, zwykle dostępnej w 1.16+).

🤝 Kiedy ta wtyczka jest przydatna

Jeśli chcesz dodać podglądy przedmiotów/narzędzi do sprawdzenia, udostępnianie ekwipunku, klikalne słowa kluczowe na czacie i międzyserwerowe funkcje interaktywnego czatu, zachowując jednocześnie swój obecny plugin do formatowania czatu, InteractiveChat zapewnia integrację na poziomie pakietów, która nakłada interaktywną treść na standardowe systemy czatu.