Geyser

2026-01-01

java

一寸光阴一寸金,寸金难买寸光阴。——增广贤文

Geyser:让《我的世界》基岩版玩家直连 Java 服务器的那座桥

Geyser Banner

  • 官网:geysermc.org
  • 文档与指南:Wiki
  • 下载入口:Download
  • 测试服务器:test.geysermc.org(Java 端口 25565,基岩端口 19132
  • 社区交流:Discord
  • 许可证:MIT License
  • 开放协作:由 CubeCraft Games 发起开放合作
  • 特别致谢:向 DragonProxy 项目在协议翻译上的探索致敬

它到底在做什么?

一句话:Geyser 是一款“代理(Proxy)”,把《我的世界》基岩版(Bedrock Edition)玩家,桥接到 Java Edition 服务器上。
它的终极目标,是让基岩版玩家尽可能“无缝”地加入 Java 服务器,真正实现跨平台同玩。

换句话说,如果你运营的是 Java 服,但玩家手里只有基岩版客户端——Geyser 就是那座“能把他们接过来”的桥。


版本支持(实时更新以文档为准)

当前支持范围(以仓库 README 为准):

  • 基岩版:1.21.111 — 1.21.130
  • Java 版:1.21.11

更多细节、最新状态请看官方文档的“Supported Versions”:


快速上手怎么玩?


还差点什么?(待完善清单)

仓库的 README 里给了“还需改进的点”,比如:

  • 更接近“完美”的移动(尽量避免大服的反作弊误判)
  • 一些实体标志(Entity Flags)

此外,“有些差异是没法修”的(源于基岩与 Java 的底层差异)。具体请查看文档中的“当前限制”页面(在 Geyser Wiki 中)。


程序员专区:想自己构建?

README 提供了最基础的构建流程。直接上命令:

1
2
3
4
5
6
7
8
9
10
11
12
# 1. 克隆仓库
git clone https://github.com/GeyserMC/Geyser.git

# 2. 初始化子模块(必须)
cd Geyser
git submodule update --init --recursive

# 3. 构建
./gradlew build

# 4. 构建产物位置
# 在 bootstrap/build 目录里找

如果你想参与开发或试着做定制,强烈建议先加他们的 Discord:https://discord.gg/geysermc


小而美的“代码角”:命令就是最好的案例

Geyser 的核心是“代理与协议翻译”,它并不是给你一个“随手嵌代码的 SDK”。因此最真实的“代码案例”,其实就是工具链的构建与部署命令(来自 README):

1
2
3
4
5
6
7
# 拉取所有子模块(这一步非常关键)
git submodule update --init --recursive

# Gradle 一键打包
gradlew build

# 构建完成后,到 bootstrap/build 里查看

如果你运营 Java 服务器,Geyser通常与服务端生态一起部署(如常见代理与服务端环境),详细的服主向操作与兼容策略请以官方 Wiki 为准。


社区与贡献


背后的技术拼图

仓库中列出的关键依赖:

它们构成了“翻译协议 + 稳定输出 + 多语言日志”的技术底座,支撑起跨平台桥接的能力。


为什么它值得被安利?

  • 让更多玩家“不再被客户端版本隔开”
  • 有明确的待完善项与公开限制,期待值管理合理
  • 开源(MIT),协作氛围好,文档入口清晰
  • 有测试服、下载站、Discord、捐助通道,生态完整

一些常见问答(超简版)

  • 能让所有差异完全消失吗?
    不行,基岩与 Java 的底层差异有些是不可避免的;但 Geyser 正在不断推进“尽可能无缝”的体验。
  • 版本支持是不是一直固定?
    会更新,查看 Supported Versions 页面获取最新信息。
  • 我可以上来就自己编译吗?
    可以,按 README 的步骤来;也可以直接从下载页拿构建好的版本。

最后,放上所有“必备链接”

愿所有基岩玩家都能轻松跨越到你心心念念的 Java 服务器,Enjoy!🎮🌉