Plugin Minecraft floodgate

🔌 Sobre o Floodgate

Floodgate é um plugin complementar do Minecraft para o Geyser que permite que jogadores da Bedrock Edition entrem em servidores da Java Edition sem precisar de uma conta Java. Ele fornece a funcionalidade de autenticação e vínculo de contas que o Floodgate precisa para permitir que clientes Bedrock apareçam como jogadores válidos em servidores Java em online-mode.

🎯 Objetivo

O objetivo principal do Floodgate é fazer a ponte entre as diferenças de autenticação entre as edições Bedrock e Java: ele verifica identidades Bedrock (Xbox/Microsoft), mapeia-as para entradas de jogador compatíveis com Java e oferece suporte a vinculação local e global de contas para que a identidade de um jogador Bedrock possa ser reconhecida de forma consistente entre servidores que usam Floodgate. ()

⚙️ Recursos

• Autenticação de contas Bedrock e mapeamento para contas de jogador Java. ()
• Comandos locais de vinculação e desvinculação de contas para jogadores. ()
• Um comando de whitelist para gerenciar jogadores Floodgate (Bedrock) separadamente das whitelists Java. ()
• Uma API de plugin que outros plugins podem usar para detectar e interagir com jogadores Bedrock gerenciados pelo Floodgate. ()

🧩 Para quem é

O Floodgate é voltado para donos de servidores e administradores de rede que usam o Geyser para permitir que jogadores Bedrock entrem nos seus servidores Java e que precisam de uma solução robusta de autenticação/vinculação para identidades Bedrock.

🏗️ Casos de uso de exemplo

• Permitir que jogadores Bedrock de celular e console entrem em um servidor Java SMP ou Survival já existente, mantendo as contas dos jogadores separadas e rastreáveis.
• Vincular a identidade Bedrock de um jogador a uma conta Java para que plugins e permissões continuem funcionando de forma consistente para esse usuário.

⌨️ Comandos

(Os comandos e os nós de permissão são retirados da documentação oficial do Floodgate.) ()

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe a build apropriada do Floodgate para o tipo do seu servidor e coloque o .jar no diretório plugins/ do seu servidor (ou instale o mod para Fabric/NeoForge, quando aplicável).
• Reinicie o servidor e verifique o console para confirmar que o Floodgate foi carregado.
• Se estiver usando o Geyser, atualize a configuração do Geyser para usar auth-type: floodgate para que o Geyser delegue a autenticação Bedrock ao Floodgate. ()

📦 Dependências

• O Floodgate foi projetado para ser usado com o Geyser na ponte Bedrock-to-Java; as notas de instalação e a configuração recomendada estão documentadas na documentação oficial do Floodgate/Geyser. ()

🧠 Observações técnicas

• O Floodgate é distribuído tanto como plugins para software de servidor quanto como mods para Fabric/NeoForge; os tipos de servidor suportados incluem Spigot (e forks como Paper), BungeeCord, Velocity e builds para Fabric/NeoForge. ()
• O Floodgate expõe uma API que outros plugins podem usar para consultar informações de jogadores Floodgate e responder a eventos específicos do Bedrock. ()

🤝 Quando este plugin é útil

Se você usa o Geyser para permitir que jogadores Bedrock entrem nos seus servidores Java, o Floodgate é o componente que cuida da identidade Bedrock e da vinculação de contas, para que esses jogadores sejam reconhecidos e possam ser usados por plugins e sistemas de servidor do lado Java.