Skip to content

Configuration

Mickey42302 edited this page Jun 19, 2026 · 3 revisions

Waterfall-CTD provides additional settings which can be configured using the "waterfall.yml" file.

Boolean:

use_netty_dns_resolver (default: true): Sets whether Netty”s async DNS resolver should be used for account authentication.

disable_modern_tab_limiter (default: true): Disables the tab completion limit for 1.13+ clients.

log_initial_handler_connections (default: true): Sets whether to log InitialHandler connections.

disable_tab_list_rewrite (default: true): This setting disables tablist rewriting, which may resolve issues setting player profiles when Waterfall-CTD is in offline mode.

disable_entity_metadata_rewrite (default: false): 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.

callback_permission (default: false): Sets whether the "waterfall.command.callback" permission can be used to control access to "/waterfall:callback".

callback_output (default: false): Sets whether the "waterfall.command.callback.output" permission can be used for troubleshooting "/waterfall:callback".

Numerical:

throttling (default: 1000): How often tab-complete packets can be sent in milliseconds.

plugin_channel_name_limit (default: 128): The maximum channel identifier length. May be useful for certain broken mods.

registered_plugin_channels_limit (default: 128): The maximum number of registered plugin channels for a connection. Used by mods and some plugins. May be useful to fix certain broken modpacks.

Other:

game-version (default: empty): This can be used to customise what supported versions of Java Edition are display to a client. The syntax for this option is a comma separated list of supported versions (example: 1.19.x, 1.20.x, 1.21.x).

Clone this wiki locally