Discord
Wiki - Pluginy

TrChat - nowoczesny system czatu

TrChat

TrChat to wydajny plugin czatowy nowej generacji z ekosystemu TrPlugins. Obsługuje format MiniMessage, kanały czatu, zaawansowane filtry, funkcje interaktywne (pokazywanie przedmiotów na czacie) oraz działa na Folia - serwerze z wielowątkowym przetwarzaniem regionów.

Czas czytania: ~4 min Platforma: Paper / Spigot / Folia

Co to jest TrChat

TrChat to darmowy plugin czatowy stworzony przez zespół TrPlugins, znany również z pluginów TrMenu i TrHologram. Wyróżnia się natywną obsługą formatu MiniMessage (nowoczesny system formatowania tekstów w Paper), wysoką wydajnością i wsparciem dla Folia.

Plugin jest skierowany do administratorów, którzy szukają czegoś nowszego niż klasyczne rozwiązania pokroju VentureChat czy EssentialsX Chat. TrChat korzysta z biblioteki TabooLib, co zapewnia kompatybilność z wieloma wersjami Minecraft i ułatwia integrację z innymi pluginami z ekosystemu Tr.

Kod źródłowy i dokumentacja znajdują się na GitHub. Plugin obsługuje Minecraft od 1.8 do 1.21.x.

Kluczowe funkcje

  • MiniMessage - natywna obsługa formatu MiniMessage zamiast starych kodów kolorów z &. Gradienty, kolory HEX, klikalne linki
  • Kanały czatu - globalny, lokalny, administracyjny i niestandardowe kanały z osobnymi formatami i uprawnieniami
  • Pokazywanie przedmiotów - gracz może wyświetlić trzymany przedmiot na czacie (z hoverm pokazującym pełne statystyki)
  • Filtry - anti-spam, filtr wulgaryzmów, blokowanie reklam IP, anti-caps z konfigurowalnymi progami
  • Obsługa Folia - jako jeden z niewielu pluginów czatowych działa na serwerach Folia
  • Wielojęzyczność - wbudowane tłumaczenia interfejsu na chiński, angielski i inne języki
  • Skrypty Kether - zaawansowane skryptowanie warunków i akcji w formatach czatu

Konfiguracja kanałów

Kanały definiujesz w plikach YAML w katalogu plugins/TrChat/channels/. Każdy kanał to osobny plik, co ułatwia organizację na dużych serwerach:

# plugins/TrChat/channels/global.yml
channel:
  id: global
  settings:
    auto-join: true
    target:
      range: -1            # -1 = cały serwer
      proxy: true          # widoczny na proxy
  bindings:
    prefix: "!"            # wiadomości z ! idą na globalny
  format:
    default:
      condition: null
      priority: 0
      prefix: "<gray>[<gold>G<gray>] "
      player: "<hover:show_text:'Kliknij aby napisać'><click:suggest_command:'/msg %player_name% '>%vault_prefix% %player_name%</click></hover>"
      suffix: "<white>: %message%"

Format korzysta z MiniMessage i PlaceholderAPI jednocześnie. Możesz definiować wiele wariantów formatu z priorytetami i warunkami - na przykład inny format dla graczy z rangą VIP.

Funkcje interaktywne

Jedną z najbardziej lubianych funkcji TrChat jest pokazywanie przedmiotów na czacie. Gracz wpisuje [i] w wiadomości, a plugin automatycznie zastępuje to interaktywnym elementem z nazwą i opisem trzymanego przedmiotu:

  • Pokazywanie przedmiotu - [i] w wiadomości wyświetla trzymany przedmiot z hoverem
  • Pokazywanie lokalizacji - [pos] wstawia współrzędne gracza jako klikalny element
  • Pokazywanie ekwipunku - [inv] pozwala innym graczom podejrzeć ekwipunek (konfigurowalne)

Te funkcje działają na zasadzie zdefiniowanych wzorców w konfiguracji. Możesz dodawać własne wzorce z dowolnymi akcjami i warunkami przez skrypty Kether.

Komendy i uprawnienia

Komenda Opis Uprawnienie
/trchat reload Przeładowuje konfigurację trchat.admin
/channel nazwa Przełącza kanał czatu trchat.channel.nazwa
/msg gracz tekst Wysyła prywatną wiadomość trchat.msg
/ignore gracz Ignoruje wiadomości gracza trchat.ignore
/chatcolor Otwiera menu wyboru koloru czatu trchat.color

Wskazówki

  • MiniMessage wymaga Paper - pełna obsługa MiniMessage działa tylko na Paper 1.16.5+. Na starszym Spigot plugin używa starych kodów kolorów
  • TabooLib się automatycznie pobiera - przy pierwszym uruchomieniu TrChat pobierze bibliotekę TabooLib. Wymaga to dostępu do internetu na serwerze
  • Kether to potężne narzędzie - skrypty Kether pozwalają na zaawansowane warunki (np. inny format czatu w zależności od świata gracza)
  • Kompatybilność z Folia - jeśli planujesz migrację na Folia, TrChat jest jednym z bezpiecznych wyborów dla systemu czatu
  • Przedmioty na czacie - funkcja [i] jest bardzo popularna wśród graczy. Ustaw uprawnienie trchat.function.item jako domyślne

Powiązane pluginy: PlaceholderAPI (placeholdery), Vault (prefixy rang), TAB (lista graczy i tablist).