Geyser 详解：Java 版与 Bedrock 版跨平台联机
Geyser 是一个转译层，让 Minecraft Bedrock 玩家能加入 Java 服务器。本文讲它怎么工作，以及同样重要的，它能给你什么、不能给你什么。
阅读约 4 分钟 · 更新于 2026年10月21日 · 作者：GuavaHost Team
最需要搞清楚的一件事：Geyser 服务器骨子里是一台 Java 服务器。Geyser 坐在中间，把 Bedrock 的网络语言翻译成 Java 的，好让 Bedrock 客户端能连上。它并不会把你的服务器变成 Bedrock 服务器。机器上真正运行的一切都是 Java。把这一点记住，大多数「为什么某某功能不管用」类的问题就自己有了答案。
Geyser 怎么工作
当一个 Bedrock 玩家连进来时，Geyser 把他们的数据包（游戏客户端和服务器之间来回发送的小块数据）翻译成 Java 的对应形式，再把 Java 服务器的回应翻译回 Bedrock。服务器以为自己在和一个 Java 玩家说话。Bedrock 玩家以为自己在一台 Bedrock 服务器上。Geyser 就是站在他们中间的那个翻译。
因为服务器逻辑百分之百是 Java 的，所以游戏规则、世界、插件和数据包全都是 Java 那一套。任何地方都没有在跑 Bedrock 的游戏引擎。
跨平台联机确实能给你什么
- Bedrock 玩家（手机、主机、Windows 10/11 版、平板）可以加入并在你的 Java 服务器上玩。手机、平板和 Windows 玩家通过 IP 和端口添加它。Xbox、PlayStation 和 Switch 没有添加服务器的按钮，所以主机玩家需要一个免费的变通方法，详见 在主机上玩 Bedrock。
- 他们看到的世界、建筑和其他玩家，和 Java 上的每个人完全相同。
- 那些真正改变游戏的 Java 插件和数据包对 Bedrock 玩家同样生效，因为那些行为是在服务器上运行的，而 Geyser 只是把结果展示出来。
- 搭配 Floodgate（Geyser 的配套组件）使用，这样 Bedrock 玩家不需要 Java 账号就能加入。如果 Floodgate 还没装，就按你装 Geyser 的方式把它作为插件放进 plugins 文件夹。
跨平台联机不能给你什么
这里就是大家容易踩空的地方。下面这些全都不管用，而且没有任何设置能把它们打开，因为它们属于 Bedrock 引擎的功能，而你的服务器是 Java 的：
- Bedrock 的行为包和 addon 不会起作用。 行为包是 Bedrock 添加自定义生物、物品和机制的方式。它们运行在 Bedrock 服务器内部。你的不是，所以它们在这里什么都不做。如果你想要所有人都能看到的自定义行为，那就必须做成 Java 插件或数据包（见下文）。
- Bedrock 资源包只影响外观，而且要放在一个特定的位置。 你可以把 Bedrock 资源包丢进 Geyser 的
packs文件夹，Bedrock 玩家就会看到那些材质、模型和音效。那纯粹是东西看起来什么样，不是它们怎么运作。它对游戏本身毫无改变。 - 纯 Java 的模组到不了 Bedrock 玩家那里。 像 Simple Voice Chat 这种是 Java 客户端模组。Bedrock 玩家跑的是普通的 Bedrock 应用，完全不支持模组，所以这类功能对他们来说就是不存在。不会崩溃，他们只是没有这个功能。
- 任何你想让所有人都看到的东西，都必须在服务器上运行。 如果一个功能只存在于一侧的客户端上，另一侧就看不到它。可靠的路子是把它做成 Java 插件或数据包，因为 Java 服务器是 Java 玩家和 Bedrock 玩家唯一真正都连着的那个东西。
一条简单的规则：如果行为在服务器上运行（Java 插件或数据包），人人都有。如果它只活在客户端上（Bedrock addon 或 Java 模组），另一侧就没有。
为 Bedrock 玩家设置自定义外观
如果你想通过 Geyser 给 Bedrock 玩家自定义材质：
- 在控制面板里打开你的服务器，转到 Files 标签。
- 找到你的 Geyser 配置文件夹，打开它里面的
packs文件夹。在 Spigot 或 Paper 服务器上，那通常是 plugins/Geyser-Spigot/packs。 - 点击 Upload files，把你的 Bedrock 资源包（通常是
.mcpack或.zip）上传到那个文件夹里。 - 用页面顶部的 Restart 按钮重启服务器，让 Geyser 识别到它。
- 用 Bedrock 加入，在提示时接受这个包。
请记住，这只会改变 Bedrock 玩家看到的东西。它不会添加物品、生物或机制。
故障排查
Bedrock 玩家连不上。 Bedrock 用的端口和 Java 不是同一个。你服务器页面顶部那个地址是 Java 的；Bedrock 端口列在服务器 Overview 上 Ports & network 卡片里的 Other ports 下面。确保 Bedrock 玩家用的是那个一字不差的端口，而不是默认的 19132。如果还是不行，就到 Console 标签里查看 Geyser 的启动消息，确认 Geyser 确实在运行。
我的 Bedrock addon 毫无作用。 这是预期之内的。Addon 和行为包属于 Bedrock 引擎的功能，而你的服务器是 Java 的。请把这个功能重新做成 Java 插件或数据包。
Bedrock 玩家拿不到资源包。 确认这个包在 Geyser 的 packs 文件夹里，而且你重启过服务器。有些为更新或更旧的 Bedrock 版本制作的包，如果和你服务器运行的版本对不上，就不会加载。
Bedrock 玩家被要求提供 Java 账号。 这通常意味着 Floodgate 没有配置好。正是 Floodgate 让 Bedrock 玩家不用 Java 登录就能加入。把 Floodgate 作为插件和 Geyser 装在一起，然后重启服务器。
还没搞定吗？来 discord.gg/GuavaHost 加入我们的 Discord，团队会帮你解决。
- geyser
- crossplay
- bedrock
- java
- minecraft
Host a Minecraft Geyser server From $3.99/mo, with instant setup and DDoS protection.
还是没解决？ 我们的团队 7x24 小时在线，随时解答你的问题。