Como Permitir Jogadores do Bedrock no Seu Servidor Minecraft Java

Um guia sobre como instalar e configurar o Geyser e o Floodgate para que jogadores de Minecraft: Bedrock Edition possam entrar no seu servidor Java Edition. Este guia cobre Spigot/Paper, Fabric, NeoForge, BungeeCord, Velocity, ViaProxy, e o build standalone.

O Geyser é uma ponte que traduz entre as duas edições do Minecraft. Ele faz com que seu servidor Java Edition apareça para um cliente Bedrock como se fosse um servidor Bedrock, o que significa que jogadores em celulares, tablets, consoles e na edição Windows 10/11 podem entrar em um servidor que, de outra forma, não conseguiriam ver. O Floodgate é o companheiro dele, e é o que permite que esses jogadores Bedrock entrem sem possuir uma conta Java Edition.

Requirements

• Um servidor Minecraft: Java Edition cujos arquivos você controla. Um host que não permite enviar jars não consegue rodar o Geyser.
• Java 21 ou superior, que é o que o software de servidor atual do Minecraft já exige de qualquer forma.
  • Baixe em: Adoptium ou Oracle
• Uma porta UDP que você possa abrir e fazer port forward. A Bedrock Edition usa UDP, não TCP, e esse é o erro mais comum que as pessoas cometem.
• Se você estiver em um host compartilhado, verifique se eles permitem uma segunda porta. Alguns só liberam uma.

How Geyser and Floodgate Work Together

Gostaria de explicar brevemente como os dois plugins trabalham juntos, porque instalar um sem o outro pode resultar em jogadores Bedrock incapazes de se conectar corretamente (por exemplo, eles podem ainda precisar vincular uma conta Java).

Geyser faz a tradução Java <-> Bedrock. Ele escuta em uma porta UDP, aceita conexões Bedrock e fala o protocolo da Java Edition com seu servidor do outro lado. Sozinho, o Geyser permite que um jogador Bedrock se conecte, mas esse jogador ainda precisa autenticar como uma conta Java Edition, o que a maioria dos jogadores Bedrock não possui.

Floodgate remove essa exigência. Ele diz ao servidor Java para aceitar um jogador que já foi aprovado pelo Geyser, sem precisar de uma conta Java. É por isso que os dois quase sempre são instalados juntos, e é por isso que o Floodgate vem com um arquivo key.pem que você é avisado, em termos bem enfáticos, para não compartilhar. Essa chave é o que permite que uma conta pule a autenticação Java.

O Geyser é instalado uma vez, no ponto para onde seus jogadores Bedrock vão se conectar. O Floodgate é instalado no servidor que possui a lista de jogadores. Em um único servidor, é a mesma máquina. Em uma rede com proxy, tanto o Geyser quanto o Floodgate vão no proxy.

Downloading

Tudo vem da página oficial de downloads. Não recomendamos baixar isso em outro lugar.

No momento em que este texto foi escrito, os builds atuais são Geyser build #1234 (2 de setembro de 2026) e Floodgate build #140 (9 de agosto de 2026). Ambos os projetos publicam continuamente, então os números de build que você verá serão maiores. Isso é normal e esperado.

Which File Do I Need?

O Geyser publica um build para cada plataforma. O Floodgate não, e isso costuma pegar as pessoas de surpresa:

Platform	Geyser	Floodgate
Spigot / Paper	Geyser-Spigot.jar	floodgate-spigot.jar
Fabric	Geyser-Fabric.jar	floodgate-fabric.jar
NeoForge	Geyser-NeoForge.jar	floodgate-neoforge.jar
BungeeCord	Geyser-BungeeCord.jar	floodgate-bungee.jar
Velocity	Geyser-Velocity.jar	floodgate-velocity.jar
ViaProxy	Geyser-ViaProxy.jar	Não disponível
Standalone	Geyser-Standalone.jar	Não disponível

Não existe build do Floodgate para ViaProxy ou para o Geyser standalone. O Floodgate precisa rodar dentro do servidor Java que possui a lista de jogadores, e nessas duas configurações o Geyser está rodando externamente. Você instala o jar específico da plataforma do Floodgate no servidor Java para o qual está apontando o Geyser, e depois copia o key.pem desse servidor para o Geyser. Há uma seção sobre isso mais adiante.

Direct Download Links

Esses URLs sempre apontam para o build mais recente, então são seguros para favoritar ou usar em scripts!

• Spigot
• Fabric
• NeoForge
• BungeeCord
• Velocity
• ViaProxy
• Standalone
• Floodgate Spigot
• Floodgate Bungee
• Floodgate Velocity

Em um servidor Linux você pode baixar um diretamente:

wget -O plugins/Geyser-Spigot.jar \
  https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot

Installing Geyser

Escolha a única seção que corresponde à configuração do seu servidor. Você só precisa seguir as instruções para essa configuração.

Spigot & Paper

1. Baixe Geyser-Spigot.jar.
2. Coloque-o na pasta plugins/ do seu servidor.
3. Reinicie o servidor. Não use /reload, pois recargas de plugins causam mais problemas do que resolvem.
4. O Geyser gera sua configuração em plugins/Geyser-Spigot/config.yml.

Fabric

1. Baixe o Geyser-Fabric.jar.
2. Coloque-o na pasta mods/ do seu servidor.
3. Servidores Fabric também precisam do mod Fabric API na mesma pasta.
4. Reinicie o servidor. A configuração aparece em config/Geyser-Fabric/config.yml.

NeoForge

1. Baixe o Geyser-NeoForge.jar.
2. Coloque-o na pasta mods/ do seu servidor.
3. Reinicie o servidor. A configuração aparece em config/Geyser-NeoForge/config.yml.

BungeeCord

Instale o Geyser no proxy, não nos servidores backend. É ao proxy que os jogadores Bedrock irão se conectar.

1. Baixe o Geyser-BungeeCord.jar.
2. Coloque-o na pasta plugins/ do proxy.
3. Reinicie o proxy. A configuração aparece em plugins/Geyser-BungeeCord/config.yml.

Velocity

Mesma ideia do BungeeCord. O Geyser vai no proxy.

1. Baixe o Geyser-Velocity.jar.
2. Coloque-o na pasta plugins/ do proxy.
3. Reinicie o proxy. A configuração aparece em plugins/Geyser-Velocity/config.yml.

ViaProxy

ViaProxy é um proxy standalone que permite que clientes de uma versão do Minecraft entrem em um servidor de outra. O Geyser se conecta a ele como um addon.

1. Baixe o Geyser-ViaProxy.jar.
2. Coloque-o na pasta plugins/ do ViaProxy.
3. Inicie o ViaProxy uma vez para que o Geyser gere sua configuração, depois pare-o.
4. Como o Geyser está rodando fora do seu servidor Java aqui, você precisa dizer a ele onde esse servidor está. Veja The Remote Section.

Standalone

Standalone é o Geyser rodando como seu próprio programa, sozinho, apontado para um servidor Java pela rede. É a escolha certa quando você não pode instalar plugins ou mods no próprio servidor, e é a escolha errada em quase todos os outros casos, pois adiciona um salto de rede e não consegue usar o Floodgate sem configuração extra.

1. Baixe o Geyser-Standalone.jar.
2. Coloque-o em uma pasta própria.
3. Execute-o:

java -Xmx1G -jar Geyser-Standalone.jar

4. Ele gera config.yml ao lado de si mesmo e depois sai ou espera. Pare-o, edite a configuração e inicie-o novamente.

Configurando o Geyser

Abra o config.yml da sua plataforma. As duas seções que importam são bedrock e, no standalone e no ViaProxy, remote.

A Seção Bedrock

É nisso que os jogadores Bedrock se conectam:

bedrock:
  # The IP address that will listen for connections.
  # Generally, you should only change this if you want to limit what IPs can connect to your server.
  address: 0.0.0.0
  # The port that will Geyser will listen on for incoming Bedrock connections.
  # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
  port: 19132
  # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
  # This option makes the Bedrock port the same as the Java port every time you start the server.
  clone-remote-port: false

A porta é a parte que importa. 19132 é o padrão da Bedrock Edition, e deixá-la assim significa que os jogadores podem adicionar seu servidor apenas pelo endereço, sem digitar uma porta. Altere-a apenas se a 19132 já estiver em uso ou se o seu host atribuir outra.

clone-remote-port é para hosts que fornecem uma nova porta a cada reinicialização e esperam o tráfego Bedrock na mesma porta. Se você ativar essa opção, ela sobrescreve o valor de port acima, então configurar ambos e ficar se perguntando por que sua porta está sendo ignorada é uma armadilha que vale a pena conhecer.

address: 0.0.0.0 significa "escutar em todas as interfaces de rede", o que é o que você quer, a menos que esteja deliberadamente restringindo o acesso.

A Seção Remote (Apenas Standalone e ViaProxy)

Quando o Geyser roda como plugin ou mod, ele já sabe onde está o servidor, porque está dentro dele. Quando roda em standalone ou sob o ViaProxy, você precisa configurar a seção remote para apontar para o seu servidor Java.

remote:
  address: 127.0.0.1
  port: 25565
  auth-type: floodgate

Use 127.0.0.1 (localhost) se o servidor Java estiver na mesma máquina. Use o endereço real caso contrário, e esteja ciente de que você acabou de colocar uma conexão Minecraft não criptografada na rede entre os dois.

Instalando o Floodgate

O Floodgate deve ser colocado no servidor Minecraft Java que possui a lista de jogadores.

Spigot & Paper

1. Baixe o floodgate-spigot.jar na página de download.
2. Coloque-o na pasta plugins/.
3. Reinicie o servidor.

Fabric & NeoForge

1. Baixe o mod na página do Modrinth ou na página de download.
2. Coloque o arquivo na pasta mods/. Servidores Fabric também exigem o Fabric API instalado no servidor.
3. Reinicie o servidor.

Se o servidor Fabric estiver atrás de um proxy Velocity, você também precisará configurar o FabricProxyLite para que o servidor Fabric aceite os dados de jogador encaminhados pelo Velocity.

BungeeCord & Velocity

Instale o Floodgate apenas no proxy. Você não precisa dele nos servidores backend, a menos que queira especificamente usar a API do Floodgate lá, ou queira que as skins Bedrock apareçam corretamente no backend.

1. Baixe o floodgate-bungee.jar ou floodgate-velocity.jar.
2. Coloque o arquivo na pasta plugins/ do proxy.
3. Reinicie o proxy.

Definindo auth-type Para floodgate

Esse é o passo que realmente permite a entrada de jogadores Bedrock, e muitas pessoas acidentalmente pulam essa etapa (inclusive eu, quando instalei o Geyser e o Floodgate pela primeira vez anos atrás, rs).

Abra o arquivo de configuração do Geyser (não o do Floodgate), encontre a chave auth-type e defina-a como floodgate:

auth-type: floodgate

Os três valores que ela aceita são:

• floodgate - Jogadores Bedrock entram sem uma conta Java Edition. É isso que você quer, e requer que o Floodgate esteja instalado.
• online - todo jogador precisa possuir e autenticar uma conta Java Edition. Esse é o padrão.
• offline - nenhuma autenticação. Não recomendado em servidores públicos.

Reinicie o servidor após aplicar quaisquer alterações. O Geyser lê essa configuração na inicialização do servidor.

Executando o Floodgate Atrás de um Proxy

Se você tem um proxy com servidores backend atrás dele, e quer que a API do Floodgate esteja disponível nesses backends, há um pouco mais a fazer. Pule esta seção completamente se você tiver apenas um servidor.

1. Instale o Floodgate no proxy primeiro, como descrito acima.
2. Instale o Floodgate também em cada servidor backend, usando floodgate-spigot.jar ou floodgate-fabric.jar.
3. Ative o encaminhamento de informações do jogador (player information forwarding):
   • BungeeCord: defina ip_forward como true no config.yml do proxy, e defina bungeecord como true no spigot.yml de cada backend.
   • Velocity: configure o player information forwarding. O Velocity tem vários modos e cada um precisa de uma configuração diferente no backend, então siga o guia oficial em vez de adivinhar.
4. Inicie o proxy para que o Floodgate gere seus arquivos.
5. No config do Floodgate do proxy, defina send-floodgate-data como true.
6. Copie o arquivo key.pem da pasta de configuração do Floodgate do proxy para a pasta de configuração do Floodgate de cada servidor backend.
7. Reinicie os backends e o proxy.

AVISO: Como dito antes, não compartilhe o key.pem com ninguém, e não o cole em um canal de suporte ao pedir ajuda. Esse arquivo é o que permite que contas Bedrock pulem a autenticação da Java Edition. Qualquer um que tenha uma cópia pode entrar no seu servidor basicamente como qualquer pessoa, se for capaz de fazer isso.

A mesma cópia do key.pem é como você usa o Floodgate com o Geyser standalone ou com o ViaProxy. Instale o jar do Floodgate específico da plataforma no servidor Java e, em seguida, copie o arquivo key.pem desse servidor para a própria pasta de configuração do Geyser.

Abrindo a Porta

A Bedrock Edition usa UDP. Se você tentar abrir apenas TCP, o servidor não aparecerá na lista de servidores para clientes Bedrock.

Em um servidor Linux, você geralmente pode fazer isso usando o firewall instalado.

# IPTables (underlying firewall used by ufw on many Linux distributions)
iptables -A INPUT -p udp --dport 19132 -j ACCEPT

# UFW (Uncomplicated Firewall)
sudo ufw allow 19132/udp

# Firewalld (used by many Linux distributions)
sudo firewall-cmd --permanent --add-port=19132/udp
sudo firewall-cmd --reload

Se você estiver hospedando de casa, provavelmente precisará encaminhar a porta UDP 19132 no seu roteador para a máquina que está executando o Geyser. Se você estiver em um provedor de hospedagem, isso geralmente é uma alocação de porta no painel deles em vez de uma regra de firewall, e você pode precisar abrir um chamado para receber uma segunda porta.

Conectando pelo Bedrock

No cliente Bedrock, vá em Play, depois na aba Servers, e role até o final e escolha Add Server.

• Server Name: qualquer nome de sua preferência.
• Server Address: o endereço IP ou hostname do seu servidor.
• Port: 19132, ou o que você tiver definido no config.

NOTA: Isso funciona de forma estranha com jogadores de console. As edições PlayStation, Xbox e Nintendo Switch não permitem adicionar um endereço de servidor diretamente, e a solução alternativa comum é um truque de DNS que redireciona um dos servidores em destaque para o seu. Isso está fora do escopo deste guia, mas vale a pena pesquisar se necessário.

Notas

Aqui estão algumas notas úteis.

Versões Mais Antigas do Minecraft Precisam do ViaVersion

O Geyser tem como alvo o Minecraft atual. Se o seu servidor Java estiver rodando uma versão mais antiga que a 26.2 (ou a versão mais recente do Minecraft), você também precisará do ViaVersion para que os protocolos de rede antigos possam ser compreendidos. A própria página de versões suportadas do Geyser é o que recomendamos verificar para mais informações.

Vinculando Contas Java e Bedrock

Por padrão, um jogador Bedrock que entra através do Floodgate recebe uma conta separada no seu servidor, com um prefixo no nome (um ponto, por padrão). Se você quer que um jogador possa usar o mesmo inventário, permissões e tempo de jogo, seja entrando pelo Java ou pelo Bedrock, isso é o account linking (vinculação de contas).

Existem duas formas de fazer isso. O global linking, que usa o link.geysermc.org e não precisa de nenhuma configuração da sua parte. O local linking mantém os vínculos no seu próprio banco de dados e precisa de uma das extensões de banco de dados do Floodgate, publicadas na mesma página de download:

• floodgate-sqlite-database.jar: A mais simples (local), e adequada para um único servidor.
• floodgate-mysql-database.jar: Para bancos de dados MySQL.
• floodgate-mongo-database.jar: Para bancos de dados MongoDB.

A maioria dos donos de servidores opta por usar o global linking, pois não requer configuração adicional. Certifique-se de que seus jogadores saibam vincular suas contas em link.geysermc.org!

Jogadores Bedrock & Mods Java

O Geyser traduz o protocolo de rede vanilla que o Minecraft usa. Ele não traduz blocos e itens personalizados adicionados por mods, que podem aparecer errados ou invisíveis para um jogador Bedrock. O Hydraulic é o próprio projeto da GeyserMC para isso, e ele converte os assets dos mods em um resource pack Bedrock. Recomendamos fortemente conferi-lo se você planeja rodar mods no seu servidor.

Coisas Que Não Podem Compartilhar a Porta

Qualquer outra coisa no seu servidor que queira usar UDP na mesma porta entrará em conflito com o Geyser. As mais comuns são plugins de chat de voz (Simple Voice Chat em particular) e o protocolo Minecraft Query. Eles precisam rodar em sua própria porta.

Veja Também

• Como Instalar Um Servidor de Minecraft (Java Edition)
• Quanta RAM Para Um Servidor de Minecraft
• Geyser Wiki
• Floodgate Wiki

Conclusão

O crossplay é uma tarefa em duas partes. O Geyser abre uma porta UDP pela qual os clientes Bedrock podem passar, e o Floodgate é o que impede que eles sejam solicitados a ter uma conta Java Edition no caminho. Instale a dupla, defina auth-type como floodgate, abra a porta como UDP, e o resto é conferir se você colocou cada jar na pasta que sua plataforma realmente lê.

Se não funcionar, a ordem para verificar as coisas é quase sempre a mesma: a porta está aberta como UDP, o auth-type está definido como floodgate no config do Geyser (e não no do Floodgate), e o Floodgate está instalado no servidor que possui a lista de jogadores, em vez de em um backend atrás de um proxy.

Se você tiver alguma dúvida ou estiver procurando uma comunidade de modding para fazer parte, considere entrar no nosso servidor do Discord!

Os guias que criamos estão sempre abertos a edições e melhorias, então se você tiver alguma sugestão ou notar algum problema, sinta-se à vontade para contribuir criando um pull request em nosso repositório do GitHub!

Bom modding!