问题

已知问题和注意事项

如果您遇到的问题没有在这里列出，请考虑加入 Geyser 的 Discord频道。

运行指令时出错

在某些情况下（例如，如果您将 Floodgate 的配置的 username-prefix 选项设置为 *），则在运行指令时可能需要将基岩版玩家的用户名用引号括起来；例如：/tp "*homo114514"。同时，将基岩版玩家的前缀设置为 . 也能解决该问题。

If you wish to use IP forwarding, please enable it in your BungeeCord config as well!

很可能您在 Floodgate 配置中启用了 send-floodgate-data，但是您没有将 Floodgate 生成的密钥文件复制到所有子服的 Floodgate 文件夹中，或者您的 各个子服的密钥文件不一致（请一次性复制它们，以便它们都使用相同的密钥）。

java.lang.IllegalStateException: Cannot reply to EncryptionRequestPacket without profile and access token.

确保服务器正确安装了 Floodgate 并启动，如果这不能解决你的问题，请查看下面报错的解决方案。

javax.crypto.AEADBadTagException: Tag mismatch!

如果 Geyser 和 Floodgate 在同一个服务器上，请关闭您的服务器，删除服务器中的 floodgate 插件文件夹并删除服务器中的 Geyser 文件夹中的所有密钥文件，然后重新启动您的服务器。 如果 Geyser 和 Floodgate 不在同一台服务器上，并且您必须复制 Floodgate 的密钥文件到 Geyser 文件夹内，如果你已上传，这也可能是与 通过FTP上传 相关的错误。使用ASCII在这里不起作用，并且您需要确保在上传时使用二进制文件。如果您使用 FTP 进行文件传输，我们建议使用 WinSCP。

java.lang.NumberFormatException: For input string: ""

您尝试在没有 Xbox帐户 的情况下登录。Floodgate 需要一个 Xbox帐户 来验证基岩玩家。如果您已登录，则重新启动客户端再试。

Geyser-Floodgate:51777 lost connection: Internal Exception: java.lang.NumberFormatException: For input string: "SfqdXv36" (or a similar error)

将 BungeeCord 配置中的ip-forwarding 设置为 true。

在连接时提示 "请从官方Geyser连接"（Please connect through the official Geyser）

请确保 Floodgate 和 Geyser 的版本都是最新版本的。

即使修改了配置，前缀也没加到基岩版玩家名字中

在 Paper 的 1.15.2-355 和 1.16.5-505 的构建之间，有一个错误，即已经连接到服务器的 Floodgate 玩家不会修改他们的前缀。Paper build1.16.5-506 及更高版本修复了此问题。

同时确保您删除了服务端根目录下的 usercache.json 文件并重新启动您的服务器。

使用 LuckPerms 时玩家的前缀出现错误

在 LuckPerms 的配置中设置 allow-invalid-usernames 为 true。

在混合 Forge 或者 Farbic 的 Bukkit 系服务端上出现错误

目前，没有办法在混合Forge和Bukkit或Fabric和Bukkit的服务器上运行Floodgate（例如：Magma，Mohist和Cardboard/Bukkit4Fabric）-大多数混合端不支持我们需要做的复杂程序，以便让基岩版玩家连接 (对于有技术头脑的人来说：这些服务器软件通常不支持NMS)。

如果您希望将Floodgate与混合服务器结合使用，我们建议将这些服务器放在BungeeCord或Velocity代理后面，并在代理上运行Floodgate。