Issues

Known Issues & Caveats

If an issue you're experiencing is not listed here, please consider joining the Geyser Discord.

Running commands

In some instances, like if you have the username-prefix set to *, you may need to wrap the Bedrock player's username in quotes; for example: /tp "*BedrockPlayer". Setting the prefix to . should also fix this.

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

It is likely you have enabled send-floodgate-data in your Floodgate config but either Floodgate isn't installed on the target server, or you floodgate key isn't the same between the installs of the plugin (please copy them so they all use the same key).

Access token can not be null or empty

This may be because you forgot to set the auth-type in the config to floodgate. If that isn't it, check to make sure your config contains the line floodgate-key-file: public-key.pem. If not, just copy that in directly.

Invalid packet id:

This usually means one of two things:

• You did not follow the Floodgate instructions properly. However, in an unlikely scenario, this could also be an error related to uploading through FTP. Using ASCII will not work here, and you need to make sure you're on binary when uploading. We recommend using WinSCP if you need to use FTP.
• You're trying to log in without an Xbox account. Floodgate requires an Xbox account to authenticate the Bedrock player.

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

You're trying to log in without an Xbox account. Floodgate requires an Xbox account to authenticate the Bedrock player.

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

Set ip-forwarding in your BungeeCord to true.

Prefix is not changing on the server after changing it in the config.

Between the Paper builds of 1.15.2-355 and 1.16.5-505, there was a bug where Floodgate players who had already connected to the server would not have their prefixed changed. Paper builds 1.16.5-506 and later fix this issue.

Ensure that you removed the usercache.json file from the server root directory and restart your server.

Error with Forge or Fabric Bukkit Hybrid

At this time, there is no way to run Floodgate on servers that mix Forge and Bukkit or Fabric and Bukkit (For example: Magma, Mohist, and Cardboard/Bukkit4Fabric) - most hybrids do not support the complicated procedures we need to do in order to allow Bedrock players to connect (for the technically minded: these server softwares typically don't support NMS).

If you wish to use Floodgate in combination with hybrid servers, we recommend putting these servers behind a BungeeCord or Velocity proxy, and running Floodgate on the proxy.