Radio z efektami na kanałach

Ten serwer przesyła głos radiowy między graczami na tym samym kanale i nakłada na niego efekt (wokoder 3200, radio analogowe, cyfrowe P25). Mowa zwykła zostaje na pma-voice.

Jak to działa

• Uprawnienia: gracz nie może wejść na kanał, na który serwer gry mu nie pozwolił. Serwer FiveM prosi serwer webowy o jednorazowy token (ważny 60 s), dopiero z nim gracz łączy się po WebSocket.
• Efekt: liczony w przeglądarce (CEF) każdego odbiorcy, na podstawie jakości sygnału z gry: odległość od wież, strefy martwe, jammery, woda. Słaby sygnał = szum, węższe pasmo, rwanie, brak zasięgu = radio milknie.
• Dwa tryby: mode = 'web' (to, co opisuje poradnik) albo mode = 'pma' (głos radiowy przez pma-voice z efektem GTA, bez serwera webowego).

Test na localhost (bez gry)

Strona działa wyłącznie przez serwer. Nie otwieraj test.html z dysku (file://), bo przeglądarka zablokuje mikrofon i zapytania.

1. Zainstaluj Node.js 18 lub nowszyPobierz wersję LTS z nodejs.org. Sprawdź:

   node -v

   Kopiuj
2. Uruchom serwerW folderze web kliknij dwukrotnie start-test.bat. To samo ręcznie:

   cd web
   npm install
   npm start

   Kopiuj
3. Otwórz stronę testowąhttp://localhost:3000/test — wpisz nick i kanał, kliknij „Połącz”, przytrzymaj spację i mów.
4. Sprawdź z drugą osobą (albo drugą kartą)Otwórz tę samą stronę w drugiej karcie z tym samym kanałem. Albo w jednej karcie włącz „Słyszę siebie”. Używaj słuchawek.
5. Pobaw się efektemZmieniaj preset (Wokoder 3200, Analog, Cyfrowy) i suwak jakości sygnału. Poniżej 45% głos zaczyna się rwać, poniżej 3% radio nie ma zasięgu.

Wdrożenie na VPS (Ubuntu 22.04 / 24.04)

Twój VPS: 49.13.53.85 (Ubuntu). Wystarczy 1 vCPU i 1 GB RAM na kilkadziesiąt osób. Wszystkie polecenia poniżej są już dla tego adresu.

1. Sprawdź nazwę (bez konfiguracji DNS)Nazwa 49-13-53-85.sslip.io od razu wskazuje na 49.13.53.85. Sprawdź na swoim komputerze:

   nslookup 49-13-53-85.sslip.io

   Kopiuj
   Powinien wrócić adres 49.13.53.85.
2. Zaloguj się i zaktualizuj system, włącz zaporęNajpierw połącz się (z komputera):
   na Twoim komputerze

   ssh root@49.13.53.85

   Kopiuj
   na VPS

   sudo apt update && sudo apt -y upgrade
   sudo apt -y install ufw curl
   sudo ufw allow OpenSSH
   sudo ufw allow 80/tcp
   sudo ufw allow 443/tcp
   sudo ufw enable

   Kopiuj

   Hetzner ma też osobną zaporę w panelu (Cloud Console → Firewalls). Jeśli ją masz, dodaj tam reguły przychodzące TCP 80 i 443 (22 już działa). Bez portu 80 certyfikat się nie wystawi.

   Portu 3000 nie otwieraj. Serwer Node nasłuchuje tylko lokalnie, a ruch z internetu przechodzi przez Caddy (HTTPS).

3. Zainstaluj Node.js 20

   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
   sudo apt -y install nodejs
   node -v

   Kopiuj
4. Wgraj pliki serweraSkopiuj folder web z komputera na VPS (z komputera, nie z VPS):
   na Twoim komputerze

   scp -r web root@49.13.53.85:/tmp/cs-radio
   ssh root@49.13.53.85

   Kopiuj
   na VPS

   sudo mkdir -p /opt/cs-radio
   sudo cp -r /tmp/cs-radio/. /opt/cs-radio/
   cd /opt/cs-radio
   sudo npm install --omit=dev

   Kopiuj
5. Utwórz plik .env z sekretemSekret to hasło między serwerem FiveM a serwerem webowym. Musi być długi i losowy:

   cd /opt/cs-radio
   SECRET=$(openssl rand -hex 32)
   echo "$SECRET"            # skopiuj, przyda się w sv_config.lua
   sudo tee .env >/dev/null <<EOF
   NODE_ENV=production
   HOST=127.0.0.1
   PORT=3000
   RADIO_SECRET=$SECRET
   EOF
   sudo chmod 600 .env

   Kopiuj

   W trybie production serwer odmówi startu, jeśli RADIO_SECRET jest pusty lub równy CHANGE_ME. Endpoint testowy /api/dev-token jest wtedy wyłączony.

6. Uruchom jako usługę (systemd)
   /etc/systemd/system/cs-radio.service

   [Unit]
   Description=cs_pdradio web (voice relay)
   After=network.target
   
   [Service]
   WorkingDirectory=/opt/cs-radio
   ExecStart=/usr/bin/node server.js
   Restart=always
   RestartSec=3
   User=www-data
   Group=www-data
   NoNewPrivileges=true
   
   [Install]
   WantedBy=multi-user.target

   Kopiuj

   sudo chown -R www-data:www-data /opt/cs-radio
   sudo systemctl daemon-reload
   sudo systemctl enable --now cs-radio
   sudo systemctl status cs-radio --no-pager
   curl http://127.0.0.1:3000/api/health

   Kopiuj
7. Włącz HTTPS (Caddy, certyfikat automatycznie)

   sudo apt -y install debian-keyring debian-archive-keyring apt-transport-https
   curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
   curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
   sudo apt update && sudo apt -y install caddy

   Kopiuj
   /etc/caddy/Caddyfile

   49-13-53-85.sslip.io {
       encode gzip
       reverse_proxy 127.0.0.1:3000
   }

   Kopiuj

   sudo systemctl reload caddy
   curl https://49-13-53-85.sslip.io/api/health

   Kopiuj

   Caddy sam pobierze certyfikat Let's Encrypt dla 49-13-53-85.sslip.io i obsłuży WebSocket (wss://). Wolisz nginx? Użyj bloku location / z proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; i proxy_pass http://127.0.0.1:3000;.

   HTTPS jest obowiązkowy. Menu NUI w FiveM działa na HTTPS, więc przeglądarka (CEF) zablokuje ramkę z http:// (mieszana treść) i mikrofon. Wyjątek to wyłącznie localhost.

8. Sprawdź z zewnątrzNa swoim komputerze otwórz https://49-13-53-85.sslip.io/ (certyfikat wystawia się przy pierwszym wejściu, daj mu kilkanaście sekund). U góry tej strony status powinien być zielony, a https://49-13-53-85.sslip.io/test pozwoli przetestować głos na serwerze produkcyjnym dopiero po zalogowaniu na /live (hasło z instalatora). Bez logowania pokaże komunikat o braku dostępu, to jest zamierzone.

Aktualizacja i logi

sudo journalctl -u cs-radio -f          # logi na żywo
sudo systemctl restart cs-radio          # restart po zmianach
# aktualizacja: wgraj nowe pliki do /opt/cs-radio, potem
cd /opt/cs-radio && sudo npm install --omit=dev && sudo systemctl restart cs-radio

Podpięcie pod serwer FiveM

1. Wgraj zasobySkopiuj do resources/ serwera gry oba foldery z resource/: cs_pdradio (skrypt) i cs_pdradio_props (modele: wieża radiowa, anteny, drabinka, przekaźnik komórkowy, serwerownia; 16 MB). Bez cs_pdradio_props wieże nie będą widoczne w świecie, a reszta radia działa normalnie.
2. Adres dla graczy — config.lua
   cs_pdradio/config.lua

   Config.voice = {
       mode   = 'web',
       webUrl = 'https://49-13-53-85.sslip.io',   -- publiczny adres HTTPS (to już jest ustawione)
   }

   Kopiuj
3. Sekret i adres API — sv_config.lua (tylko serwer)
   cs_pdradio/sv_config.lua

   ServerConfig = {
       -- działa z każdego miejsca (FiveM na VPS lub na innej maszynie):
       webApi = 'https://49-13-53-85.sslip.io',
       -- FiveM na TYM SAMYM VPS (49.13.53.85):  webApi = 'http://127.0.0.1:3000'
       secret = 'TU_WKLEJ_SEKRET_Z_ENV',          -- identyczny jak RADIO_SECRET
   }

   Kopiuj

   Sekret możesz też ustawić w server.cfg: set cs_pdradio_secret "..." (ma pierwszeństwo przed plikiem). Plik sv_config.lua nigdy nie trafia do graczy.

4. server.cfg

   ensure pma-voice
   ensure cs_pdradio_props
   ensure cs_pdradio
   
   # administratorzy radia (panel /radioadmin)
   add_ace group.admin cs_pdradio.admin allow
   # opcjonalnie: odporność na jammery, uprawnienia do grup kanałów
   add_ace group.police cs_pdradio.jammerimmune allow

   Kopiuj
5. Uruchom i sprawdźW grze: /radio, potem /radio power. Na ekranie radia nie powinno być napisu VOICE OFFLINE. W konsoli serwera przy problemie pojawi się komunikat o nieudanym grant. W panelu /radioadmin zakładka Overview pokazuje, czy serwer webowy jest online.

Użycie i panel admina

PTT (nadawanie) ustawiasz w ustawieniach GTA: Key Bindings → FiveM → Radio: push to talk (domyślnie CapsLock). Kursor nad radiem (żeby klikać przyciski) i inne klawisze ustawiasz tam samo.

Panel admina (/radioadmin)

Dane (wieże, jammery, strefy, kanały, efekty) zapisują się w cs_pdradio/data/state.json i wracają po restarcie. Przycisk „Show on map” w stopce panelu rysuje wieże, jammery i strefy na mapie.

Efekty głosu

Efekty odwzorowują to, co naprawdę robi radio, zamiast „losowych” filtrów. Wszystko liczy się w przeglądarce odbiorcy, na podstawie jakości sygnału z gry.

Zasięg: jak psuje się sygnał

Wieże, przekaźniki i animacje

Modele pochodzą z oryginalnego radia (folder cs_pdradio_props). Nie uruchamiaj ich razem ze starym zasobem z tymi samymi modelami, bo nazwy pojazdów (sonoran, mobilecell, serverrack) by się dublowały.

Dźwięki tła w mikrofonie (syrena, helikopter, strzały)

Gdy trzymasz PTT, do nadawanego głosu dochodzi to, co dzieje się wokół Ciebie. Słyszą to wszyscy na kanale, a radio spłaszcza i przesterowuje to tak jak prawdziwe.

Skrypt Lua sam wykrywa typ pojazdu, syrenę (tylko z włączonym dźwiękiem), prędkość i strzały i wysyła to do radia. Efekt sprawdzisz na stronie /test (wybór pojazdu, syrena, prędkość, przyciski „Strzał” i „Seria”, a „Słyszę siebie” pokaże to, co słyszą inni).

Ekran radia: styl Windows 98

Ekran radia wygląda jak okno Windows 98 i ma osobny układ zależnie od tego, gdzie jesteś:

Grafiki obudów (krótkofalówka, radio mobilne, panel lotniczy) pochodzą z oryginalnych skinów w skins/. Przyciski na ekranie klikasz po włączeniu kursora (klawisz „Radio: mouse cursor” albo przycisk □ w oknie). Komenda /radiodebug wypisuje stan radia w konsoli F8.

Zagłuszanie i trzaski

Odpowiedź na pytanie „czy to zależy od wież?”: tak, jakość sygnału (zasięg) liczy skrypt Lua po stronie gracza z danych o wieżach, strefach i wodzie, a serwer webowy tylko ją odtwarza jako dźwięk. Zagłuszanie jammerem i trzaski pogodowe to osobne źródła zakłóceń, niezależne od wież. Poziomy sprawdzisz w grze komendą /radiosignal.

Przytłumienie (muffling)

Każdy preset ma parametr muffle (0–100%), który ścina wysokie tony i zmiękcza środek pasma. Vocoder 3200 ma go domyślnie ustawionego mocniej (ciemniejsze, „przytłumione” brzmienie). Zmienisz go w /radioadmin → Effects (suwak „Muffling”) lub na stronie /test.

Liczy się gorszy sygnał z dwóch: nadawcy i odbiorcy. Szum eteru działa tylko wtedy, gdy ktoś nadaje (jak przy zamkniętym squelchu).

Strojenie: w panelu /radioadmin → Effects ustawiasz preset, siłę wokodera i szum. Własne wartości (pasmo, zniekształcenie, squelch itd.) są w public/radio-client.js w obiekcie PRESETS, a sam kodek w public/vocoder.js. Zmiany w tych plikach sprawdzisz od razu na stronie /test.

Rozwiązywanie problemów

Bezpieczeństwo

• Nigdy nie wpisuj sekretu do config.lua (ten plik trafia do graczy). Tylko sv_config.lua albo convar.
• Zostaw HOST=127.0.0.1 i wystawiaj serwer wyłącznie przez Caddy / nginx z HTTPS.
• Tokeny wejścia są jednorazowe i wygasają po 60 s; jedno połączenie na gracza; limit przepustowości i rozmiaru ramki na klienta.
• Jakość sygnału przesyła klient. Złośliwy gracz może więc zgłosić lepszy sygnał dla własnego głosu. To tylko kosmetyka efektu, nie omija uprawnień do kanałów.
• Strona testowa i /api/dev-token działają tylko poza NODE_ENV=production.