
ViaVersion — plugin para suporte a clientes de diferentes versões em um servidor de Minecraft
O ViaVersion permite que jogadores com uma versão de cliente mais recente se conectem a um servidor que roda em uma versão mais antiga. Se…
O ViaVersion permite que jogadores com uma versão de cliente mais recente se conectem a um servidor que roda em uma versão mais antiga. Se o servidor estiver rodando em 26.1.2 e um jogador abrir uma versão anterior do jogo, ele entrará sem nenhuma ação de sua parte. O plugin é…
ViaVersion — plugin para suporte a clientes de diferentes versões em um servidor de Minecraft
Versão do Minecraft: 26.1.2
Loader: Paper
Versão do plugin: 5.9.0
Java: 25
O ViaVersion permite que jogadores com uma versão de cliente mais recente se conectem a um servidor que roda em uma versão mais antiga. Se o servidor estiver rodando em 26.1.2 e um jogador abrir uma versão anterior do jogo, ele entrará sem nenhuma ação de sua parte. O plugin é gratuito e tem código aberto.
Princípio de funcionamento
O plugin intercepta os pacotes de rede entre o cliente e o servidor e os converte entre protocolos em tempo real.
O suporte mais completo é no Paper. No BungeeCord e no Velocity, o ViaVersion é instalado no próprio proxy, e não nos servidores backend.
Comandos
Todos os comandos são digitados no chat ou no console do servidor. Para executar no jogo, são necessárias permissões de operador.
Tabela de comandos
Comando | O que faz |
| Lista de jogadores online com suas versões de cliente |
| Ativa/desativa comandos automáticos para evitar colisões entre jogadores |
| Exibe os pacotes do jogador no console — apenas a pedido do suporte |
| Ativa o ResourceLeakDetector no Netty — apenas a pedido do suporte |
| Ativa/desativa as notificações sobre novas atualizações ao entrar |
| Gera um link com informações de diagnóstico para entrar em contato com o suporte |
| Informações detalhadas sobre a conexão de um jogador específico ou de todos |
| Lista de todos os jogadores com sua quantidade de pacotes por segundo |
| Recarrega a configuração; expulsa todos os jogadores conectados |

alt: saída do comando /viaver list
Configuração
Arquivo: plugins/ViaVersion/config.yml. Gerado automaticamente na primeira execução.
block-versions — bloqueia a conexão de determinadas versões. Suporta os operadores < e >, por exemplo: block-versions: ["<1.17"].
block-disconnect-msg — mensagem ao ser desconectado por causa de uma versão bloqueada. Suporta Minecraft color codes.
logging.log-blocked-joins — registra no console as tentativas de conexão de versões bloqueadas. Por padrão, false.
send-supported-versions — quando true, o servidor informa ao cliente a lista de versões suportadas na resposta de ping.
Limite de pacotes
Por padrão, o jogador é expulso ao exceder 800 pacotes/s. Além disso, o comportamento é monitorado em uma janela de tempo — por exemplo, com sustained-max-per-second: 200, sustained-period-seconds: 7 e sustained-threshold: 4, o jogador será expulso se exceder 200 pacotes/s durante 4 de 7 segundos. Para desativar o limite — enabled: false.
Parâmetros adicionais
hologram-patch — corrige a altura dos hologramas para clientes 1.9+ em servidores mais antigos. Por padrão, false. Se os hologramas de plugins como o HolographicDisplays forem exibidos na altura errada — ative este parâmetro.
serverside-blockconnections — ativa o processamento no lado do servidor das conexões de blocos para clientes 1.13+. Por padrão, true. Afeta a exibição correta de cercas, painéis de vidro, portas. O parâmetro blockconnection-method determina o modo de processamento: packet — no nível de pacotes, world — no nível do mundo (experimental).
use-1_15-instant-respawn — quando true, os clientes 1.15+ renascem instantaneamente sem a tela de morte. Por padrão, false.
armor-toggle-fix — corrige o bug de troca de armadura em um slot ocupado para clientes 1.19.4+. Por padrão, true.
enforce-secure-chat — define o valor de secure chat enviado aos clientes 1.19+ ao entrar. Não é recomendável alterá-lo se o servidor estiver rodando em 1.19 ou mais recente.
Conclusão
O ViaVersion resolve uma tarefa simples, mas importante: a incompatibilidade entre a versão do cliente e a do servidor. Se o administrador não puder atualizar o servidor por causa de dependências de plugins antigos, enquanto os jogadores já estão em versões mais recentes — o plugin resolve o problema sem alterações no lado do cliente. Para o uso básico, não é necessária nenhuma configuração.
Instalação
Uma instalação típica leva cerca de 5 minutos. O fluxo é o mesmo; só mudam o loader e o build correspondente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.








