1. O que são Geyser e Floodgate
- Geyser: plugin que traduz o protocolo do Minecraft Bedrock para o protocolo do Minecraft Java, permitindo que jogadores de celular, console e Windows 10/11 (Bedrock) entrem em servidores Java.
- Floodgate: complementa o Geyser permitindo que jogadores Bedrock entrem sem precisar de uma conta Xbox vinculada ao Java, usando um sistema de autenticação próprio.
2. Instalando o Geyser
- Baixe o plugin Geyser-Spigot (para servidores Paper/Spigot/Purpur) em geysermc.org/download.
- Na aba Arquivos do painel, entre na pasta plugins e envie o arquivo
.jar baixado.
- Reinicie o servidor para o plugin gerar os arquivos de configuração.
3. Configurando o geyser-config.yml
Após o primeiro início, será criada a pasta plugins/Geyser-Spigot com o arquivo config.yml. Os principais campos são:
bedrock:
address: 0.0.0.0
port: 25733 # substitua pela porta que você pegou na aba Rede
java:
auth-type: floodgate # defina assim depois de instalar o Floodgate (seção 5)
O campo address dentro de bedrock: é o endereço em que o Geyser vai escutar — na grande maioria dos casos, deixe como 0.0.0.0 (escuta em todas as interfaces). Só precisa mudar isso se quiser limitar de onde as conexões podem vir.
ℹ️
Sobre a porta (bedrock.port): ela não precisa ser a padrão 19132. Vá até a aba Rede do seu servidor no painel, crie (ou use) uma alocação já liberada pelo host, e coloque exatamente esse número no campo port dentro do bloco bedrock:.
ℹ️
Sobre a autenticação (auth-type): esse campo fica dentro do bloco java: (em versões mais antigas do Geyser esse bloco podia se chamar remote:). Por padrão vem como online. Depois de colocar o arquivo .jar do Floodgate na pasta plugins (veja a seção 5), é obrigatório alterar esse campo para floodgate — é isso que permite que jogadores Bedrock entrem sem precisar de uma conta Java oficial vinculada.
4. Liberando a porta Bedrock (UDP)
O Geyser usa uma porta UDP separada da porta do Java — o número é o mesmo que você definiu em bedrock.port na seção anterior.
- No painel, vá até a aba Rede do servidor e confirme que a alocação criada para o Geyser está liberada como UDP.
- Caso o painel não permita UDP na mesma alocação, ajuste a porta do Geyser (
bedrock.port) para uma alocação já liberada e informe essa porta aos jogadores Bedrock.
⚠️
Atenção: Sem a porta UDP liberada corretamente, jogadores Bedrock não conseguem se conectar mesmo com o Geyser instalado.
5. Instalando o Floodgate
- Baixe o plugin Floodgate-Spigot em geysermc.org/download.
- Envie o
.jar para a pasta plugins, junto com o Geyser.
- Reinicie o servidor. Será gerada a pasta
plugins/floodgate com uma chave de autenticação (key.pem) — não delete esse arquivo.
ℹ️
Com o Floodgate ativo, jogadores Bedrock entram com um prefixo no nome (padrão .) e não precisam de conta Java/Xbox vinculada.
6. Conectando pelo cliente Bedrock
- No Minecraft Bedrock, vá em Jogar > Servidores > Adicionar Servidor.
- Informe o IP do servidor e a porta Bedrock/UDP (não a porta Java).
- Salve e conecte normalmente.
7. Problemas comuns
- Não conecta: verifique se a porta UDP está realmente aberta/alocada no painel.
- Cai ao entrar: confira se a versão do Geyser é compatível com a versão do servidor Java.
- Sem blocos/itens exclusivos do Bedrock: normal, alguns blocos e mecânicas não têm equivalente direto no Java.