O Geyser é um plugin que permite que jogadores da versão java e bedrock joguem no mesmo servidor. Ele funciona como uma ponte entre a conexão do jogador bedrock e o servidor java, assim você pode jogar com seus amigos de ambas as versões. Veja aqui como instalar e configurar o geyser no seu servidor Enxadahost, bem como resolver problemas comuns e atualizar a versão caso seja necessário!
Atenção: a partir da versão 26.60 do Minecraft Bedrock (lançada em 27 de outubro de 2026), o bedrock passou a usar um novo sistema de conexão chamado NetherNet. Com ele, o geyser não pode mais usar a mesma porta do servidor java, por isso agora ele precisa de uma porta secundária. Mesmo que você já usasse o geyser antes, siga os passos abaixo para que os jogadores bedrock voltem a conseguir entrar.
Neste artigo:
- Como instalar e configurar o Geyser
- Meu servidor usa uma versão mais antiga do Paper, como usar o geyser nela?
- Como instalar o Floodgate
- O Minecraft Bedrock atualizou e meu Geyser não funciona, e agora?
Como instalar e configurar o Geyser
1 - Primeiro, peça a sua porta secundária para o geyser abrindo um chamado com o nosso suporte. Assim que ela for liberada, anote o número da porta, você vai usar ele no passo 3.
2 - No painel do seu servidor, vá em Configurações > Versões e instale a versão com o Geyser.
3 - Dentro da pasta de plugins no gerenciador de arquivos vai existir a pasta de configurações do geyser (Geyser-Spigot), e dentro dela um arquivo chamado “CONFIG.YML”. Procure a parte que começa com bedrock: e deixe as linhas abaixo assim, trocando PORTA_SECUNDARIA pelo número da porta que o suporte liberou para você.
OBS: caso o address, webrtc-port, transport e clone-remote-port não estejam como na imagem abaixo, altere eles.
Pronto! Agora é só salvar o arquivo, iniciar o servidor e conectar:
- Jogadores java: usam o IP e a porta normal do servidor. O IP fica logo abaixo do nome do seu servidor. No exemplo da imagem o IP é enx-cirion-8.enx.host e a porta é 10010.
- Jogadores bedrock: usam o mesmo IP, mas com a porta secundária. No exemplo, seria enx-cirion-8.enx.host com a porta que o suporte liberou.
Os jogadores bedrock precisam estar na versão mais recente do Minecraft. Na primeira vez que entrarem, o jogo pode perguntar se eles confiam no servidor: é só confirmar para continuar.
Meu servidor usa uma versão mais antiga do Paper
O geyser funciona como se o jogador bedrock fosse um jogador java na versão mais recente do Minecraft. Por isso, se o seu servidor usa uma versão mais antiga do paper, você vai precisar instalar o geyser manualmente junto com o plugin ViaVersion, que permite que versões mais novas entrem em servidores de versões mais antigas.
Importante: o geyser só funciona em servidores paper da versão 1.20.5 ou mais recente, usando Java 21 ou superior. Em versões abaixo da 1.20.5 não é possível usar o geyser como plugin.
1 - Peça a sua porta secundária para o geyser abrindo um chamado com o nosso suporte.
2 - Acesse o site do geysermc e baixe a versão mais recente do geyser (Spigot/Paper): https://geysermc.org/download
3 - Baixe também a versão mais recente do ViaVersion: https://viaversion.com
4 - Coloque os dois arquivos dentro da pasta de plugins do seu servidor. Para mais detalhes, veja nosso tutorial de instalação de plugins
5 - Inicie o servidor uma vez para que a pasta de configurações do geyser (Geyser-Spigot) seja criada, e depois desligue ele.
6 - Agora é só configurar o config.yml do geyser com a porta secundária, do mesmo jeito que no passo 3 da instalação, e iniciar o servidor novamente.
Sempre que o geyser for atualizado, atualize também o ViaVersion, porque ele precisa suportar a mesma versão do Minecraft que o geyser.
Como instalar o Floodgate
Note que os jogadores bedrock vão precisar de uma conta java para conectar no servidor. Caso não queira isso, você pode instalar o plugin Floodgate também: https://geysermc.org/download/?project=floodgate
Coloque o Floodgate na pasta de plugins e depois vá no arquivo de configuração do geyser, procure a parte que começa com java: e altere o valor auth-type: online para floodgate.
Em versões antigas do geyser essa parte se chamava remote: em vez de java:. Ao atualizar o plugin, o arquivo é convertido automaticamente para o formato novo.
O Minecraft Bedrock atualizou e meu Geyser não funciona, e agora?
Quando o minecraft bedrock lança uma nova versão o geyser para de funcionar e os jogadores bedrock não conseguem mais acessar o servidor. Para voltar ao normal você precisa atualizar também o geyser para suportar a nova versão do bedrock. Para isso, é só reinstalar o geyser pelo painel, em Configurações > Versões. Depois confira se o config.yml continua com a porta secundária e o transport: nethernet.
Porém note que às vezes os desenvolvedores do geyser demoram um pouco para lançar a atualização, então se seu bedrock acabou de atualizar pode ser que demore um ou dois dias para que o geyser lance a nova versão compatível. Isso tudo você pode ficar sabendo direto na página de download deles: https://geysermc.org/download