Skip to content
Konicai edited this page Jun 7, 2021 · 14 revisions

Known Issues & Caveats

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

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/Fabric

At this time, there is no way to run Floodgate on a Forge or Fabric server - most Bukkit/Forge 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 Forge/Fabric, we recommend putting these servers behind BungeeCord or Velocity.