Minecraft server help centre

Plugins and mods

How to set up Simple Voice Chat on your Minecraft server

Simple Voice Chat puts proximity voice in Minecraft: you hear players who stand near you, louder when they are close and silent when they walk away. It also has groups, so friends can keep talking from opposite sides of the map.

The mod has two halves. One runs on the server and carries the sound, the other runs in the game of every player who wants to talk. The server half needs a port of its own, and that port is where almost every setup goes wrong. This guide takes you through all of it, in the order you do it.

In short

To set up Simple Voice Chat on a Minecraft server, install it on the server (as a plugin on Paper or Purpur, as a mod on Fabric, Forge or NeoForge), open a UDP port for it and restart. On our servers you add the port in the Ports tab of the control panel, choose Simple Voice Chat and click Set it for me, which writes the port and the voice host into voicechat-server.properties. Every player who wants to talk installs the same mod in their own game. If the icon with the crossed plug stays on screen, the UDP port is not open or not set in the config.

What Simple Voice Chat needs on a Minecraft server

PartWhat it isWho arranges it
The server sideA plugin on Paper and Purpur, or a mod on Fabric, Forge and NeoForgeYou, once, on the server
A UDP portA second port next to the one players join on, only for soundYou, once, in the Ports tab
The client sideThe same mod in the player's own MinecraftEvery player who wants to talk

Voice travels over UDP, a different kind of traffic than the game itself. The port players join on does not carry it, which is why the server needs one more port and why voice can fail while the game works fine.

Players without the mod can still join and play. They just hear nothing and do not show a speaker icon. Players on Bedrock, which means phones, tablets and consoles, cannot use it at all, because Bedrock does not load Java mods. On a crossplay server only the Java players can talk.

Install Simple Voice Chat on a Paper or Purpur server

  1. Open the control panel of your server and click Plugins.
  2. Type Simple Voice Chat in the search box.
  3. Check that the version matches the Minecraft version of your server, then click install.
  4. Restart the server once. The plugin makes its settings file at the first start.
Plugin catalog in the Plugins tab with the Search plugins box, category filters and plugin cards with a version picker and an install button
Search for Simple Voice Chat in the plugin catalog and pick the version for your Minecraft version.

You can also download the plugin file yourself and upload it to the plugins folder in the Files tab. Install plugins covers both ways.

After the restart, the folder plugins/voicechat holds a file named voicechat-server.properties. That file has to exist before the next step can write the port into it.

The plugins folder in the Files tab of the control panel with the plugin jar files and their settings folders
After one start the plugins folder has a voicechat folder with the settings file in it.

Install Simple Voice Chat on a Fabric, Forge or NeoForge server

  1. Open the Mods tab of your server and search for Simple Voice Chat.
  2. Install the build for your mod loader and your Minecraft version.
  3. On Fabric, also install Fabric API if the server does not have it yet.
  4. Restart the server once, so the settings file is made.

On a modded server the file is at config/voicechat/voicechat-server.properties. Many modpacks already contain Simple Voice Chat. In that case you skip the install and only open the port. Install mods on a Minecraft server explains the Mods tab and uploads by hand.

A Paper server with the plugin works with players who run the Fabric, Forge or NeoForge version of the mod. The two sides do not have to use the same loader, only versions that match.

Open the voice chat port in the control panel

This is the step that makes voice chat connect. On a server in Poland you do it yourself in the Ports tab, and it is free.

  1. Click Ports in the menu on the left, then Add a port.
  2. Under What is it for?, choose Simple Voice Chat. The protocol is set to UDP for you.
  3. Leave the port number on Auto and click Open port.
  4. In the Next step box, click Set it for me. The panel writes the port and the voice host into voicechat-server.properties and keeps a copy of the old file.
  5. Restart the server.
  6. Click Test on the port.

The test often answers no reply, which is normal for most UDP programs. That is fine: voice chat does not reply to a test packet, and nothing refused it. The real test is joining with the mod installed.

Restart and Stop buttons at the top of the Overview page of a running server, with the menu button next to Stop
Restart the server after the port is set, or the plugin keeps listening on the old number.

On a server in Germany or Canada there is no Ports tab yet. Send a message to support with the name of your server and the words Simple Voice Chat, and we open the port and set the file for you, at no cost.

Only the owner of the server sees the Ports tab. Open a port on your Minecraft server describes every button on that page, including who may connect and the flood limits.

Why the default port 24454 does not work by itself

Out of the box, Simple Voice Chat listens on UDP port 24454. On a home computer you would forward that port on your router. On a hosted server the number has to be one that is open for your server, and no two servers can share it.

That is what the Ports tab arranges. It gives your server a port number of its own and tells you which number the plugin has to listen on. Two lines in the settings file carry it:

Line in voicechat-server.propertiesWhat it doesWhat to put there
portThe port the plugin listens on inside the serverThe server port the Ports tab shows
voice_hostThe address the mod of each player connects to for soundYour play address with the public port number

Set it for me fills in both. If you edit the file by hand, copy the two values from the port in the Ports tab exactly, save, and restart. A voice_host that is empty or wrong is the reason voice works for nobody even though the port is open.

What your players install to use voice chat

Every player who wants to talk or listen needs the mod in their own game. Send them this list.

  1. Install Fabric, Forge or NeoForge for the Minecraft version of the server. Fabric is the lightest when you only want voice chat.
  2. Download Simple Voice Chat for that loader and version, and put the file in the mods folder of your Minecraft installation.
  3. On Fabric, put Fabric API in the same folder.
  4. Start the game with that profile and join the server.
  5. The first time, a chat message asks you to set up voice chat. Press V and follow the guide: choose your microphone, your speakers, and push to talk or voice activation.

The keys players use

KeyWhat it does
VOpens the voice chat menu: volume per player, groups, microphone test and settings
MMutes or unmutes your microphone, when you use voice activation
NTurns voice chat off or on for yourself. Nobody hears you and you hear nobody
HHides or shows the voice chat icons on screen
The key you picked in the setup guidePush to talk. The mod has no push to talk key until you choose one

These are the keys the mod starts with. Players can change them under Options, Controls, Key Binds, where whisper and the group menu can get a key of their own too. A player who hears nothing should open the menu with V first and run the microphone test there.

Players who join a modded server already have the mod when it is part of the modpack. Join a modded Minecraft server shows how to get the same mod list as the server.

Simple Voice Chat server settings worth changing

The plugin works with its own defaults. These lines in voicechat-server.properties are the ones server owners change most. Edit the file in the Files tab, save and restart.

SettingStarts asWhat it changes
max_voice_distance48How many blocks away a player can still be heard
whisper_distance24How many blocks a whisper carries
enable_groupstrueWhether players can make groups that hear each other anywhere
force_voice_chatfalseSet to true to kick players who do not have the mod
allow_recordingtrueWhether players can record the voice chat from their own game
spectator_interactionfalseWhether spectators can talk to other players
spectator_player_possessionfalseWhether a spectator can talk to the player they are watching

A distance of 48 blocks suits a survival world. For a roleplay or horror server, 16 to 24 blocks makes players come closer to talk. For an event with one speaker, raise it or use a group.

Leave port and voice_host alone once voice chat works. They belong to the port from the Ports tab.

Edit Minecraft server files shows the editor in the Files tab, and how to put a file back when a change goes wrong.

Groups, commands and permissions

A group is a private call inside the server. Members hear each other at any distance, and players outside it do not hear them. Players open the voice chat menu with V, go to groups, give the group a name and, if they want, a password.

CommandWhat it does
/voicechat helpLists the commands of the mod
/voicechat test <player>Checks whether that player is connected to voice chat. For operators only
/voicechat invite <player>Invites a player to your group
/voicechat join <group>Joins a group by name
/voicechat leaveLeaves your group

The commands are typed in the game chat, by a player who has the mod installed. They do not work from the console of the server.

On Paper and Purpur you can decide who may talk with a permissions plugin. The permission names are voicechat.speak, voicechat.listen, voicechat.groups and voicechat.admin. Everyone has the first three from the start, and only operators have the last. Taking voicechat.speak from a rank mutes those players for everyone, which is a clean way to handle someone who misuses the microphone. Permissions with LuckPerms explains ranks and permissions.

Simple Voice Chat not working: the crossed plug and other fixes

When voice chat cannot reach the server, the mod shows a small plug icon with a cross in the corner of the screen. Find your case in the table.

What you seeCauseFix
Crossed plug for every playerThe UDP port is not open, or the settings file has the wrong port or voice hostAdd the port in the Ports tab, click Set it for me, restart
Crossed plug right after adding the portThe server has not restarted sinceRestart the server, then let players join again
Crossed plug for one player onlyThat player's network blocks UDP, common on school, work and some mobile connections, or a VPN is in the wayTry another network or turn the VPN off
A message that the voice chat version is not compatibleThe mod of the player and the one on the server are too far apartUpdate both to the newest release for your Minecraft version
Connected, but nobody hears youWrong microphone, muted, or push to talk without holding the keyPress V, pick the microphone, run the microphone test, and check that you are not muted. After the setup guide the microphone starts muted when you chose voice activation
You hear players only when they are closeThat is proximity chat working as designedMake a group from the menu behind V, or raise max_voice_distance
Voice stopped after you changed the server addressThe voice host still points at the old addressOpen the port in the Ports tab and click Set it for me again, then restart
Bedrock or console players hear nothingBedrock cannot load the modOnly Java players can use voice chat
Console tab of the control panel with the Type a command field and the Send button marked
The Console tab shows what the plugin writes while the server starts, including the port it listens on.

Still stuck? Open the Console tab and look at the lines the plugin writes at startup. It says which port it started on. That number has to be the server port the Ports tab shows. Read Minecraft server logs helps you find those lines.

The list of installed plugins in the Plugins tab with their version and the buttons to update or remove each one
The installed list shows which version of the plugin the server runs, to compare with the version your players have.

Does voice chat slow the server down?

Hardly. The server does not mix or process the sound; it passes small packets from the player who talks to the players near enough to hear. On a server for friends you will not see it in the memory graph or the tick time.

What does matter on a busy server is the distance. With a large max_voice_distance and many players in one place, every voice goes to everyone. Keep the distance modest on a public server, and let big gatherings use groups.

You do not need a bigger plan for voice chat. If the server lags, the cause is somewhere else; reduce lag on your Minecraft server lists where to look.

Questions from Minecraft server owners

What port does Simple Voice Chat use?

UDP port 24454 by default, set on the port line of voicechat-server.properties. On a hosted server you use the port your host opens for you instead. On our servers the Ports tab gives you the number and writes it into voicechat-server.properties with Set it for me.

Do all players need the Simple Voice Chat mod?

Only the players who want to talk or listen. Players without the mod can still join and play, unless you set force_voice_chat to true.

Does Simple Voice Chat work on a Paper server?

Yes. There is a plugin version for Paper and Purpur. Players join with the Fabric, Forge or NeoForge version of the mod in their own game.

Why does Simple Voice Chat say it is not connected?

The mod cannot reach the voice port of the server. Open a UDP port for Simple Voice Chat, set the port and the voice host in voicechat-server.properties, and restart the server.

Can Bedrock and console players use Simple Voice Chat?

No. Simple Voice Chat is a Java mod, and Bedrock on phones, tablets and consoles cannot load it. On a crossplay server only the Java players can talk.

Where is the Simple Voice Chat config file on the server?

On Paper and Purpur it is plugins/voicechat/voicechat-server.properties. On Fabric, Forge and NeoForge it is config/voicechat/voicechat-server.properties. The file appears after the first start with the mod installed.

How do I change how far voices carry?

Change max_voice_distance in voicechat-server.properties. It starts at 48 blocks. Save the file and restart the server.

Does opening the voice chat port cost extra?

No. Opening a port for voice chat is free on our servers, in every location.

Checked against the Plugins, Mods, Files and Ports tabs of our control panel and the server settings file of Simple Voice Chat on a Paper server, November 2026. Written by the Cheapest Minecraft Hosting team, first published , updated .