How to setup a WaterdogPE proxy
WaterDog PE, as the name implies, is bedrock edtion proxy software. For Java Edition, check here
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, aslong as its compatible with having xbox auth (offline mode), disabled. This is needed for the proxy to work. Don't worry, the proxy will have xbox auth (online mode) turned on.
If you don't have enough servers, consider looking at our multiserver options.
"backend servers" = The servers that are behind your proxy, that are what we want to be able to "fast transfer" between with a command.
"proxy" = The WaterdogPE server.
Go to the server that you are going to use for the Waterdog proxy, or create a new one with the Waterdog PE egg (gametype).
Once the server has completed the install, click on the server, to be brought to the panel for it.
You may see that the server has started, we can just click the stop button to stop it for now. At the side bar, go to the File Manager.
Open up 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 we are mainly looking for 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:
Go to your first backend server, for eg, your lobby, as we will need to get some infomation from it, and change some settings in it.
The first thing that we will 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 infomation 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.And change it from xbox-auth=on to xbox-auth=off.
Then save the file with the blue button and restart the server to apply the changes. Repeat this for all the servers that you want to add to your proxy.
You should have:
Server IP (51.77.114.128:19192) (multiple IPs if you are adding them).
Disabled xbox-auth on all of your servers that you want to add to your proxy.
Restarted those servers for that change to take effect.
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 infomation.
If you have a domaim, for example, witherhosting.com, then you could put that inpalce of the IP and port in public_address. FOr example
But as I dont have a domain to demo, the server IP will be just fine there instead. To add multiple servers, simply copy another server section into servers and add the needed info. For example,
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
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!
🎥 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, aslong as its compatible with having xbox auth (offline mode), disabled. This is needed for the proxy to work. Don't worry, the proxy will have xbox auth (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, that are what we want to be able to "fast transfer" between with a command.
"proxy" = The WaterdogPE server.
➕ Creating the proxy ➕
Go to the server that you are going to use for the Waterdog proxy, or create a new one with the Waterdog PE egg (gametype).
Once the server has completed the install, click on the server, to be brought to the panel for it.
You may see that the server has started, we can just click the stop button to stop it for now. At the side bar, go to the File Manager.
Open up 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 we are mainly looking for 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: bedrockGo to your first backend server, for eg, your lobby, as we will need to get some infomation from it, and change some settings in it.
The first thing that we will 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 infomation 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.And change it from xbox-auth=on to xbox-auth=off.
Then save the file with the blue button 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-auth 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 infomation.
servers:
server1:
address: 51.77.114.128:19192
public_address: 51.77.114.128:19192
server_type: bedrockIf you have a domaim, for example, witherhosting.com, then you could put that inpalce 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: bedrockBut as I dont have a domain to demo, the server IP will be just fine there instead. 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: bedrockAnother 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
- survivalThis 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: 27/04/2023
Thank you!