Notatki operatora
Simple Voice Chat na serwerze Minecraft: port, konfiguracja i naprawa
Simple Voice Chat to mod do czatu głosowego z zasięgiem w Minecrafcie, a jednocześnie jeden z najczęstszych powodów pytań „czemu nie działa”. Prawie zawsze chodzi o drugi port UDP, którego nie widać w server.properties. Tu jest wszystko po kolei: instalacja, ustawienia, porty, proxy i lista objawów z przyczynami.
W skrócie: Simple Voice Chat musi być zainstalowany na serwerze i u każdego gracza (także wtedy, gdy na serwerze stoi wersja pluginowa dla Papera). Dźwięk idzie osobnym portem 24454 UDP, niezależnie od portu gry 25565. Jeśli w grze widzisz ikonę wtyczki zamiast mikrofonu, najczęściej ten port nie jest otwarty: w zaporze, na routerze albo w panelu hostingu. Nie ustawiaj voice chatu na tym samym porcie co serwer, bo UDP na porcie gry zajmuje zapytanie (query). Stan na październik 2026 według dokumentacji projektu.
Najważniejsze ustawienia i ich wartości domyślne
Konfiguracja serwerowa nie siedzi w server.properties, tylko w osobnym pliku voicechat-server.properties:
- Fabric, NeoForge, Forge, Quilt:
config/voicechat/voicechat-server.properties - Bukkit, Spigot, Paper:
plugins/voicechat/voicechat-server.properties
| Klucz | Domyślnie | Co robi |
|---|---|---|
port | 24454 | port UDP dla dźwięku; -1 oznacza port serwera Minecraft (odradzane) |
bind_address | puste | puste = adres z server-ip; * = wszystkie adresy |
voice_host | puste | adres, pod który łączą się klienci; ruszaj tylko przy proxy UDP |
max_voice_distance | 48 | zasięg słyszalności w blokach |
whisper_distance | 24 | zasięg szeptu |
codec | VOIP | tryb kodeka Opus: VOIP, AUDIO lub RESTRICTED_LOWDELAY |
mtu_size | 1275 | maksymalny rozmiar pakietu audio w bajtach |
keep_alive | 1000 | co ile milisekund idzie pakiet podtrzymujący |
enable_groups | true | czy wolno tworzyć grupy głosowe |
allow_recording | true | czy gracze mogą nagrywać rozmowy |
force_voice_chat | false | wyrzuca graczy bez moda |
login_timeout | 10000 | ile ms serwer czeka na wykrycie moda (gdy force_voice_chat=true) |
spectator_interaction | false | czy obserwatorzy mogą mówić do graczy |
Każda zmiana w tym pliku działa dopiero po restarcie serwera. Najczęstsze „nie działa mimo zmiany” to właśnie brak restartu.
Jak to działa i dlaczego potrzebny jest drugi port
Minecraft przesyła rozgrywkę po TCP na porcie serwera, domyślnie 25565. Simple Voice Chat nie wciska dźwięku w to połączenie, tylko otwiera własny kanał UDP. Dzięki temu głos ma niskie opóźnienie, ale serwer potrzebuje drugiego, otwartego z zewnątrz portu. Przez połączenie Minecrafta idą tylko komunikaty sterujące, na przykład dołączanie do grupy czy wyciszenie (ich częstotliwość ogranicza tcp_rate_limit, domyślnie 16 pakietów na sekundę).
Autorzy wprost odradzają ustawienie port=-1, czyli użycie tego samego numeru co serwer gry. UDP na porcie gry jest domyślnie zajęte przez zapytania o stan serwera, a nałożenie się obu usług może wywalić serwer.
Instalacja: serwer i klient
Zasada jest jedna: mod albo plugin musi być po obu stronach. Gracz bez moda wejdzie na serwer, ale nie usłyszy ani nie powie nic przez voice chat.
- Fabric, NeoForge, Forge, Quilt: plik moda trafia do folderu
modsna serwerze i u graczy. Fabric wymaga aktualnego Fabric API i Fabric Loadera, inaczej serwer zgłosi brakującą zależność. - Paper, Spigot, Bukkit: plik pluginu wrzucasz do
plugins. Gracze nadal muszą mieć wersję moda pod Fabric, NeoForge, Forge albo Quilt w swoim launcherze. - Velocity, BungeeCord, Waterfall: osobny plugin proxy do
pluginsproxy, a dodatkowo plugin lub mod na każdym serwerze za proxy.
Wszystkie wersje są ze sobą zgodne, z dwoma wyjątkami z dokumentacji. Klienci z NeoForge nie połączą się z serwerem na Forge. A serwery hybrydowe, które łączą pluginy z modami (Mohist, Arclight, Magma, Cardboard), nie są wspierane: albo same pluginy, albo same mody.
Zgodność wersji samego moda: liczą się dwie pierwsze liczby numeru. Serwer z 2.6.24 wpuści klienta z 2.6.0, ale już nie z 2.5.x.
Które wersje Minecrafta są wspierane
Według listy wspieranych wersji na stronie projektu mod jest aktywnie rozwijany między innymi dla 26.3, 26.2, 26.1.x, 1.21.11, 1.21.10, 1.21.8, 1.21.5, 1.21.4, 1.21.1, 1.20.1, a także starszych 1.19.2, 1.18.2, 1.16.5 i 1.12.2 (ta ostatnia tylko Forge). Wersje 1.21.9, 1.21.7 i 1.21.6 nie mają wydania moda. Jeśli twój modpack stoi akurat na jednej z nich, voice chatu w wersji moda nie dołożysz.
Plugin jest prostszy, bo jeden plik obsługuje wiele wersji gry. Na Modrinth wersja bukkit-2.6.24 z 20 września 2026 ma na liście wersje gry od 1.8.8 do 26.3 i działa na Bukkit, Spigot, Paper, Purpur oraz Folia. Wydania moda 2.6.24 (dla wszystkich wersji gry, także 26.3) są na Modrinth oznaczone jako beta, a plugin jako wydanie stabilne.
Otwarcie portu krok po kroku
VPS albo serwer dedykowany
Otwierasz 24454 UDP w zaporze systemu (na przykład ufw allow 24454/udp) oraz, jeśli dostawca ma własny firewall w panelu, także tam.
Komputer w domu
Port trzeba otworzyć w zaporze komputera i przekierować na routerze, dokładnie tak jak port gry, tylko z protokołem UDP. Szczegóły dla popularnych routerów są w poradniku o przekierowaniu portów. Uwaga od autorów, o której mało kto pamięta: jeśli grasz na tym samym komputerze, na którym stoi serwer, łącz się adresem lokalnym albo localhost, a nie publicznym IP. Router musi też pozwalać urządzeniom w sieci domowej na komunikację między sobą.
Pterodactyl
W panelu administratora dodajesz drugi przydział portu: najpierw w Settings, Nodes, twój węzeł, Allocation tworzysz nowy przydział z adresem serwera i portem 24454, potem w Servers, twój serwer, Build Configuration, Allocation Management przypisujesz go jako dodatkowy port.
Docker
Mapowanie musi mieć dopisek /udp: "24454:24454/udp". Sam zapis 24454:24454 otwiera tylko TCP i voice chat się nie połączy.
Hosting zarządzany
Dokumentacja projektu utrzymuje listę instrukcji dla konkretnych firm hostingowych i wyraźnie ostrzega, żeby nie stosować instrukcji przygotowanej dla innego dostawcy, bo to zwykle psuje konfigurację. Jeśli twojego hostingu nie ma na liście, zapytaj jego wsparcie, który dodatkowy port UDP możesz dostać, i wpisz go jako port.
Serwer za proxy Velocity lub BungeeCord
Z pluginem Simple Voice Chat na proxy sprawa jest prosta: plugin sam wykrywa porty voice chatu na serwerach za proxy i przekazuje ruch. Na zewnątrz otwierasz tylko jeden port UDP, domyślnie ten sam co port gry proxy, czyli dla Velocity 25577. Jeśli proxy i serwery stoją na jednej maszynie, każdy serwer musi mieć inny port voice chatu.
Bez pluginu na proxy każdy serwer wystawia własny port, a gdy serwery stoją na innych maszynach niż proxy, w ich konfiguracji ustawiasz voice_host na publiczny adres maszyny z danym serwerem, nie proxy. O budowie takiej sieci piszemy w tekście o sieci serwerów i proxy Velocity.
Voice chat nie działa: najczęstsze przyczyny
| Objaw | Przyczyna i naprawa |
|---|---|
| Ikona wtyczki, brak połączenia | port UDP nie jest otwarty albo przekierowany; przy hostingu bywa to też ochrona DDoS, którą wsparcie musi wyłączyć lub dodać wyjątek |
| Tylko jedna osoba nie może się połączyć | jej operator blokuje UDP (częste na internecie mobilnym) albo przeszkadza VPN; sprawdź na innym serwerze |
| Serwer pada przy starcie: Address already in use | port zajęty: druga instancja voice chatu, inny plugin na UDP (na przykład Geyser) albo query.port z server.properties na tym samym numerze |
| Serwer pada przy starcie: Failed to bind to address | źle ustawiony bind_address; zostaw pusty, jeśli nikt nie kazał go zmieniać |
| Połączenie przez IPv6 nie działa | pakiety wychodzą z innego adresu IPv6 niż otwarty; ustaw bind_address na właściwy adres albo wyłącz adresy tymczasowe |
| Słychać wszystkich niezależnie od odległości | jesteś w grupie; wyjdź z niej i zasięg wróci |
| Nie ma portu w server.properties | bo go tam nie ma; szukaj w voicechat-server.properties |
Do diagnozy przydaje się komenda /voicechat test <gracz>, która sprawdza połączenie wskazanej osoby. Wymaga uprawnienia voicechat.admin, które domyślnie mają tylko operatorzy. Komendy voice chatu działają wyłącznie z gry, nie z konsoli.
Uprawnienia i skróty klawiszowe
Plugin korzysta z systemu uprawnień serwera, więc na Paperze sterujesz nim przez LuckPerms. Trzy uprawnienia są domyślnie przyznane wszystkim: voicechat.listen (słuchanie), voicechat.speak (mówienie) i voicechat.groups (grupy). Zabranie voicechat.speak randze gościa to prosty sposób na serwer, na którym nowi gracze najpierw słuchają.
Po stronie gracza: V otwiera menu voice chatu, M wycisza mikrofon (w trybie aktywacji głosem), N wyłącza voice chat całkiem, H chowa ikony. Menu grup ma klawisz G tylko do wersji 1.21.5; od 1.21.6 nie jest przypisane domyślnie. Push to talk ustawiasz w kreatorze przy pierwszym uruchomieniu.
Gdzie postawić serwer z voice chatem
Jeśli masz już serwer w domu i działa, nie ma powodu go przenosić. Jeśli dopiero wybierasz, sprawdź przed zakupem, czy dostawca daje dodatkowy port UDP, bo bez niego plugin nie ruszy. Co jeszcze ma znaczenie przy wyborze, zebraliśmy w tekście o hostingu serwera Minecraft, a gotowy serwer Java znajdziesz w ofercie Supercraft.
Pełna lista opcji konfiguracji jest w dokumentacji Simple Voice Chat.
Najczęstsze pytania
Jaki port używa Simple Voice Chat? Domyślnie 24454, protokół UDP. To osobny port, niezależny od portu gry 25565, i musi być otwarty z zewnątrz: w zaporze, na routerze albo w panelu hostingu. Numer zmienisz w pliku voicechat-server.properties w ustawieniu port.
Gdzie jest plik konfiguracyjny Simple Voice Chat? Na serwerach Fabric, NeoForge, Forge i Quilt w config/voicechat/voicechat-server.properties, a na Bukkit, Spigot i Paper w plugins/voicechat/voicechat-server.properties. Port voice chatu nie jest ustawiany w server.properties.
Dlaczego w Simple Voice Chat widzę ikonę wtyczki? Ikona oznacza brak połączenia z serwerem głosowym. Najczęściej port UDP nie jest otwarty albo przekierowany. Inne przyczyny to ochrona DDoS u dostawcy, mapowanie w Dockerze bez dopisku /udp, operator blokujący UDP na internecie mobilnym oraz VPN.
Czy gracze muszą instalować Simple Voice Chat? Tak. Mod musi być u każdego gracza, także wtedy, gdy na serwerze Paper działa wersja pluginowa. Gracz bez moda wejdzie na serwer, ale nie będzie mógł mówić ani słyszeć innych przez voice chat.
Czy mogę ustawić voice chat na tym samym porcie co serwer? Technicznie tak, wartością port=-1, ale autorzy wyraźnie to odradzają. UDP na porcie gry jest domyślnie używane przez zapytania o stan serwera, a nałożenie się obu usług może wywalić serwer.