O ViaVersion liga clientes Minecraft Java mais recentes a um servidor Java mais antigo. O ViaBackwards acrescenta o sentido inverso para clientes mais antigos. Ambos traduzem o protocolo de rede; não atualizam a versão do servidor nem adicionam conteúdos de uma versão de jogo mais recente. Este guia mostra-te como verificar a instalação num servidor Paper, testar corretamente uma mudança de versão e isolar erros de ligação típicos. As nossas próprias gravações e logs do servidor de 12 de setembro de 2026 comprovam a entrada de um cliente com 1.21.4 num servidor de teste Paper 1.21.1 com ViaVersion 5.11.0.

O que está instalado no teu servidor?

Em servidores Paper e outros servidores Bukkit adequados para isso, a game-serverhosting instala o ViaVersion e o ViaBackwards como plugins de sistema durante a configuração. No painel, encontra-los em Plugins → Instalado com a indicação "Sistema". Não adiciones mais um segundo JAR do ViaVersion a partir do navegador de plugins: dois ficheiros com o mesmo nome de plugin podem impedir o Paper de carregar o plugin. Num servidor existente ou alterado por ti, verifica primeiro os ficheiros realmente instalados e o protocolo de arranque. Servidores Fabric precisam do caminho correto de mod ou ViaFabric e não devem ser tratados como equivalentes às instruções para Paper.

No protocolo de arranque, o ViaVersion tem de ser ativado sem erros. No nosso servidor de teste aparecia Enabling ViaVersion v5.11.0 e depois ViaVersion detected server version: 1.21-1.21.1. O número exato da versão depende do teu servidor e do estado do plugin instalado. Na consola, ou como admin com permissões, também podes executar /viaversion. /version ViaVersion mostra no Paper a versão do plugin carregada.

O ViaVersion responde no chat com a versão carregada no servidor de teste Paper
O ViaVersion responde no chat com a versão carregada no servidor de teste Paper

De que direção precisas?

Cliente mais recente → servidor mais antigo: Para isso serve o ViaVersion. O nosso caso de teste foi Paper 1.21.1 e um cliente Java com 1.21.4. Uma entrada bem-sucedida comprova exatamente esse par de versões nesse servidor de teste, não automaticamente todas as futuras versões do Minecraft.

Cliente mais antigo → servidor mais recente: Para isso precisas adicionalmente do ViaBackwards. Ele requer o ViaVersion. Versões de cliente muito antigas podem precisar de outros componentes, como o ViaRewind. Verifica a tabela de compatibilidade atual do projeto antes de prometeres uma versão específica aos jogadores.

Jogadores Bedrock entram através do Geyser e do Floodgate; o ViaVersion sozinho não transforma um servidor Java num servidor Bedrock. Num proxy Velocity ou Bungee, tem de ficar claro se a tradução do protocolo acontece no proxy ou nos backends. A documentação do ViaVersion recomenda não o instalar sem motivo nos dois níveis para a mesma ligação.

Testar a ligação passo a passo

  1. Lê a versão real do Minecraft do servidor no protocolo de arranque e confirma se o ViaVersion foi carregado. Verifica no painel, em Plugins → Instalado, se o ViaVersion e, se necessário, o ViaBackwards existem apenas uma vez.
  2. Primeiro, inicia um cliente Java sem alterações com a mesma versão do servidor. Se esta ligação já falhar, verifica a ligação base e o protocolo de arranque antes de suspeitares de um conflito de versões.
  3. Depois, inicia exatamente um cliente com a versão mais recente pretendida e entra no mesmo servidor. Anota a versão do cliente, a versão do servidor, a versão do ViaVersion e a mensagem de erro concreta.
  4. Testa um cliente mais antigo apenas se o ViaBackwards estiver ativo e se a versão for suportada segundo a documentação atual do projeto. Verifica o spawn, o inventário, o chat e os plugins importantes para o teu servidor dentro do jogo.
  5. Usa /viaversion list para ver as versões dos jogadores ligados ou /viaversion player Spielername para uma ligação individual. Estes comandos de admin precisam de viaversion.admin ou das permissões viaversion.command.* adequadas; não as dês ao grupo padrão.

Antes de uma atualização de plugin, cria um backup. Não substituas o JAR de sistema por um JAR versionado do navegador e reinicia completamente o servidor após uma alteração. Segundo a documentação do ViaVersion, um reload por gestor de plugins não é uma substituição fiável para um reinício.

Se um cliente não conseguir entrar

  • "Outdated server" ou "Outdated client": Verifica primeiro a direção. Para clientes mais recentes precisas do ViaVersion; para clientes mais antigos, também do ViaBackwards. Depois, verifica as versões realmente suportadas e o estado do plugin.
  • O plugin não carrega: Procura no protocolo de arranque por ViaVersion, ViaBackwards, erros de Java e Ambiguous plugin name. Se houver JARs duplicados, verifica primeiro os ficheiros no painel e remove apenas o ficheiro claramente excedente.
  • A entrada funciona, mas as funcionalidades não: A tradução de protocolo não consegue adaptar completamente novos blocos, menus ou mecânicas a servidores antigos. Testa as funcionalidades relevantes com a versão de cliente afetada; em modpacks, cliente e servidor continuam a ter de corresponder ao pack.
  • A ligação por proxy falha: Verifica separadamente a versão do proxy, a versão do backend e o local de instalação dos plugins Via. Um teste direto bem-sucedido no backend ainda não prova que o caminho pelo proxy funciona.

FAQ

O ViaVersion transforma o meu servidor na nova versão do Minecraft?

Não. O ViaVersion apenas traduz o protocolo de rede para que um cliente mais recente consiga comunicar com um servidor mais antigo. Blocos, itens e mecânicas de jogo de uma versão mais recente não chegam ao servidor por causa disso — para isso tens de mudar a versão do próprio servidor.

Preciso também do ViaBackwards?

Só para o sentido inverso, ou seja, quando jogadores com um cliente mais antigo querem entrar num servidor mais recente. O ViaBackwards requer o ViaVersion; para versões de cliente muito antigas, entra também o ViaRewind. Verifica a tabela de compatibilidade do projeto antes de garantires uma versão específica aos jogadores.

Jogadores Bedrock podem entrar através do ViaVersion?

Não. Bedrock usa um protocolo fundamentalmente diferente; para isso servem o Geyser e o Floodgate. O ViaVersion trabalha exclusivamente entre versões Java.

O que acontece se houver dois ficheiros ViaVersion?

Nesse caso, o Paper pode não conseguir carregar o plugin de forma inequívoca e mostra Ambiguous plugin name no protocolo de arranque. Em servidores adequados, o ViaVersion já está instalado como plugin de sistema — não carregues um segundo JAR a partir do navegador; verifica em Plugins → Instalado se cada componente Via existe exatamente uma vez.

Um reload de plugin chega depois de uma atualização?

Não. A documentação do projeto indica um reinício completo do servidor como o caminho fiável; um reload através de um gestor de plugins pode deixar um estado carregado apenas parcialmente. Cria um backup antes da atualização e depois reinicia tudo completamente.

Guias adicionais

Alteras a versão real do servidor com Mudar a versão do servidor Minecraft. Para verificar a instalação, ajuda o guia Instalar e gerir plugins do Minecraft. Se um jogador for recusado por causa de um modpack errado, lê Entrar num servidor de modpack Minecraft.

Fontes