Configurar Simple Voice Chat (chat de voz por proximidad)

¿Qué es Simple Voice Chat?

Simple Voice Chat es un mod/plugin que agrega chat de voz por proximidad a Minecraft. Los jugadores se escuchan según la distancia: más cerca = más fuerte, más lejos = más bajo. También soporta grupos de voz, susurros y grabación de audio.

Es compatible con Fabric, NeoForge, Forge, Quilt (como mod) y Bukkit/Spigot/Paper (como plugin). Los jugadores necesitan el mod instalado en su cliente para usarlo.

Requisitos

• Servidor con Paper/Spigot/Purpur (plugin) o Fabric/Forge/NeoForge (mod)
• Un puerto UDP adicional abierto (por defecto 24454)
• Los jugadores deben tener el mod instalado en su cliente (Fabric, NeoForge, Forge o Quilt)

Paso 1: Instalar en el servidor

Como plugin (Paper/Spigot/Purpur)

1. Descargá Simple Voice Chat desde modrinth.com/plugin/simple-voice-chat
2. Subí el .jar a plugins/ en panel.baires.host
3. Reiniciá el servidor

El archivo de configuración se genera en: plugins/voicechat/voicechat-server.properties

Como mod (Fabric/NeoForge/Forge)

1. Descargá la versión correspondiente a tu loader desde modrinth.com/mod/simple-voice-chat
2. Subí el .jar a mods/ en panel.baires.host
3. Reiniciá el servidor

El archivo de configuración se genera en: config/voicechat/voicechat-server.properties

Paso 2: Configurar el puerto UDP

Este es el paso más importante. Simple Voice Chat usa un puerto UDP separado del puerto TCP de Minecraft para transmitir audio.

Asignar un puerto adicional en Pterodactyl

1. Ingresá a panel.baires.host → tu servidor
2. Andá a Network (Red) o Allocations
3. Hacé clic en Crear allocation o Agregar puerto
4. Anotá el nuevo puerto asignado (ej: 24454 o el que te asigne el panel)

Si no podés agregar puertos desde el panel, contactá a soporte para que te asignen un puerto UDP adicional.

Configurar el puerto en Simple Voice Chat

Editá el archivo voicechat-server.properties:

port=24454

Cambiá 24454 por el puerto que te asignaron en el panel.

¿Puedo usar el mismo puerto que Minecraft?

Técnicamente sí, configurando port=-1. Sin embargo, la documentación oficial recomienda fuertemente NO hacerlo porque:

• El puerto UDP del servidor Minecraft se usa por defecto para el server query
• Usar el mismo puerto puede causar crashes del servidor
• Genera conflictos de protocolo entre el query y el voice chat

# NO RECOMENDADO - puede crashear el servidor
port=-1

Solución correcta: Siempre usá un puerto dedicado diferente al de Minecraft. Si tu servidor Minecraft corre en el puerto 25565, usá otro como 24454 o el que te asigne el panel.

Si no tenés otro puerto disponible

Si tu plan solo incluye un puerto y necesitás usar el mismo, seguí estos pasos:

Primero, desactivá el server query en server.properties:

enable-query=false

Después, configurá Simple Voice Chat para usar el mismo puerto editando voicechat-server.properties:

port=-1

Por último, reiniciá el servidor para aplicar ambos cambios.

Nota: Aunque esto puede funcionar, es una solución de último recurso. Lo ideal es solicitar un puerto adicional a soporte.

Paso 3: Configurar voice_host (importante para hosting)

Si los jugadores no pueden conectarse al voice chat, probablemente necesites configurar voice_host:

voice_host=tu-ip-del-servidor:24454

Esto le dice a los clientes a qué dirección conectarse para el audio. Usá la misma IP que los jugadores usan para conectarse al servidor de Minecraft, seguida del puerto de voice chat.

Ejemplo:

voice_host=game1.baires.host:24454

Paso 4: Configuración completa del servidor

Archivo voicechat-server.properties con todas las opciones:

# Puerto UDP para voice chat (NO usar -1 si es posible)
port=24454

# IP a la que se bindea el voice chat (dejar vacío para usar server-ip)
bind_address=

# Distancia máxima de voz (en bloques)
max_voice_distance=48

# Distancia de susurro (en bloques)
whisper_distance=24

# Codec de audio (VOIP, AUDIO, RESTRICTED_LOWDELAY)
codec=VOIP

# Tamaño máximo de paquetes de audio (bytes)
mtu_size=1024

# Límite de paquetes por segundo por jugador
tcp_rate_limit=16

# Frecuencia de keep-alive (ms)
keep_alive=1000

# Permitir grupos de voz
enable_groups=true

# Host que los clientes usan para conectarse
voice_host=

# Permitir grabación de audio
allow_recording=true

# Espectadores pueden hablar con jugadores
spectator_interaction=false

# Kickear jugadores sin el mod
force_voice_chat=false

# Timeout para verificar si tiene el mod (ms)
login_timeout=10000

# Rango de broadcast (-1 = max_voice_distance)
broadcast_range=-1.0

# Responder a pings externos
allow_pings=true

Paso 5: Instalación en el cliente (jugadores)

Los jugadores necesitan instalar el mod en su cliente:

1. Instalar Fabric Loader, NeoForge, Forge o Quilt
2. Descargar Simple Voice Chat para su loader desde modrinth.com
3. Colocar el .jar en la carpeta mods/ de su Minecraft
4. Al entrar al servidor, presionar V para abrir la configuración de voz
5. Seguir el asistente de configuración (seleccionar micrófono, parlante, modo de activación)

Importante: El mod del cliente debe ser compatible con la versión del servidor. No importa qué loader use el servidor — todos son cross-compatible.

Teclas por defecto (cliente)

Los jugadores pueden cambiar estas teclas en Opciones → Controles.

Permisos (para servidores con LuckPerms)

Simple Voice Chat tiene permisos compatibles con Bukkit y Fabric Permissions API:

Para restringir el voice chat a un rango específico:

lp group default permission set voicechat.speak false
lp group vip permission set voicechat.speak true

Comandos

Todos los comandos se ejecutan dentro del juego (no desde la consola del panel):

El comando /voicechat test requiere el permiso voicechat.admin.

Solución de problemas

El ícono muestra "Voice chat not connected" (enchufe desconectado)

Causa más común: El puerto UDP no está abierto correctamente.

1. Verificá que el puerto esté asignado en el panel (Network/Allocations)
2. Verificá que port en voicechat-server.properties coincida con el puerto asignado
3. Si usás voice_host, verificá que la IP y puerto sean correctos
4. Reiniciá el servidor después de cualquier cambio

Los jugadores se conectan pero no se escuchan

1. Verificá que ambos jugadores tengan el mod instalado en el cliente
2. Revisá que no estén muteados (tecla M)
3. Verificá que estén dentro del rango de max_voice_distance (48 bloques por defecto)
4. Si están en un grupo, la proximidad no aplica — se escuchan sin importar distancia

El servidor crashea al iniciar

• "Address already in use": Otro programa usa el puerto. Verificá que no haya otra instancia del voice chat o que GeyserMC no use el mismo puerto
• "Failed to bind to address": Dejá bind_address vacío si no sabés qué poner
• Verificá que el server query (query.port en server.properties) no use el mismo puerto que el voice chat

Desconexiones constantes

• Puede ser conexión inestable del jugador
• Si usan datos móviles o VPN, el ISP puede estar bloqueando UDP
• Aumentá keep_alive a 2000 o 3000 si hay timeouts frecuentes

Protección DDoS bloquea el voice chat

Algunos servicios de protección DDoS bloquean tráfico UDP no reconocido. Si tenés este problema, contactá a soporte para crear una excepción para el puerto del voice chat.

Configuración con proxy (Velocity/BungeeCord)

Si usás un proxy:

• Instalá el plugin de Simple Voice Chat en el proxy (carpeta plugins/ del proxy)
• Instalá el mod/plugin en cada servidor backend
• Solo necesitás abrir un puerto UDP en el proxy
• Configurá voicechat-proxy.properties en el proxy (ver ejemplo abajo)
• Los servidores backend no necesitan puertos UDP abiertos externamente — el proxy maneja la conexión

Ejemplo de voicechat-proxy.properties:

# Puerto UDP del voice chat en el proxy (-1 = mismo que el proxy)
port=-1
bind_address=
voice_host=
allow_pings=true

Versiones soportadas

Simple Voice Chat se mantiene activamente para múltiples versiones de Minecraft. Como plugin (Bukkit/Paper), un solo .jar soporta desde 1.8.8 hasta la última versión. Como mod, las versiones con soporte activo incluyen 1.12.2, 1.16.5, 1.18.2, 1.19.2, 1.20.1, 1.21.1, 1.21.4, 1.21.5 y posteriores.

Consultá siempre modrinth.com/mod/simple-voice-chat para la última versión compatible con tu servidor.

Resumen rápido de configuración en Baires Host

1. Instalá el plugin/mod en el servidor
2. Pedí un puerto UDP adicional (o asignalo desde Network en el panel)
3. Configurá port=PUERTO_ASIGNADO en voicechat-server.properties
4. Configurá voice_host=TU_IP:PUERTO_ASIGNADO si los clientes no conectan
5. Reiniciá el servidor
6. Los jugadores instalan el mod en su cliente y presionan V al entrar

Recomendaciones

• Usá siempre un puerto dedicado diferente al de Minecraft para evitar conflictos
• Si tenés problemas de conexión, lo primero es verificar que el puerto UDP esté abierto
• No cambies voice_host a menos que los jugadores no puedan conectarse al audio
• Para servidores de roleplay, configurá max_voice_distance=24 para conversaciones más íntimas
• Para servidores grandes, dejá force_voice_chat=false para no excluir jugadores sin el mod
• Usá /voicechat test NombreJugador para diagnosticar problemas de conexión individuales