This page details the various configuration settings exposed by Waterfall. These settings can be found in waterfall.yml.

If you want information on settings in BungeeCord’s config.yml you should see its respective documentation pages.


Configuration values change frequently at times. It is possible for the information here to be incomplete. If you cannot find what you’re looking for or think something may be wrong, Contact Us

Last updated October 4th, 2020 for Waterfall build #379


  • default: true

  • description: Sets whether Netty’s async DNS resolver is used for account authentication.


  • default: true

  • description: Disables the tab completion limit for 1.13+ clients.


  • default: true

  • description: Sets whether to log InitialHandler connections.


  • tab_complete
    • default: 1000

    • description: How often tab-complete packets can be sent in milliseconds.


  • default: ‘ ‘ (empty string)

  • description: The supported versions displayed to the client. Default is a comma separated list of supported versions. For example 1.8.x, 1.9.x, 1.10.x


  • default: false

  • description: This setting disables entity metadata rewriting in favor of sending a join packet to the client. It offers a more robust solution for modded environments but can cause plugins to break.


  • default: false

  • description: This setting disables tablist rewriting, which may resolve issues setting player profiles when Waterfall is in offline mode.