Setting Up WaterDog PE Proxy

WaterDog PE, as the name suggests, is bedrock edition proxy software. For Java Edition, check here.

🎥 Video Guide 🎥

📑 What You Will Need 📑

A server to install the proxy on.
2 or more servers to link to the proxy. Otherwise, it is pointless. These servers can be running any bedrock software, as long as it's compatible with having Xbox authentication (offline mode) disabled. This is needed for the proxy to work. Don't worry, the proxy will have Xbox authentication (online mode) turned on.

If you don't have enough servers, consider looking at our multiserver options.

💭 Terminology 💭

"backend servers" = The servers that are behind your proxy, which are what we want to be able to "fast transfer" between with a command.
"proxy" = The WaterDog PE server.

➕ Creating the Proxy ➕

Go to the server where you are going to use the WaterDog proxy, or create a new one with the WaterDog PE egg (gametype).



Once the server installation is complete, click on the server to be brought to its panel.



You may see that the server has started. Click the stop button to stop it for now. In the sidebar, go to the File Manager.



Open the config.yml file. This is where we enter all of the settings for the proxy, such as what servers to have as the backend ones.



In config.yml, find the section called servers, as this is where we enter our backend servers. This is what it looks like when we first install WaterDog PE:

servers:
  lobby1:
    address: localhost:19133
    public_address: play.myserver.com:19133
    server_type: bedrock

Go to your first backend server, such as your lobby, to get some information from it and change some settings.



The first thing we need to get is the server IP address and port. We can copy that to our clipboard by clicking on it from the panel's server information box.



Then, go to the File Manager on our server and head over to server.properties.



In the server.properties file, search for xbox-auth. Change it from xbox-auth=on to xbox-auth=off.



Save the file and restart the server to apply the changes. Repeat this for all the servers that you want to add to your proxy.

✅ Verify You've Set It Up Correctly ✅

You should have:

Server IP (51.77.114.128:19192) (multiple IPs if you are adding them).
Disabled Xbox authentication on all of your servers that you want to add to your proxy.
Restarted those servers for that change to take effect.

⚙️ Configuring the Proxy ⚙️

Once you've done all this, go back to the proxy config.yml file and to the servers section. We are going to enter your first backend server's information.

servers:
  server1:
    address: 51.77.114.128:19192
    public_address: 51.77.114.128:19192
    server_type: bedrock

If you have a domain, for example, witherhosting.com, then you could put that in place of the IP and port in public_address. For example:

servers:
  server1:
    address: 51.77.114.128:19192
    public_address: witherhosting.com:19192
    server_type: bedrock

To add multiple servers, simply copy another server section into servers and add the needed info. For example:

servers:
  server1:
    address: 51.77.114.128:19192
    public_address: 51.77.114.128:19192
    server_type: bedrock
  server2:
    address: 51.77.114.128:19193
    public_address: 51.77.114.128:19193
    server_type: bedrock

Another setting that may be useful for you is priorities (near the top of the file). This setting allows you to provide the name of the server as defined in the servers section that the proxy should put players on when they join the IP. For example, to make your hub server your first priority, then your survival server as your second priority, set it as:

priorities:
  - hub
  - survival

This will ensure that users attempt to connect to the hub at first, and if the hub isn't online, it will redirect them to the survival server.

Make sure to save the config file. We can now start the proxy and join it in Minecraft to see if it all works! If you added multiple servers, you can transfer between them with the /server <name> command! Make sure to connect with the proxy IP and port; otherwise, the proxy can't do its thing!

If you need any help, feel free to ask in #community-help on the Discord or ask in the live chat!

Updated on: 30/05/2024