Deixa jogadores Bedrock entrar no teu servidor Java: configurar Geyser + Floodgate (Paper, Velocity)

O que fazem o Geyser e o Floodgate

O Geyser traduz entre as duas edições. Para o teu servidor, comporta-se como um cliente Java, por isso redstone, farms e plugins funcionam exatamente como para os jogadores Java. O Floodgate deixa os jogadores Bedrock entrar com a conta Xbox em vez de uma conta Java.

Antes de começares: Java e versões

• O Geyser precisa de Java 21 ou mais recente na máquina onde corre.
• O teu servidor tem de aceitar a versão Java mais recente, porque o Geyser imita um cliente desses. Servidores mais antigos precisam do ViaVersion.
• O Geyser-Spigot corre em Paper e Spigot a partir da 1.20.5. Servidores mais antigos precisam de um proxy, do Geyser Standalone ou do ViaProxy.
• Só são suportadas versões Bedrock atuais (outubro de 2026: Bedrock 26.30 a 26.52, Java 26.2). Mantém o Geyser atualizado, porque o Bedrock atualiza-se sozinho.

Transfere o Geyser e o Floodgate para a tua plataforma na página oficial de downloads do GeyserMC.

Configuração num único servidor Paper ou Spigot

1. Coloca Geyser-Spigot.jar e Floodgate-Spigot.jar na pasta plugins.
2. Reinicia o servidor. O Geyser cria plugins/Geyser-Spigot/config.yml e o Floodgate cria plugins/floodgate/ com config.yml e um key.pem.
3. Abre a config do Geyser e verifica a secção bedrock. A port é o que os jogadores Bedrock vão escrever.
4. Define o tipo de autenticação como floodgate e reinicia outra vez.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

As configs mais antigas do Geyser chamam remote à segunda secção, por isso a definição é remote.auth-type. As builds atuais passam para o Floodgate sozinhas quando ele corre no mesmo servidor; defini-lo não faz mal nenhum.

Num único servidor, não copies o key.pem para lado nenhum. O Geyser lê-o do Floodgate, e uma cópia esquecida na pasta do Geyser causa erros de login.

Abre a porta Bedrock para UDP

O Java usa TCP, o Bedrock usa UDP. É aqui que falha a maioria das configurações.

• Painel de alojamento: adiciona uma porta extra (muitos hosts chamam-lhe allocation) e introdu-la como bedrock.port. Alguns hosts obrigam o Bedrock a usar a mesma porta do Java ou mudam a porta Java a cada arranque; aí, clone-remote-port: true faz o Geyser usar a porta Java. A página de configuração do Geyser tem instruções para muitos hosts.
• Pterodactyl: atribui a porta ao servidor no separador Network.
• Máquina própria ou VPS: abre a porta para UDP na firewall e, em casa, no router. A OVH e a Oracle Cloud também bloqueiam UDP na sua própria firewall.

sudo ufw allow 19132/udp
sudo ufw reload

Plugins de chat de voz ou o query não podem partilhar a porta com o Geyser. Quando a porta estiver aberta, executa geyser connectiontest <ip> <port> na consola; verifica a porta e sugere soluções.

Configuração numa network Velocity ou BungeeCord

Numa network, os jogadores Bedrock ligam-se ao proxy tal como os jogadores Java. Por isso, o Geyser corre só no proxy.

1. Instala o Geyser e o Floodgate para o teu proxy (Velocity ou BungeeCord) e reinicia o proxy.
2. Define a bedrock.port e o tipo de autenticação floodgate na config do Geyser no proxy, e abre a porta para UDP como descrito acima.
3. Instala o Floodgate-Spigot em todos os backends. É obrigatório para plugins que usam a API do Floodgate e melhora as skins.
4. Configura o forwarding: no BungeeCord, define ip_forward: true no config.yml dele e bungeecord: true no spigot.yml de cada backend; no Velocity, configura o encaminhamento de informação dos jogadores como descrito na documentação do Velocity.
5. Na config do Floodgate no proxy, define send-floodgate-data: true.
6. Copia o key.pem da pasta do Floodgate no proxy para a pasta do Floodgate de todos os servidores de backend e depois reinicia os backends e o proxy.

send-floodgate-data: true

Mantém o key.pem secreto: permite que contas passem a autenticação Java. Carrega-o por FTP em modo binário, senão aparecem erros Tag mismatch.

Nomes Bedrock: o prefixo com ponto

O Floodgate põe um prefixo antes de cada nome Bedrock para que nunca colida com um nome Java. A predefinição é um ponto, por isso a gamertag Xbox Steve passa a .Steve no teu servidor. Os espaços nas gamertags são substituídos por _.

username-prefix: "."
replace-spaces: true

• Nos comandos, usa o nome completo com o prefixo. Se um comando não o aceitar, põe o nome entre aspas: /tp ".Steve".
• Para a whitelist, usa fwhitelist add Steve. Aí o prefixo não é necessário.
• Se o LuckPerms tiver problemas com nomes Bedrock, define allow-invalid-usernames: true na config dele.

O GeyserMC aconselha a manter o prefixo. Os jogadores Bedrock também votam com este nome: na BestMCServerList escrevem .Steve, o nome que o teu plugin de recompensas de voto vê.

Contas ligadas e skins (opcional)

O Global Linking está ativo por predefinição no Floodgate. Os jogadores que têm as duas edições entram em link.geysermc.org com as duas contas e escrevem /linkaccount. A partir daí jogam com o inventário e a localização da conta Java em qualquer dispositivo, por isso devem mudar primeiro os seus itens Bedrock. Uma base de dados de ligações local precisa de uma extensão extra do Floodgate.

O Floodgate converte e carrega as skins Bedrock para que os jogadores Java as vejam. Isto passa por uma fila e pode demorar algum tempo.

Erros comuns e soluções

Há coisas que não se conseguem traduzir: os cliques esquerdo e direito nos inventários parecem iguais, os comandos sem Brigadier não têm autocompletar com tab e as ligações no chat não são clicáveis. Testa os menus com um dispositivo Bedrock a sério. Os plugins podem mostrar formulários Bedrock nativos através da API do Floodgate, o que exige o Floodgate no servidor deles.

Mostra os dois endereços na BestMCServerList

Os jogadores Bedrock ligam-se com o teu endereço mais a porta Bedrock, por exemplo play.example.net e 19132. A BestMCServerList mostra o endereço Java e o Bedrock em separado em cada página de servidor, cada um com um botão de copiar.

1. Abre Adicionar o teu servidor e introduz o teu endereço Java.
2. Marca Jogadores Bedrock são suportados.
3. Introduz a Porta Bedrock de bedrock.port. Deixa o IP Bedrock vazio se for igual ao endereço Java.

O crossplay é uma vantagem real para um servidor novo. Vê como arranjar jogadores para um servidor novo para o resto do plano.