Proximity VoiceChat

Voice chat for Hytale servers with a fast, friendly web onboarding flow.

About

Hytale Voice is a local voice relay mod with a built-in web UI. Players join with a browser, complete a short onboarding flow, and hop into voice with push-to-talk and a live mic meter.

Features

• Web-based onboarding for login, server URL, and mic setup
• Built-in health checks for WebSocket, auth, mic, and server response
• Mic test with sensitivity slider, push-to-talk, and live meter
• Local relay to keep voice traffic close to your server

Requirements

• SSL certificate for the web UI (see reverse proxy example)

Installation

1. Download the pre-built jar from CurseForge.
2. Install: Place the jar into your Hytale server mods folder.
3. Open the web UI: Visit https://<your-domain>/.

SSL via Reverse Proxy (Example)

The web UI requires HTTPS. Use a reverse proxy with an SSL certificate in front of your server.

Example Nginx config:

server {
  listen 443 ssl;
  server_name your-domain.example;

  ssl_certificate /etc/letsencrypt/live/your-domain.example/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/your-domain.example/privkey.pem;

  location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
  }
}

Planned Features (Exact List)

1. In-game overlay controls for push-to-talk, mute, and mic meter.
2. Proximity voice with distance attenuation and optional zone rooms.
3. Party/guild voice channels with quick switching.
4. Noise suppression and automatic gain control (AGC).
5. Per-player volume mixer with persistent settings.
6. Admin tools: live user list, mute/kick, diagnostics.
7. Crash-safe reconnection with state restore.
8. Accessibility: voice activity indicators and optional captions.

Troubleshooting

• WebSocket errors: verify the server URL and that the endpoint is reachable at /voice.
• Auth errors: log in again or check player info.
• Mic errors: allow browser microphone permissions and retry the mic test.

Feedback

Send comments or write me on discord (@giulien). Server owner feedback is especially helpful.