Simple Voice Chat Server Setup

How Simple Voice Chat works

• Server and players both need it. The server runs the mod or plugin, and every player who wants voice installs the mod on their client. Players without it can still join and play, just without voice.
• It runs on many platforms. The mod works on Fabric, NeoForge, Forge and Quilt, the plugin on Paper, Spigot, Purpur and Folia, and they talk to each other. Even on a Paper server, players still need the client mod.
• Voice uses a separate UDP port, 24454 by default. Only the server needs that port open; players do not open anything.
• Java Edition only. Bedrock players, including those joining through Geyser, cannot use it. Custom clients such as Lunar and Feather are not supported either.

Install the mod or plugin

1. Download Simple Voice Chat from Modrinth or CurseForge: the plugin file for Paper or Spigot, or the mod file for your loader and Minecraft version.
2. Put it in plugins (Paper, Spigot) or mods (Fabric, NeoForge, Forge) and restart the server once. See how to install Minecraft plugins.
3. The first start creates the config file:
   • plugins/voicechat/voicechat-server.properties on Paper and Spigot;
   • config/voicechat/voicechat-server.properties on modded servers.
4. Tell your players to install the mod for their loader and Minecraft version.

Set up the voice port

The voice port must be open for UDP and must not be the game port.

• On your own machine: forward UDP 24454 on your router and allow it in the firewall. In Docker, map it as 24454:24454/udp; without /udp only TCP is forwarded and voice fails.
• On a hosted server: you need a second port assigned to your server, and you put that number in the config.

On HytHost Minecraft hosting you do it yourself:

1. Open the Network tab in the panel and add an allocation. The panel picks a free port on your server's IP and opens it for both TCP and UDP.
2. Open voicechat-server.properties and set port to that number, for example:

   port=25571

3. Restart the server.

Leave voice_host empty: the new port is on the same IP as the game, so players' mods find it on their own. If the Network tab will not let you add a port, open a ticket and we add one for you.

The settings that matter

Restart the server after editing the file.

For players: first use

• Press V to open the voice chat menu. The first time, the mod asks for the microphone, the speakers and whether to use push to talk or voice activation.
• Groups are joined from the menu, or with /voicechat join <group>; /voicechat leave leaves the group.

When players cannot connect to voice

• Test it: as an operator, run /voicechat test <player> to check whether that player's voice connection works.
• Wrong port in the config: the number in voicechat-server.properties must match the extra port assigned to your server exactly.
• TCP instead of UDP: voice needs UDP. Online port checkers test TCP only, so they show nothing useful; use the test command instead.
• Port clash with Geyser: if the server also runs Geyser for Bedrock players, give voice a different port from Geyser's.
• Version mismatch: the mod on players' clients must match the server's major version, for example 2.6.x on both.
• Players hear each other from far away: they are probably in the same group.