How to configure Simple Voice Chat on a Minecraft server

Simple Voice Chat adds proximity voice to Minecraft Java Edition. The step that fails most often: opening UDP port 24454. This guide covers install, config and troubleshooting.

Mod or plugin: what to install

UDP port 24454

Audio and the game are separate channels. Voice chat uses UDP on the configured port, default 24454. Mapping only TCP does not fix it.

1. Open 24454/UDP in the firewall, security group or hosting panel.
2. Do not use the same port as query.port in server.properties.
3. In Docker: publish 24454:24454/udp explicitly.
4. If the panel assigns another UDP port, set port= in the config and restart.

Step-by-step install

Modded server (Fabric / Forge / NeoForge)

1. Stop the server. Download Simple Voice Chat for the same Minecraft version and loader.
2. Fabric: keep Fabric API updated. Put the .jar in mods/.
3. Start once to generate config/voicechat/.
4. Edit voicechat-server.properties and adjust port= if needed.
5. Restart and confirm in the logs that voice chat started without a bind error.

Paper / Purpur server (plugin)

1. Stop the server. Download the Bukkit/Paper artifact from Modrinth.
2. Put it in plugins/. Start to generate plugins/voicechat/.
3. Adjust port= if hosting assigned another UDP port.
4. Restart and test with a client that has the mod installed.

On each player's client

1. Install the loader and Simple Voice Chat at the same version as the server.
2. Join the server and open the voice chat menu (V by default).
3. Allow the microphone in the operating system.

voicechat-server.properties

port=24454
bind_address=
voice_host=

Test the connection

In-game: /voicechat test <player>. Two players close in the world, microphone allowed. If it fails, go back to the UDP port before touching quality. In 90% of cases the problem is the network.

Common issues

1. Red icon / does not connect: confirm UDP is open and port= matches the panel. Restart after editing the config.
2. Incompatible version: client and server need the same Minecraft and mod major version.
3. Fabric API error: update Fabric Loader and Fabric API.
4. Docker: publish /udp. Conflict with Geyser or another service on the same UDP port.
5. Wrong bind_address or voice_host: leave them empty on most hosting setups.

Heavy modpacks need at least 8 GB of RAM. After TPS is stable, open UDP for voice chat. Building the server from scratch? See the RoxyCloud Minecraft Java server guide.