Geyser——在 Minecraft 中连接 Bedrock 玩家与 Java 服务器的插件
了解 Geyser 插件如何让 Bedrock 玩家连接到 Java 版 Minecraft 服务器,包括工作原理、Floodgate 认证方式、config.yml 关键配置参数以及功能限制。
了解 Geyser 插件如何让 Bedrock 玩家连接到 Java 版 Minecraft 服务器,包括工作原理、Floodgate 认证方式、config.yml 关键配置参数以及功能限制。
Geyser——在 Minecraft 中连接 Bedrock 玩家与 Java 服务器的插件
本文测试和撰写所使用的 Minecraft 版本:Java Edition 26.1.2(Bedrock 26.x)
支持的版本范围:最新构建为 Java 26.1 – 26.1.2 和 Bedrock 26.0 – 26.30;连接 1.16.5 及以上版本的服务器需要额外配置
Geyser 是一款代理插件,它让 Bedrock 版玩家可以加入 Java 版服务器。该插件在两个版本之间转换网络数据包:服主无需为每个版本单独维护一个世界,来自手机、主机和 Windows 版的玩家也能与 Java 版玩家连接到同一个服务器。
Geyser 的工作原理
Java 版和 Bedrock 版使用不同的网络协议,彼此并不直接兼容。代理位于两者之间:接收 Bedrock 客户端的连接,将其数据包转换为 Java 格式,反之亦然。对玩家来说,这只是通过地址和端口进行的普通登录。
插件可以通过两种方式运行:在现有服务器内部运行(Spigot、Paper、BungeeCord、Velocity、Fabric、NeoForge),或作为独立的 Standalone 程序运行在服务器前端。当无法直接访问服务器本身,或需要同时服务多个后端时,通常会选择 Standalone 方式。
Bedrock 玩家能获得什么
连接后,Bedrock 玩家会进入与 Java 用户相同的世界,并能看到彼此。版本之间的部分差异由自动加载的资源包 GeyserIntegratedPack 来弥合:它为 Bedrock 端添加了受击粒子效果、副手物品动画、与 Java 版相同宽度的记分板,以及 Java 风格的物品栏界面。
Bedrock 使用 1.8 版本的战斗机制运作,攻击没有冷却时间,而 Java 版则有攻击计时器。为了让玩家有所感知,代理会显示一个人为的冷却指示器——准星、快捷栏旁的进度条,或者不显示,具体取决于参数 cooldown-type 的设置。
认证与 Floodgate
登录方式由参数 auth-type 决定。默认值为 online ——Bedrock 玩家必须通过拥有 Java Edition 的 Microsoft 账户登录。这适用于所有人都拥有 Java 账户的服务器。
为了让没有 Java 版的玩家也能进入,通常会在 Geyser 旁边安装 Floodgate——由同一团队开发的另一款独立插件。当值设置为 auth-type: floodgate 时,玩家仅凭 Bedrock 账户即可登录。Floodgate 还能在 Java 端显示 Bedrock 玩家的皮肤,允许向他们发送原生的 Bedrock 表单,并将两个版本的账户关联起来。它适用于 Spigot/Paper、BungeeCord、Velocity 和 Fabric;如果不安装它,代理将以 online 模式运行。
主要配置参数
文件 config.yml 包含数十个选项,但启动时只需几个关键项即可——其余的属于网络的精细调整。
参数 | 作用 |
| 用于 Bedrock 连接的 UDP 端口;必须对 UDP 开放。 |
|
|
| 将 MOTD 从 Java 端传递到 Bedrock 服务器的显示界面; |
| 从 Java 端传递玩家数量; |
|
|
| 加载 GeyserIntegratedPack; |
限制
由于该插件是在两款不同游戏之间转换协议,Java 版的一些功能无法在 Bedrock 端重现:聊天中的可点击链接、实体的发光(glowing)效果、物品栏中左键与右键的区分、自定义附魔,以及铁砧和锻造台的自定义配方。Bedrock 玩家的移动无法被完美还原,因此在大型服务器上可能会被反作弊系统误判。
总结
Geyser 让 Bedrock 玩家无需为每个版本单独准备世界,即可通过手机、主机和 Windows 版同时进入 Java 服务器。与维护两个并行服务器不同,代理让所有人处于同一个世界中,并传递 MOTD、皮肤和表单。不过,Java 版的部分机制在 Bedrock 端会被简化或无法使用,移动方式也并不总能与反作弊系统很好地兼容。该插件适合希望向 Bedrock 玩家群体开放的服务器;搭配 Floodgate 使用,还能接纳没有 Java 账户的玩家。
安装
一次典型安装大约 5 分钟。流程相同,只是 Loader 和对应构建不同。
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.











