Simple Voice Chat na serwerze Minecraft: instalacja i problemy

W skrócie: Simple Voice Chat dodaje do Minecraft Java czat głosowy zbliżeniowy: im bliżej siebie stoją gracze, tym lepiej się słyszą. Potrzebny jest plugin lub mod na serwerze, mod u każdego gracza i port UDP osiągalny z internetu. Komunikat „Czat głosowy nie jest połączony” (po angielsku „Voice chat not connected”) prawie zawsze oznacza, że klient nie dociera do tego portu UDP. Na serwerze HostValues rozwiązaniem jest jedna linijka: port=-1.

Własny serwer Minecraft? W HostValues od €2,80 miesięcznie, online w kilka minut. Zobacz plany →

Co jest potrzebne

• Na serwerze: plugin dla Bukkit, Spigot lub Paper albo mod dla Fabric, NeoForge, Forge lub Quilt. Serwery hybrydowe, takie jak Mohist czy Arclight, nie są obsługiwane.
• U każdego gracza: mod dla Fabric, NeoForge, Forge lub Quilt, także wtedy, gdy serwer używa pluginu na Paper. Bez moda gracz nadal wejdzie na serwer, ale bez czatu głosowego.
• Port UDP: dźwięk nie idzie przez połączenie Minecraft (TCP), tylko przez osobny port UDP, domyślnie 24454.

Instalacja na serwerze

1. Pobrać Simple Voice Chat z Modrinth lub CurseForge, w wersji pasującej do silnika serwera i wersji Minecraft.
2. Na Paper, Spigot lub Bukkit plik .jar trafia do folderu plugins, na Fabric, NeoForge, Forge lub Quilt do folderu mods. Fabric wymaga też Fabric API.
3. Raz uruchomić serwer: dopiero wtedy powstaje plik konfiguracyjny.
4. Ustawić port (opis niżej) i zrestartować serwer. Zmiany w konfiguracji działają dopiero po restarcie.

Portu czatu głosowego nie ustawia się więc w server.properties, tylko w tym pliku moda.

Port UDP i opcja port=-1

Opcja port ma domyślnie wartość 24454. Przy port=-1 Simple Voice Chat używa numeru portu serwera Minecraft: gra korzysta z tego portu przez TCP, a czat głosowy z tego samego numeru przez UDP. Przy starcie konsola potwierdza to wierszem Using the Minecraft servers port as voice chat port.

Twórcy moda co do zasady odradzają to ustawienie, bo z UDP na tym porcie domyślnie korzysta też zapytanie serwera (query), co może doprowadzić do awarii serwera. Ich dokumentacja wymaga więc przede wszystkim, żeby query nie działało na tym samym porcie co czat głosowy: wystarczy zostawić enable-query=false (wartość domyślna) w server.properties albo ustawić inny query.port. Tego portu nie może też używać inny plugin UDP, na przykład GeyserMC.

Na serwerze HostValues: jeden port wystarczy

Serwer Minecraft w HostValues dostaje jeden port: ten z adresu widocznego w panelu gry, w zakładce Network. Port jest otwarty dla TCP i UDP. Domyślny port 24454 nie jest przypisany do Państwa serwera, więc pozostawiony bez zmian daje dokładnie komunikat „Czat głosowy nie jest połączony”. Sposób, który działa:

1. Zainstalować plugin lub mod jak wyżej i raz uruchomić serwer.
2. W menedżerze plików otworzyć voicechat-server.properties i ustawić port=-1. Można też wpisać numer portu serwera; z -1 ustawienie pozostaje poprawne, nawet jeśli serwer kiedyś dostanie inny port.
3. Pola bind_address i voice_host zostawić puste.
4. Sprawdzić, czy w server.properties jest enable-query=false.
5. Zrestartować serwer. W konsoli pojawi się Voice chat server started at 0.0.0.0: z portem serwera.

Na serwerze działa też Geyser? Geyser potrzebuje własnego portu, dla TCP i UDP, a nie portu serwera Java, więc nie koliduje z port=-1. Jeśli w zakładce Network widać tylko jeden port, wystarczy otworzyć zgłoszenie do supportu, a przygotujemy dodatkowy port dla Geysera; ten numer wpisuje się w bedrock.port w konfiguracji Geysera.

Instalacja moda u gracza

1. Zainstalować w launcherze Fabric (z Fabric API), NeoForge, Forge lub Quilt dla tej samej wersji Minecraft, której używa serwer.
2. Wrzucić plik .jar Simple Voice Chat do folderu mods i uruchomić grę.
3. Po wejściu na serwer pojawi się komunikat o konfiguracji czatu głosowego: klawisz V otwiera przewodnik.
4. Wybrać mikrofon i głośniki oraz tryb mówienia: przytrzymanie klawisza (push to talk) albo aktywację głosem. Push to talk nie ma domyślnego klawisza, przewodnik prosi o jego wybór.

Inne klawisze: M wycisza mikrofon (przy aktywacji głosem), N wyłącza czat głosowy, a H ukrywa ikony. Wszystkie można zmienić w ustawieniach sterowania Minecraft.

„Czat głosowy nie jest połączony”: przyczyny po kolei

Ten komunikat pojawia się nad paskiem szybkiego wyboru, gdy gracz naciśnie klawisz czatu głosowego, a jego klient nie ma połączenia głosowego; na ekranie widać też ikonę odłączonej wtyczki. Warto sprawdzić po kolei:

1. Konsolę serwera. Po starcie powinien być widoczny wiersz Voice chat server started. Komunikat Address already in use oznacza, że ten port zajmuje już inny program: druga instancja czatu głosowego, GeyserMC albo query. Przy Failed to bind to address pole bind_address trzeba zostawić puste.
2. Port. Numer w port musi być osiągalny z zewnątrz przez UDP. U firmy hostingowej to port przypisany do serwera, w HostValues po prostu port=-1. Na VPS trzeba go otworzyć w zaporze (np. ufw allow 24454/udp), a w Dockerze opublikować z dopiskiem /udp, bo bez niego przechodzi tylko TCP.
3. Wersję moda. Między klientem a serwerem muszą się zgadzać tylko dwie pierwsze liczby: serwer 2.6.x przyjmie klienta 2.6.y, ale nie 2.5.x. W przeciwnym razie gracz zobaczy na czacie „Twoja wersja klienta czatu głosowego nie jest kompatybilna z wersją po stronie serwera” wraz z wersją do zainstalowania.
4. Sieć gracza. Jeśli połączyć się nie może tylko jedna osoba, warto sprawdzić inny serwer. Dane mobilne i niektóre VPN blokują UDP; mod OpSec też może blokować pakiety czatu głosowego, jeśli nie jest ustawiony tak, by je przepuszczał.
5. Proxy. Za Velocity lub BungeeCord potrzebny jest plugin proxy Simple Voice Chat (opis niżej).
6. Ochronę DDoS. Niektóre zabezpieczenia filtrują UDP. Jeśli po stronie serwera wszystko się zgadza, warto poprosić firmę hostingową o sprawdzenie.

Test połączenia

W grze operator może wpisać /voicechat test <gracz> (uprawnienie voicechat.admin). Komendy czatu głosowego działają tylko w grze, nie w konsoli. Odpowiedź pokazuje, gdzie leży problem:

• „Gracz … nie ma zainstalowanego moda Simple Voice Chat”: brak moda u gracza albo niezgodna wersja;
• „Klient nie jest połączony”: mod jest, ale połączenie UDP nie doszło do skutku, więc trzeba sprawdzić port;
• odebrany ping w milisekundach: połączenie działa.

Bez uruchamiania gry port UDP można sprawdzić narzędziem wiersza poleceń svc od twórców moda (svc-cli-utils): svc ping adres:port. Zwykłe narzędzia do sprawdzania portów tu nie wystarczą, bo UDP nie nawiązuje połączenia.

Za proxy Velocity lub BungeeCord

Simple Voice Chat instaluje się na każdym serwerze za proxy, a na Velocity lub BungeeCord/Waterfall dodatkowo plugin proxy. Plugin przekazuje dźwięk do właściwego serwera, więc wystarczy jeden port UDP na proxy, domyślnie ten sam numer co port Minecraft proxy (na Velocity 25577). Z pluginem proxy opcja voice_host serwerów jest ignorowana. Jeśli kilka serwerów działa na tej samej maszynie, każdy potrzebuje własnego portu głosowego.

Najważniejsze ustawienia

Najczęściej zadawane pytania

Jaki port ma Simple Voice Chat?

Domyślnie 24454 UDP. Zmienia się go opcją port w voicechat-server.properties. Na serwerze HostValues wystarczy port=-1, aby czat głosowy używał portu serwera.

Dlaczego widzę „Czat głosowy nie jest połączony”?

Klient nie dociera do portu UDP czatu głosowego. Najczęściej port w konfiguracji nie jest portem otwartym do serwera; dalej są niezgodna wersja moda i sieć, która blokuje UDP.

Czy Simple Voice Chat trzeba zainstalować u gracza?

Tak. Każdy, kto chce mówić i słyszeć innych, potrzebuje moda w kliencie Fabric, NeoForge, Forge lub Quilt, nawet gdy serwer używa pluginu na Paper.

Czy gracze Bedrock mogą korzystać z czatu głosowego?

Nie. Simple Voice Chat to mod do Minecraft Java, a gracze, którzy dołączają przez Geyser, nie mogą go zainstalować.

Źródła: oficjalna dokumentacja Simple Voice Chat na modrepo.de (Server Setup, Server Config, Troubleshooting, Proxy Setup, Compatibility) oraz kod źródłowy projektu henkelmax/simple-voice-chat na GitHubie. Stan na 14 października 2026.