Geyser

介绍

Geyser 是连接 Java版和基岩版 的一座桥梁。

在最新版本下，Geyser 支持 Minecraft基岩版 1.17.30-1.17.41 + 1.18-1.18.02 和 Minecraft Java版 1.18-1.18.1。

Geyser 旨在为 Java版和基岩版 之间建立一座桥梁，使得基岩版客户端加入Java版服务器。该项目仍在开发中，所以仍有 BUG 存在！

​

常见问题

Geyser 是如何工作的？

Geyser 像一个翻译官那样工作，将传入和传出的数据包翻译为客户端和服务端（服务器） 都能理解的格式。这样说来，它模拟了 Minecraft Java版 客户端，因此服务器实际上认为您是从 Java版本 加入的。无论是什么服务器以及它安装了什么插件，您都可以将其与 Geyser 连接（只要服务器支持最新的Minecraft版本）。

红石是按照哪个版本工作的？

红石，还有 指令、农场 等各种机制都是按照 Java版 工作的。因为你加入的服务器是一个 Java版 服务器。

Geyser 是付费的吗?

不，Geyser 和 它的相关一切作品 都是 免费且开源的，且遵循 MIT 协议。

哪些插件不兼容 Geyser？

Geyser 应当和大部分 服务端插件 兼容，但总有例外，例如：

​ 如果你没有购买付费计划，需要关闭该插件的 only-allow-proxy-connections 选项。然而，如果你购买了付费计划，则无需担心，因为他们的付费计划有对 Geyser 添加额外支持。

Floodgate 与修改登录流程的插件不兼容。请务必注意以下各个支持离线登录的插件只是为了 Wiki 编写，Geyser 官方不对离线服务器提供帮助支持。

• 使得基岩版玩家生成无效的登录请求。

• 不让 Floodgate 为基岩版玩家添加前缀。

• 认为 Floodgate 玩家使用 恶意UUID - 请关闭该插件的 uuidspoof 配置。

• 改变 Floodgate 玩家的 UUID，导致 Floodgate API 等可能存在异常。

• 造成玩家无法登录，且报错： com.github.steveice10.mc.auth.exception.request.InvalidCredentialsException

• 虽然和 Floodgate兼容，但不推荐使用 。

• 破坏 Floodgate 玩家登录流程，导致 Floodgate API 等可能存在异常。

• 使得 Floodgate 玩家无法完成登录。

  如果你发现其他不兼容情况，可通过 联系我们。

我应该使用哪个版本的 插件版Geyser？

Geyser-Spigot 支持:

(推荐)

其他分支

• Geyser-Bungee 支持:

其他分支

• Geyser-Velocity 支持 ​

• Geyser-Sponge 支持 ​

Geyser-Spigot 支持什么版本?

支持 1.12.2 及更高版本。如果你的服务器比这个版本还低，请使用独立版。

如果我使用 BungeeCord，那么 Geyser/Floodgate 应该放置到哪?

你只需要在你的 BungeeCord 服务器安装 Geyser/Floodgate，这是在你的服务器不使用 Floodgate API 的情况下。如果不是这种情况，你还需要在每个子服都正确安装 Floodgate。

我应该给基岩版玩家什么 IP？

一般来说，如果你没有自己修改过，那么你的基岩版玩家连接你的服务器的IP应该和你的 Java版玩家 一样。至于端口，则根据你的 Geyser 配置下的 bedrock 下的 port 选项来决定。

我如何让基岩版玩家加载资源包？

你可以在 Geyser 下的 packs 文件夹放置资源包。基岩版客户端在加入服务器时会自动下载资源包。目前没有 Java-基岩 资源包自动转换 的功能，如果你需要转换资源包格式，请前往 并把转换好的资源包放置在 Geyser 内。

基岩版玩家如何副手拿物品？

你可以使用指令 /geyser offhand 来进行 主手和副手 的切换。你也可以通过修改 Geyser 下的配置 (emote-offhand-workaround) 来使得基岩版通过游戏里的 表情 按钮来进行 主手和副手 的切换。

在使用 Floodgate 时，执行指令的玩家变量是什么？

如果基岩版玩家有前缀，所有指令的 必须 在名称中 包含该前缀 。Floodgate 还将名称中的所有 空格 替换为 下划线 ，因此在执行命令时请务必将所有空格替换为下划线。 如果这不起作用，请在名称周围加上双引号。

示例: /tp “.<基岩版玩家>”。

在使用 Floodgate 时，我该如何添加基岩版玩家到白名单内？

您可以通过三种方式执行此操作。 第一种方法是使用 Floodgate 的内置白名单命令，/fwhitelist add .<基岩版玩家>。 第二种方法是执行 /whitelist off 关闭白名单，然后让基岩版玩家加入，然后执行 /whitelist add “.<基岩版玩家>”指令，最后执行 /whitelist on 重新打开白名单。 ( 如果你使用了基岩版和Java版账号连接功能，那么你无需再为基岩版玩家设置白名单，在 Java版 玩家尝试申请连接后，对应的基岩版玩家的游戏ID会被立即给予白名单 ) 第三种方法是添加基岩版玩家的 UUID ( 由 Floodgate 生成 ) 添加到 whitelist.json 文件，然后执行 /whitelist reload 命令。

当使用 Floodgate 时，如何实现在玩家没有加入服务器的情况下查看他们的 UUID？

请尝试下面这个方法：

首先，您需要获取基岩玩家的 XUID。 有几个第三方网站可以找到这个，例如 （与 Geyser 无关）。确保选择“十六进制”。 您需要输入玩家的 Xbox 名，并且一旦提交，它应该以 xxxxxxxxxxxxxxxx 的格式显示 XUID。 要把XUID变成Java版可以识别的UUID，需要把XUID写成这样的格式：00000000-0000-0000-xxxx-xxxxxxxxxxxx。如果格式正确，Java 版应该可以识别它并作为 UUID。

在使用 Floodgate 时，我能删除基岩玩家的前缀吗?​

虽然您可以删除基岩版玩家前缀，但通常建议 不要删除 它，因为这可以防止出现两个版本中 玩家名称相同 的情况（例如：基岩版玩家名称：DJelly4K，Java 版玩家名称：DJelly4K）。由于 Floodgate 与 Java版服务端 的 UUID 生成规则不同，这导致虽然他们具有不同的 UUID，但是他们都有相同的游戏名称，从而可能造成 涉及玩家名称的指令 发生 冲突。如果尝试删除基岩版玩家前缀只是为了使用指令，请尝试在游戏名称两边添加引号。示例：/tp “.<基岩版玩家>”。如果你执意要删除，那么基岩版玩家前缀的配置在 Floodgate 文件夹内的 config.yml 文件中的 username-prefix: 下，你可以将其修改为 “” 以删除。

要使用 Geyser 就必须安装 Floodgate 吗？

不。当你的服务器是 正版服务器 但你不希望基岩版玩家也需要 Java版正版账号 登录，那么这时你可以通过安装 Floodgate 实现这一愿望。但是如果你是正版服务器且也想要让基岩版玩家必须使用 Java 版正版账号或者你是盗版服务器，那么 Floodgate 不是强制需要你去安装的。

有时，世界跑的很远以后客户端会很卡.

这是 基岩版 客户端的问题。

我可以使用 Geyser 使得 Java 版玩家进入基岩版服务器吗?

不，Geyser 只是一个使得 基岩版玩家加入Java版服务器 的工具，你是怎么想到反着来也可以的？

我可以通过 Geyser 连接一个旧版本的服务器吗？

< a name="如果这个服务器安装了 ViaVersion 或者通过其他方法支持最新的 Minecraft 版本，那么，是的，你可以！但是，我们 不推荐 这么做！" class="reference-link" href="#">如果这个服务器安装了 ViaVersion 或者通过其他方法支持最新的 Minecraft 版本，那么，是的，你可以！但是，我们 不推荐 这么做！

我可以通过 Geyser 连接一个 Mod (Forge/Fabric) 服务器吗？

简单来说，如果你的服务器没有安装任何 客户端Mod，那么是可以的。

换句话说，如果你的服务器有 客户端Mod，那么 Geyser 目前无法翻译 Mod 所新增的 一切物品、方块等，因此，也就不受支持了。

如何实现自动更新 Geyser？

GeyserUpdater (/) 是一个 Spigot/BungeeCord 插件，通过 插件 更新 Geyser 也是一个不错的方法。请注意这个插件同样不是 Geyser官方的项目，如果你需要支持，请联系他们的 。

Geyser 支持哪些语言？

我们支持所有 基岩版 本身支持的语言。 这里以查看我们的 Crowdin 页面。下面是所有语言和其对应的代码。我们同时也对基岩版本身不提供支持的语言提供额外支持，你可以在下面查看。 (客户端语言调整请查看 )