Co to jest VentureChat

VentureChat (dawniej MineverseChat) to darmowy, open-source plugin czatowy rozwijany od 2013 roku. Oferuje kompletny system wielokanałowej komunikacji, który zastępuje domyślny czat Minecrafta zaawansowanym rozwiązaniem z pełną kontrolą nad formatem, zasięgiem i uprawnieniami wiadomości.

Plugin jest szczególnie popularny na dużych sieciach serwerów, ponieważ natywnie obsługuje BungeeCord i Velocity. Gracze mogą rozmawiać na kanałach globalnych (widocznych na wszystkich serwerach proxy) lub lokalnych (ograniczonych do jednego serwera czy określonego zasięgu bloków).

VentureChat jest dostępny na SpigotMC oraz GitHub. Wymaga Javy 8+ i działa na wersjach Minecraft od 1.8 do 1.21.x.

System kanałów

Główną cechą VentureChat jest możliwość tworzenia dowolnej liczby kanałów czatu. Każdy kanał ma osobne ustawienia zasięgu, koloru, formatu i uprawnień. Typowa konfiguracja serwera obejmuje:

Global - kanał widoczny dla wszystkich graczy na serwerze (lub całej sieci BungeeCord)
Local - wiadomości widoczne tylko w promieniu np. 200 bloków od nadawcy
Staff - prywatny kanał dla administracji, niedostępny dla zwykłych graczy
Trade - kanał handlowy do ogłoszeń kupna i sprzedaży
Help - kanał pomocowy, gdzie nowi gracze mogą zadawać pytania

Gracze przełączają się między kanałami komendą /ch nazwa lub wysyłają pojedynczą wiadomość na inny kanał bez przełączania się: /ch trade WTS diamentowy miecz 500$.

Formatowanie wiadomości

VentureChat obsługuje pełne formatowanie czatu z kolorami Minecraft, formatami tekstu (pogrubienie, kursywa, podkreślenie) oraz interaktywnymi elementami JSON:

Kolory i formaty - kody kolorów z & (np. &a dla zielonego, &l dla pogrubienia)
Hover text - po najechaniu na nick gracza wyświetla się podgląd z informacjami (ranga, statystyki)
Click events - kliknięcie w nick może uruchomić komendę (np. /msg) lub otworzyć link
Placeholdery - integracja z PlaceholderAPI umożliwia wstawianie dowolnych danych w format czatu

Format wiadomości definiujesz osobno dla każdego kanału i każdej grupy uprawnień. Możesz ustawić inny wygląd czatu dla VIP, moderatora i admina na tym samym kanale.

Konfiguracja

Główny plik konfiguracyjny to plugins/VentureChat/config.yml. Definicja kanału wygląda następująco:

channels:
  Global:
    color: white
    chatcolor: white
    mutable: true
    filter: true
    autojoin: true
    default: true
    distance: 0          # 0 = nieograniczony zasięg
    cooldown: 2           # sekundy między wiadomościami
    bungeecord: true      # widoczny na całej sieci
    format: "&8[&aG&8] {vault_prefix} {player_displayname}&f: "
    permissions: venturechat.global
  Local:
    color: yellow
    chatcolor: yellow
    mutable: true
    filter: true
    autojoin: true
    default: false
    distance: 200         # zasięg 200 bloków
    cooldown: 0
    bungeecord: false
    format: "&8[&eL&8] {player_displayname}&f: "
    permissions: venturechat.local

Sekcja filtrów pozwala blokować wulgaryzmy, spam (powtarzające się wiadomości), nadmierne wielkie litery i linki. Każdy filtr możesz włączyć lub wyłączyć osobno dla każdego kanału.

Komendy i uprawnienia

Komenda	Opis	Uprawnienie
`/ch nazwa`	Przełącza aktywny kanał czatu	venturechat.nazwa
`/leave nazwa`	Opuszcza kanał (nie widzi wiadomości)	venturechat.leave
`/join nazwa`	Dołącza ponownie do kanału	venturechat.join
`/msg gracz tekst`	Wysyła prywatną wiadomość	venturechat.msg
`/ignore gracz`	Ignoruje wiadomości od gracza	venturechat.ignore
`/chatreload`	Przeładowuje konfigurację	venturechat.reload
`/mute gracz kanał`	Wycisza gracza na danym kanale	venturechat.mute

Uprawnienia kanałów działają automatycznie - jeśli gracz ma uprawnienie venturechat.global, może pisać na kanale Global. Bez uprawnienia widzi kanał, ale nie może wysyłać wiadomości.

Wskazówki dla adminów

Ustaw kanał domyślny - jeden kanał powinien mieć default: true, żeby nowi gracze wiedzieli, gdzie pisać. Najczęściej jest to Global
Cooldown zapobiega spamowi - ustaw 2-3 sekundy cooldownu na kanałach publicznych, a 0 na kanale Staff
Filtr wulgaryzmów - dodaj polskie słowa do listy filtrów w filters.yml. Domyślna lista zawiera tylko angielskie wyrazy
BungeeCord wymaga pluginu na proxy - żeby czat globalny działał między serwerami, zainstaluj VentureChat także na serwerze BungeeCord/Velocity
Integracja z rangami - użyj {vault_prefix} w formacie, żeby wyświetlać prefiksy rang z LuckPerms przez Vault

Powiązane pluginy: PlaceholderAPI (placeholdery w czacie), LuckPerms (uprawnienia kanałów), DiscordSRV (synchronizacja czatu z Discordem).

VentureChat - wielokanałowy system czatu