常见问题解答
一般问题
在这里你可以找到关于 Geyser 的常见问题答案——如果你有问题没有找到答案，欢迎在我们的 Discord 中提问！
它是如何工作的？
Geyser 作为一个翻译器工作，将传入和传出的数据包都翻译成客户端和服务器都能理解的格式。也就是说，它模拟了一个 Minecraft: Java Edition 客户端，所以服务器实际上认为你是从 Java 版加入的。无论服务器是什么或安装了什么插件，你都可以使用 Geyser 加入它（只要服务器支持最新的原版（未修改的）Minecraft 版本）。
那么，红石是如何工作的？
红石以及命令、农场等其他机制将与 Java 版完全一样工作，因为加入的是 Java 版服务器，而 Geyser 不会修改服务器行为。
Geyser 是付费的吗？
不，Geyser 和所有相关项目都是完全免费且开源的，采用 MIT 许可证授权。
哪些插件与 Geyser 不兼容？
Geyser 通常与插件配合良好，因为我们模拟的是 Java 客户端。但也有一些例外：
Floodgate 可能会导致插件问题，因为它修改了登录流程。请注意，任何离线模式验证器插件仅在此处用于文档记录；Geyser 不支持离线模式使用。
- DynamicBungeeAuth 目前在最新版本 10.28B+ 上正常工作（10.27B 及更早版本会导致基岩版玩家凭据无效）
- FastLogin 不允许 Floodgate 添加玩家前缀。
- ExploitFixer 认为 Floodgate 用户是 UUID 欺骗——在 ExploitFixer 的配置中禁用
uuidspoof设置。 - JPremium 会更改玩家的 UUID，导致 Floodgate 无法从其映射中获取基岩版数据。
- LibHatesMods 导致身份验证失败，错误为
com.github.steveice10.mc.auth.exception.request.InvalidCredentialsException - ProtocolSupport
目前与 Floodgate 不兼容。可与 Floodgate 一起使用，但我们建议使用 ViaBackwards。 - ProtocolSupportBungee 会更改登录流程的工作方式，从而破坏 Floodgate 注入代码。
- SayNoToMcLeaks 会阻止 Floodgate 完成其登录系统。
如果你遇到更多问题，请通过 Discord 告知我们。
Geyser 支持哪些服务器版本？
请参阅 此页面 获取详细信息。
我需要哪个 Geyser 插件版本？
哪种类型的 Geyser 版本更好，独立版还是插件版？
由于优化可以挂钩到插件平台中，Geyser 的插件版本比独立版 Geyser 更优选。在 Spigot、Velocity、Fabric/NeoForge 和 BungeeCord 版本的 Geyser 上，直接连接允许更快的加载时间、更低的延迟和准确的 IP 地址，而无需 Floodgate。Geyser 在 Spigot、Fabric 和 NeoForge 上有进一步的优化，因为可以直接访问世界，包括更低的内存 使用和更高的翻译准确性。然而，大型服务器网络可能更喜欢独立版 Geyser，因为它可以在不需要重启任何其他代理或服务器的情况下进行更新，并且可以将资源使用转移到单独的机器上。
如果使用 BungeeCord 或其他分支，我需要把 Geyser/Floodgate 放在哪里？
只要不使用 Floodgate API，你只需要在 BungeeCord 服务器上安装 Geyser 和/或 Floodgate。在这种情况下，Floodgate 也需要安装在"后端"服务器上。
我需要给基岩版玩家什么 IP？
通常情况下，基岩版玩家加入的 IP 是你的 Java IP 和 Geyser 配置中 bedrock 部分下 port 定义的端口。例如，如果 Java 玩家加入的 IP 地址是 test.geysermc.org，而 bedrock port 设置为 19132，那么基岩版玩家应该使用 IP test.geysermc.org 和端口 19132 加入。
如何让基岩版玩家加载资源包？
基岩版玩家如何在副手中持有物品？
你可以使用命令 /geyser offhand，这将交换他们主手和副手中的物品。你还可以在配置中启用一个设置（emote-offhand-workaround），允许基岩版玩家执行表情动作来切换主手和副手。
使用 Floodgate 时如何在命令中包含玩家？
如果 Floodgate 玩家有前缀，你必须在名字中包含前缀。Floodgate 还会将名字中的所有空格替换为下划线，因此在执行命令时务必用下划线替换任何空格。如果这不起作用，请在名字周围加上双引号。
示例：/tp ".<bedrock_username>"
使用 Floodgate 时如何将玩家添加到白名单？
有三种方法可以做到这一点。
-
使用 Floodgate 的内置白名单命令：
/fwhitelist add <bedrock_username>。这仅在玩家已经加入过任何 Geyser 服务器时才有效。 -
使用
/whitelist off关闭白名单，然后让 Geyser 玩家加入。之后，运行/whitelist add ".<bedrock_username>"，最后使用/whitelist on重新开启白名单。 当使用本地链接时：如果你将基岩版账户链接到现有的已白名单 Java 账户，你不需要单独将基岩版账户加入白名单。你可以链接账户并立即重新开启白名单。 -
将 Floodgate 提供的玩家 UUID 添加到
whitelist.json文件中。然后运行/whitelist reload来更新白名单。
选择适合你的偏好和服务器设置的方法。
使用 Floodgate 时如何在玩家未加入的情况下找到他们的 UUID？
我可以移除 Floodgate 玩家的前缀吗？
虽然你可以移除前缀，但通常建议不要移除前缀，以防止两个版本的玩家用户名相同的情况（例如：基岩版用户名：JohnDoe，Java 版用户名：JohnDoe）。虽然他们有不同的 UUID，但他们有相同的用户名，这可能会导致涉及玩家名称的命令发生冲突。如果你想移除前缀以使用命令，尝试在名字周围加上引号。示例：/tp ".<bedrock_username>" 否则，前缀位于 Floodgate config.yml 中的 username-prefix: 下。
我需要使用 Floodgate 才能使用 Geyser 吗？
不需要；只有在你希望允许基岩版客户端无需验证即可加入 Java 服务器时才需要 Floodgate。如果没有 Floodgate 插件，Geyser 可以在在线模式下向 Mojang 验证，或者在离线模式服务器上无需验证即可加入（尽管这是不可支持且危险的，因为任何人都可以加入你的服务器，并且违反了 Mojang 的 EULA）。
有时候，当我走得很远时，世界开始出现非常奇怪的视觉错误……
这是一个基岩版客户端问题，由基岩版是 32 位而 Java 版是 64 位引起。有关更多信息，请阅读 此处。这可以使用 非官方 Geyser 扩展 来绕过，该扩展可以伪造玩家位置。
我可以使用 Geyser 允许 Java 玩家连接到我的基岩版服务器吗？
不，这是一个翻译工具，允许基岩版玩家连接到 Java 服务器。它不能反向工作。
我可以在 Pterodactyl Panel 上使用 Geyser 吗？
是的，你可以在 Pterodactyl 上运行的 Minecraft 服务器软件中将 Geyser 用作插件或模组。独立版也有一个官方 egg。它支持自动更新，并且所有配置选项都可以轻松编辑。你可以在 此处 找到它，下载 JSON egg，并将其导入到你的面板中。确保 Geyser 端口（使用 UDP）已导出到主机并为服务器分配了端口。
我可以使用 Ngrok 使用 Geyser 吗？
不幸的是，Ngrok 仅支持 TCP，因此你将无法使用 Ngrok 使用 Geyser。作为替代方案，你可以使用 playit.gg，它同时支持 TCP 和 UDP。
我如何设置 Cosmic Guard？
- 你需要访问主机系统的终端。注意：本指南仅适用于 Linux 系统！
- 设置一个"Guard"，选择 gaming 然后选择 Minecraft: Bedrock edition。
- 点击 linux 设置并运行 guardian 安装程序并启动服务。
- 运行 "guardian status" 并记下"Local IP"，它以 "10.31.x.x" 开头。
- 转到 Geyser config.yml 并将 Bedrock 地址更新为你在上面找到的 Local IP。
- 重启 mc 服务器并测试，它应该对 Java 和基岩版都有效。
我可以将 Geyser 连接到旧版服务器吗？
如果服务器有 ViaVersion 和/或支持最新的 Minecraft 版本，可以。但是，由于我们的 Java 支持库的限制，我们无法支持更旧版本的 Minecraft。
我可以将 Geyser 连接到模组（Forge/Fabric/NeoForge）服务器吗？
简短的回答：如果原版客户端可以加入服务器，那么 Geyser 也可以。
详细的回答：目前，Geyser 无法翻译大多数模组添加的功能（方块、物品等）。因此，需要客户端安装模组的服务器无法通过 Geyser 支持。
我如何自动更新 Geyser？
我如何让 DiscordSRV 显示 Floodgate 2.0 或 GeyserSkinManager 皮肤？
将 DiscordSRV 配置中的 AvatarUrl 行替换为：AvatarUrl: https://mc-heads.net/avatar/{texture}/{size}.png
注意：你需要运行 DiscordSRV v1.22.0 或更高版本。仍然需要 Floodgate 2.0 或 GeyserSkinRestorer 才能让皮肤显示给 Java 玩家并使其工作。
或者，如果你无法让上述 AvatarUrl 与 DiscordSRV 一起使用，或者你想将它与其他不支持纹理 ID 的插件一起使用，你可以使用 Starlight Skin API。
我可以使用 Buycraft（Tebex）与 Geyser 吗？
当然可以！Buycraft 通过离线商店模式支持 Java 和基岩版玩家 （建议与 Floodgate 一起使用）
（目前，Buycraft 不支持特殊符号如 * 或 -，因此你需要将 Floodgate 前缀更改为 _ 或完全移除它。）
创建商店以支持两个版本的步骤
- Buycraft-> 创建 Webstore
- 选择游戏-> Minecraft Offline
- 继续-> 点击"Create my Webstore"
- 命名你的服务器并选择货币-> 继续
- 选择游戏服务器-> 继续
- 下载最适合你服务器的插件版本。
- 从你的服务器控制台执行秘密命令
你的商店现在已设置好支持基岩版和 Java 玩家。
（请注意，如果你与 Floodgate 一起使用前缀，基岩版玩家必须输入前缀。）
我可以使用 CraftingStore 与 Geyser 吗？
是的，CraftingStore 与 Geyser 兼容。但是，如果你使用的 Floodgate 前缀不是 +，你需要禁用高级名称检查配置选项。
其他问题
这些其他常见问题与 Geyser 游戏玩法无关。
CubeCraft 和 Geyser 之间的关系是什么？
Redned 于 2019 年 7 月启动了 Geyser。2020 年 5 月，CubeCraft 收购了 GeyserMC 品牌。 这意味着他们管理该项目（尽管此时他们管理得比较轻松）。CubeCraft 不拥有 Geyser 的代码。
CubeCraft 使用 Geyser 吗？
不。他们有自己的基岩版服务器技术，你可以在 此处 找到更多信息。