Geyser 基岩版互通插件

Geyser 基岩版互通插件

> 让手机、主机、Windows 基岩版的玩家直接连进 Java 版服务器：一个协议翻译代理，把服务器的玩家池直接扩大一倍。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Geyser |
| 开发者 | GeyserMC 团队（Open Collaboration 项目）|
| 最新版本 | 2.11.3（build b1246，2026-09-23）|
| 许可协议 | MIT |
| 兼容版本 | 插件端 Spigot/Paper 1.20.5 – 26.2；Velocity/BungeeCord 与 Fabric/NeoForge 端跟随最新版本 |
| 运行平台 | Spigot、Paper、Velocity、BungeeCord/Waterfall、Fabric、NeoForge（另有独立运行版）|
| 支持客户端 | 基岩版 26.30 – 26.51 |
| 前置依赖 | 无（离线模式服务器需搭配 Floodgate）|
| 项目地址 | https://modrinth.com/plugin/geyser |
| 官方文档 | https://geysermc.org/wiki/geyser/ |
简介

Geyser 本质上是一个协议翻译代理：它把基岩版的网络协议翻译成 Java 版协议，让基岩版玩家以接近无缝的方式进入 Java 版服务器。对 Java 服主来说这是扩大玩家池最直接的手段——Java 版玩家不需要安装任何东西，服务端只需要多开一个 UDP 端口。

因为是两种不同游戏之间翻译数据包，官方明确提醒不要期待一切都能完美工作。目前主要遗留问题是移动表现还不够完美（大型服务器上反作弊可能误判基岩版玩家）以及部分实体标记（entity flags）尚未支持。另外，离线模式（盗版）服务器需要搭配 Floodgate，否则基岩版玩家会被要求登录 Java 账号。
核心特性
跨版本互通：基岩版玩家直接进入 Java 版服务器
多种形态：可作为 Paper/Spigot 插件、Velocity/BungeeCord 代理插件、Fabric/NeoForge 模组运行，也可独立运行
单向安装：Java 版玩家无需任何额外操作
版本跟进及时：当前构建支持基岩版 26.30 – 26.51
官方测试服：test.geysermc.org 可用于确认问题出在自己配置还是插件本身
离线模式适配：搭配 Floodgate 可实现基岩版免 Java 账号登录
MIT 许可：开放协作项目，文档与配置说明齐全
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Spigot/Paper（插件）、Velocity/BungeeCord（代理）、Fabric/NeoForge（模组）|
| Minecraft（Java）| 插件端 1.20.5 – 26.2，其它平台跟随各自最新版本 |
| 基岩版客户端 | 26.30 – 26.51 |
| 网络端口 | 需放行 UDP 19132（可自定义），与 Java 的 TCP 25565 互不影响 |
| 前置依赖 | 无；离线模式服务器建议搭配 Floodgate |
| Java 版本 | 以所装服务端要求的版本为准 |
安装方法
按服务端类型下载对应 jar（Geyser-Spigot.jar、Geyser-Velocity.jar、Geyser-BungeeCord.jar 等）
放入 plugins/（模组端放入 mods/），重启服务端
放行 UDP 19132 端口，云服务器还需在安全组中同样放行
按需修改生成出来的 config.yml（端口、MOTD、转发模式等）
用基岩版客户端连接 服务器IP:19132 验证
离线模式服务器再安装 Floodgate，让基岩版玩家免 Java 账号登录
使用提示
基岩版走 UDP 19132、Java 版走 TCP 25565，两个端口互不冲突，可以同时开
大型服务器的反作弊可能误判基岩版玩家（移动表现尚未完美），建议为基岩版玩家单独放宽判定
基岩版客户端不加载 Java 版材质包，依赖材质包的自定义界面、模型在基岩版玩家眼中不会生效
官方强调"不要期待一切完美"，重要功能建议先在测试环境验证再上正式服
离线模式（盗版）服务器不装 Floodgate 的话，基岩版玩家会被卡在登录环节
拿不准是插件问题还是自己的配置问题时，可先用官方测试服对照
相关链接
Modrinth 项目页：https://modrinth.com/plugin/geyser
官方网站：https://geysermc.org
官方文档（安装与配置）：https://geysermc.org/wiki/geyser/
支持版本说明：https://geysermc.org/wiki/geyser/supported-versions/
Floodgate（离线模式必需）：https://modrinth.com/plugin/floodgate
Discord 社区：https://discord.gg/geysermc
源码仓库：https://github.com/GeyserMC/Geyser