Geyser permite que clientes Bedrock conversem com um servidor que fala o protocolo Java. Isso amplia quem consegue entrar, mas não transforma um servidor de mods em um servidor Bedrock nativo e não garante que a interface se comporte exatamente igual nas duas edições. Floodgate é uma escolha adicional de autenticação, usada quando Bedrock deve entrar sem possuir uma conta Java vinculada.

Este roteiro pressupõe um Paper acessível diretamente ou por uma configuração de rede compatível. Antes de mexer na autenticação, decida se os jogadores Bedrock usarão uma conta Java para autenticar no servidor. Para qualquer cenário, mantenha a lista de plugins e o runtime atualizados, faça backup e experimente o acesso com uma conta de teste sem privilégios.

Escolha entre conta Java e Floodgate

Geyser faz a tradução do protocolo entre Bedrock e Java. Ele não cria uma identidade Java para alguém que não possui uma. Se cada jogador Bedrock terá uma conta Java válida, configure e teste primeiro Geyser sem alterar o modelo de autenticação do servidor.

Floodgate permite autenticar uma conta Bedrock por meio das integrações suportadas, evitando a exigência de uma conta Java. Essa decisão muda como a identidade do jogador chega ao servidor e precisa ser tratada como configuração de segurança. Use somente os arquivos oficiais da plataforma, mantenha o componente atualizado e siga o procedimento atual do manual do Floodgate.

Não use modos de autenticação alternativos por tentativa para resolver uma tela de conexão. Confirme a opção documentada para sua instalação e teste identificação, permissões, inventário e comandos com uma conta Bedrock de teste. Um prefixo visual de nome não constitui prova de identidade e não deve ser usado sozinho para conceder privilégios.

Escolha o modo de instalação correto

Para Paper, use os plugins preparados para o ecossistema Bukkit/Paper. A documentação do Geyser disponibiliza opções diferentes para proxy, plugin, mod ou instalação standalone. Escolha uma única topologia e siga as instruções correspondentes. Um arquivo destinado a Fabric ou a um proxy não se torna um plugin Paper só porque possui extensão JAR.

Em uma rede com Velocity, coloque Geyser na entrada indicada pela documentação para essa arquitetura e configure o encaminhamento de informações entre o proxy e o servidor de destino. Não instale cópias redundantes de Geyser em todos os servidores sem uma razão documentada. Floodgate pode exigir componentes adicionais nos destinos para integrações que dependem da identidade Bedrock; confirme a orientação específica da versão instalada.

Baixe os componentes do site oficial e registre as versões do Paper, Java, Geyser e Floodgate. Confira as compatibilidades declaradas no momento da instalação. O cliente que o Geyser simula pode mudar com atualizações, então a documentação antiga de um tutorial não prova que a combinação atual continua compatível.

Instale com um caminho de volta

  1. Avise a equipe e faça uma cópia de segurança dos mundos e configurações.
  2. Pare o servidor normalmente pelo painel.
  3. Coloque em plugins somente o arquivo compatível com Paper que você escolheu.
  4. Inicie uma vez para permitir que o plugin gere os arquivos de configuração.
  5. Leia o console e confirme que o componente carregou sem erro.
  6. Pare novamente antes de alterar arquivos e preserve uma cópia da configuração inicial.

Em um painel administrado pelo provedor, veja como a porta Bedrock é provisionada antes de alterar qualquer número. Plataformas diferentes controlam portas e protocolos de maneiras próprias. Evite reservar uma porta de Java e presumir que ela estará acessível por UDP.

Entenda a porta e o protocolo de rede

Bedrock normalmente chega por UDP; jogadores Java normalmente entram por TCP. Uma conexão Java funcionando não confirma que a rede permite a entrada Bedrock. Confira no painel a porta e o protocolo informados pelo provedor, a configuração de escuta do Geyser e as regras de firewall correspondentes.

Se Geyser está em outra máquina ou em um proxy, verifique primeiro o tráfego entre o cliente e essa entrada, depois entre a entrada e o Paper. Anote endereço de escuta, endereço anunciado e porta pública. Quando a hospedagem atribui uma porta que muda ou precisa ser reaproveitada, aplique a opção documentada para esse serviço em vez de copiar um valor fixo de outro tutorial.

Em uma rede residencial, encaminhar apenas TCP não libera a porta Bedrock. Confirme que o roteador e o firewall liberam UDP na porta recebida, e teste a partir de uma rede externa. Testar na mesma rede pode depender de suporte a loopback e produzir um resultado diferente do acesso público.

Configure a autenticação com cuidado

Com contas Java, mantenha o servidor na autenticação apropriada para sua arquitetura e use a opção indicada pelo Geyser. Com Floodgate, instale as integrações nos pontos previstos pelo manual e configure o modo correspondente. Guarde segredos somente em arquivos privados no painel; eles não devem aparecer em anúncios, capturas de tela públicas ou comandos enviados a jogadores.

Quando houver proxy, o encaminhamento de UUID, nome e endereço IP deve ser coerente em todas as etapas. Consulte o guia de proteção com Velocity antes de expor o servidor de destino. O backend não deve confiar em dados de identidade encaminhados por uma conexão pública que não passou pelo proxy configurado.

Revise o efeito nos plugins de permissões e no nome da conta. Use a documentação do LuckPerms e do plugin que concede cada poder. Um jogador Bedrock pode ter regras de caracteres ou tratamento de identidade distintos; nunca conceda OP automaticamente para corrigir conflito de comando.

Teste sem contaminar dados reais

Comece com uma conta Java e uma Bedrock sem privilégios. Confirme que ambas entram, aparecem com identidades estáveis e conseguem realizar a atividade central do servidor. Experimente o inventário, movimento, chat, seleção de itens e interfaces que plugins apresentem. A camada de tradução pode expor diferenças que só aparecem em um menu específico.

Teste também recusa de autenticação, whitelist e punições esperadas. Verifique que uma conta que não deveria entrar é recusada. Se a arquitetura usa proxy, tente acessar o backend diretamente em um teste autorizado para confirmar que a rede impede a entrada fora do caminho previsto.

Registre edição e versão do cliente, plataforma, horário e erro exibido. Se Java entra e Bedrock não, investigue UDP e o listener de Geyser antes de reinstalar o mundo. Se Bedrock entra mas não atravessa o proxy, verifique as configurações de encaminhamento e as versões em cada servidor.

Entenda o limite de mods e interfaces

Geyser não executa um mod cliente Bedrock. Um servidor Fabric ou NeoForge pode exigir que o cliente Java instale mods que não existem para Bedrock. Uma tradução de protocolo permite algumas interações, mas não substitui dependências de cliente. Consulte os requisitos de cada mod antes de prometer cross-play para um modpack.

Também considere interfaces e mecânicas com entrada diferente. Teste inventários personalizados, teclas de atalho, seleção de itens e campos de texto usados por plugins. Uma função que depende de gesto ou tela da edição Java pode exigir adaptação ou não funcionar para um cliente Bedrock.

Diagnostique uma falha seguindo as etapas da conexão

  • Servidor aparece offline: confira o endereço anunciado, a porta UDP e a regra de rede do serviço.
  • Geyser não inicia: leia a primeira exceção do console e confirme o arquivo correspondente à plataforma instalada.
  • Cliente informa versão incompatível: confira a compatibilidade atual entre a versão Bedrock e o protocolo que o Geyser oferece.
  • Jogador entra com nome inesperado: revise a autenticação escolhida e a documentação do Floodgate antes de alterar permissões.
  • Proxy não encaminha corretamente: valide o caminho de identidade no Geyser, Velocity e Paper como uma única configuração.

Altere uma causa por vez e guarde os logs. Não publique a configuração completa do Geyser: ela pode conter informações e chaves que devem continuar privadas. Remova segredos de qualquer arquivo enviado a um fórum de suporte.

Libere e mantenha o acesso

Antes de anunciar cross-play, confirme que uma conta Bedrock real conseguiu entrar pela rede pública, executar o fluxo principal e reconectar depois de uma reinicialização. Confirme também que Java continua funcionando, que as regras de permissão se aplicam e que o backend não aceita acessos indevidos.

Após atualizações do Minecraft, Paper, Geyser ou Floodgate, repita testes curtos de conexão e identidade em uma cópia. Atualize as instruções de endereço e porta Bedrock separadamente das instruções Java quando necessário. Para comunidades que usam proxy, mantenha as referências de segurança do Velocity e decisões de cross-play no roteiro de manutenção.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.