Chat de voz por proximidade no Minecraft: como configurar num servidor

Resposta rápida

Instale o plugin ou mod de servidor do Simple Voice Chat correspondente e o mod no cliente. Configure uma porta UDP atribuída ao seu servidor, reinicie e teste com um jogador conectado. Conseguir entrar no Minecraft não prova que a conexão de voz, que é separada, funciona.

Por que o chat de voz precisa de um teste separado

O jogo no Minecraft Java usa TCP; o Simple Voice Chat envia o áudio por UDP. Por isso, um servidor pode estar online e jogável enquanto o chat de voz não está disponível. Diagnostique a conexão de voz separadamente dos problemas comuns para entrar.

Uma mensagem de início não é um teste de conexão

A porta padrão da voz é 24454. Ela precisa estar disponível para o seu servidor e acessível por UDP. Numa hospedagem compartilhada, a porta atribuída pode ser outra. Uma mensagem dizendo que o servidor de voz iniciou só confirma o início local, não que a rede de um jogador consegue alcançá-lo.

Configurar a porta UDP atribuída

1. Pare o servidor antes de editar a configuração. Guarde uma cópia do arquivo atual.
2. No Paper ou no Purpur, abra plugins/voicechat/voicechat-server.properties. No Fabric, Forge ou NeoForge, use config/voicechat/voicechat-server.properties.
3. Defina port como a porta UDP que a hospedagem atribuiu ao chat de voz. Não copie a alocação de outro servidor.
4. Reinicie e faça o teste com jogador abaixo.

port=-1 é a solução certa? Essa opção usa o número da porta do Minecraft para o chat de voz, mas não abre o UDP sozinha. A documentação oficial desaconselha esse reaproveitamento genérico, porque outro serviço UDP pode entrar em conflito. Use só se a hospedagem confirmar que essa alocação está publicada em UDP e não é usada pelo Query, pelo Geyser ou por outro serviço.

Veja a referência oficial de configuração do servidor (em inglês). Redes com proxy têm requisitos extras; não aplique às cegas uma receita feita para servidor direto.

Porta, endereço de bind e host de voz são configurações diferentes

• port é a porta UDP em que o serviço de voz escuta.
• bind_address escolhe a interface de rede local. Não é onde se coloca um hostname público.
• voice_host pode indicar o endereço que os jogadores usam para chegar ao chat de voz. Atrás de um proxy, ele pode ser diferente do endereço para entrar no Minecraft.

Mantenha os valores atribuídos pela hospedagem. Se o endereço anunciado estiver errado, peça ao suporte que verifique a rota UDP pública; não exponha um IP de origem nem mude regras de firewall só para copiar um tutorial.

Teste com um jogador real

Entre com o mod do cliente instalado. Com a permissão necessária, digite no jogo /voicechat test <NOMEDOJOGADOR>, trocando o marcador pelo nome do jogador conectado. Depois teste o áudio de verdade com outro jogador perto, conferindo as permissões do microfone e o mudo.

Mensagens de log sobre secret solicitado ou enviado, sozinhas, não demonstram que o áudio funciona de ponta a ponta. Verificadores de porta genéricos na web podem testar TCP em vez do protocolo de voz. Use os testes do guia oficial de configuração e teste de conexão (em inglês).

Cada jogador que participa precisa do mod no cliente

Servidor: escolha a versão para a sua versão do Minecraft e o software do servidor. Paper e Purpur usam o plugin; servidores com mods precisam da versão do loader correspondente.

Jogadores: instale uma versão compatível do Simple Voice Chat no cliente para a sua versão do Minecraft e o seu loader. Um plugin no servidor não instala nada nos computadores dos jogadores.

O Simple Voice Chat é para o Java Edition, não para o Bedrock. Jogadores sem o mod no cliente normalmente conseguem entrar no servidor, mas não usam o chat de voz; ativar force_voice_chat muda esse comportamento. Usar a mesma versão do chat de voz no servidor e nos clientes é o ponto de partida mais simples para resolver problemas. Veja o FAQ de compatibilidade do projeto (em inglês).

Se o chat de voz continuar falhando

• O plugin não carrega: siga a lista de erros de plugin no início (em inglês) antes de investigar a rede.
• Ninguém se conecta à voz: confira com a hospedagem a porta UDP atribuída, os erros de início e outros serviços UDP em conflito.
• Só um jogador é afetado: compare versões do cliente, permissões do microfone, mudo e restrições de rede.
• O problema começou depois de uma atualização: compare a configuração com a cópia que você guardou e leia as notas de compatibilidade da versão.

O guia oficial de solução de problemas (em inglês) explica com mais detalhes os erros de conexão e os conflitos de UDP.

Usar o Simple Voice Chat no ChunkArc

Use o projeto compatível no catálogo de plugins ou mods do painel. Mantenha as configurações atribuídas ao servidor; não troque uma alocação que funciona pela porta padrão de um tutorial. Se o teste com jogador falhar, abra um ticket privado no suporte com o endereço do servidor, a versão do Minecraft, o software do servidor, as versões do chat de voz no servidor e no cliente e o resultado do teste. Diga se todos ou só um jogador são afetados. Compartilhe só linhas de log relevantes e censuradas; nunca inclua senhas, tokens ou códigos de recuperação.

Leia também: Simple Voice Chat no Modrinth, como instalar mods num servidor de Minecraft e instalar plugins (em inglês).