Troubleshooting

This page covers errors casually reported by users and how to resolve them.

Setup

Access proxy running on localhost

When binding the proxy to localhost, windows enforces program restrictions preventing minecraft from accessing the server. These restrictions can be lifted by running the following command in an administrator shell

CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftUWP_8wekyb3d8bbwe"

Wrong java version

The following error can be observed if you start WaterdogPE with the wrong java version:

Exception in thread "main" java.lang.UnsupportedClassVersionError: dev/waterdog/WaterdogPE has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

This happens when you try to run WaterdogPE using Java 8, meanwhile WaterdogPE is built using Java 11. To resolve this, run it using Java 11.

"You need to authenticate to Microsoft services"

This issue usually occurs when a user is either not logged into XBox Live and the proxy has online-mode enabled or the downstream server has online-mode enabled.

To resolve this, make sure you are signed in to Xbox Live in Minecraft and that all your downstream servers have the "xbox-auth" option disabled.

"XUID does not match"

Because of a security vulnerability which users could use to join with the same XBox username like an already existing one, server softwares like PocketMine-MP compare the XUID to the account name. An account won't be able to join if the XUID mismatches with a previous XUID.

To resolve this issue, delete the .dat file of that player or set the "player.verify-xuid" option in your pocketmine.yml to false.

That should look like this:

player:
  verify-xuid: false