25% OFF First Invoice

Code at Checkout: APEX25

Minecraft Waterfall Server Guide

Last modified on Dec 23, 2021 in Modpacks

mc head By ApexHosting



Many servers host multiple game modes in a network configuration. This can only be done by using a proxy and hooking all of your backend servers into it. This allows for load balancing your playerbase and prevents file conflicts when trying to run different game modes on one server. One main software that server owners use for proxy servers is called Bungeecord.

While Bungeecord may work well for some, others may need a more robust and stable version of a proxy software. This is where Waterfall comes into play. Waterfall is another alternative you can use for your proxy server software. This software is made by the same team that develops Paper! Waterfall aims to bring stability, scalability, and more features to your proxy server. In this guide we will go over how you can install Waterfall to your proxy server.

How to Install Waterfall

One amazing thing about Waterfall is that it is hot swappable with bungeecord. If you already have your bungeecord configured you can simply switch to Waterfall with no issues. If you have not configured bungeecord before we recommend taking a look at the configuration guide here

To install Waterfall on your Apex server follow these steps:

  1. Head to the Apex control panel and stop your server.
  2. Locate the JAR File dropdown on your Multicraft Panel.
  3. Select the dropdown menu and search for Waterfall and select it. It may ask to reset the world, you select either as proxies do not load worlds.
  4. Once selected, restart the server to let the change apply.

Once this is done your server should be running Waterfall! If you had bungeecord already set up you should not need to reconfigure anything.

Waterfall Features

Waterfall has a few great configuration settings that it brings when installed. These settings will be located inside of the new waterfall.yml file found on the server.

use_netty_dns_resolver: true
disable_modern_tab_limiter: true
log_initial_handler_connections: true
  tab_complete: 1000
game_version: ''
disable_tab_list_rewrite: false
disable_entity_metadata_rewrite: false

This sets whether Netty’s async DNS resolver is used for account authentication or not. By default this will be set to true.

This setting will disable the tab completion limit that is in place for clients in 1.13+. By default this setting is set to true.

This will set whether or not to log InitialHandler connections to the server. By default this is set to true.

The game version setting will allow you to set what are the supported versions that display to the client. The default is just a separated list of supported versions that the software detects on the server. An example of this would be: 1.14.x, 1.15.x, 1.16.x

This setting will disable entity metadata rewriting in favor of sending a join packet to the client. This is a more robust solution for modded environments but may also break plugins. By default this is set to false.

This will disable tablist rewriting. This may help resolve issues setting player profiles when Waterfall is in offline mode. By default this is set to false.


Waterfall is an amazing option if you want a more robust stable version of a proxy software. With many extra settings and features that it brings it is a no brainer for any large networks that want to really dial in the perfect settings and provide a stable, scalable environment to work with. You can learn even more about this software and even contribute to the development by heading to this page.

How To Make a WaterFall Server With Apex Hosting

  1. Select your server package from our pricing page
  2. On the ‘Configure Your Server’ page, complete the required fields
  3. Under ‘Server Version’, select your version from the dropdown list
  4. Complete the order and your WaterFall server will be created instantly