Floodgate 基岩版登录支持（模组版）

Floodgate 基岩版登录支持（模组版）

> Geyser 的最佳拍档：让基岩版玩家直接进正版验证服务器，不用再为了他们关掉 online-mode。
基本信息

| 项目 | 信息 |
| --- | --- |
| 名称 | Floodgate（本页为模组版）|
| 开发者 | GeyserMC 团队 |
| 最新版本 | 2.2.7-b69（2026-09-17，面向 26.3）|
| 许可协议 | MIT |
| 兼容版本 | Minecraft Java 1.19.4 – 26.3 |
| 加载器 | Fabric、NeoForge（服务端）|
| 运行侧 | 仅服务端；客户端不需要装 |
| 前置依赖 | 需要搭配 Geyser 使用 |
| 项目地址 | https://modrinth.com/mod/floodgate |
简介

正版验证服务器（online-mode=true）只接受通过 Mojang 验证的账号，而基岩版玩家没有 Java 版账号——传统做法是关掉正版验证，代价是冒名登录和盗号风险。Floodgate 解决的就是这个问题：它让 Geyser 转发过来的基岩版玩家以"受信任的访客"身份进入正版验证服，这就是混合模式。

Modrinth 上这一份是模组版（Fabric / NeoForge 服务端）。如果你的服是插件端或代理端结构，请装对应的 Spigot/Paper 插件版或 Velocity/BungeeCord 版。
核心特性
基岩版玩家可进 online-mode=true 的服务器，无需关闭正版验证
基岩版玩家自动获得带前缀的账号标识，与 Java 正版玩家共存
官方 Wiki 提供完整配置与进阶用法（含 Floodgate API）
版本跟进及时，26.x 已有构建
MIT 许可，服务端侧组件，玩家无感知
安装方法
先确保 Geyser 已经装好并能正常转发（可参考本站 Geyser 那篇）
服务端装 Fabric 或 NeoForge
下载对应加载器的 jar 放进 mods/，重启服务端
进服后基岩版玩家应能以混合模式身份加入，Java 正版玩家不受影响
使用提示
Floodgate 和 Geyser 必须配套，只装一个都没用
按服务端形态选版本：模组服（Fabric/NeoForge）用这份，插件服用 Spigot/Paper 版，代理端结构用 Velocity/BungeeCord 版
基岩版玩家的账号标识带前缀（默认 .），做权限组时记得单独配置
授权系统、白名单类插件若按正版 UUID 校验，需要额外兼容基岩版玩家
不要在代理端和后端服同时装同一套，避免重复处理
相关链接
Modrinth 项目页：https://modrinth.com/mod/floodgate
官方 Wiki（Floodgate 章节）：https://wiki.geysermc.org/floodgate/
源码仓库：https://github.com/GeyserMC/Floodgate-Modded
Discord 社区：https://discord.gg/geysermc