This is a docker image of Waterfall a drop-in replacement for BungeeCord and is intended to be used as a frontend of a cluster of itzg/minecraft-server conatiners.

When using with the server image itzg/minecraft-server you can disable online mode, which is required by bungeecord, by setting ONLINE_MODE=FALSE, such as

docker run ... -e ONLINE_MODE=FALSE itzg/minecraft-server

Here is an example Docker Compose file.

• WATERFALL_JOB_ID=lastSuccessfulBuild

  The Jenkins job ID of the artifact to download and run and is used when deriving the default value of WATERFALL_JAR_URL

• WATERFALL_BASE_URL=https://papermc.io/ci/job/Waterfall

  Used to derive the default value of WATERFALL_JAR_URL

• WATERFALL_JAR_URL=${WATERFALL_BASE_URL}/${WATERFALL_JOB_ID}/artifact/Waterfall-Proxy/bootstrap/target/Waterfall.jar

  If set, can specify a custom, fully qualified URL of the Waterfall.jar

• MEMORY=512m

  The Java memory heap size to specify to the JVM.

• UID=1000

  Default is 1000, can be set to whatever you need.

• GID=1000

  Default is 1000, can be set to whatever you need.

• INIT_MEMORY=${MEMORY}

  Can be set to use a different initial heap size.

• MAX_MEMORY=${MEMORY}

  Can be set to use a different max heap size.

• JVM_OPTS

  Additional -X options to pass to the JVM.

• /server

  The working directory where Waterfall is started. This is the directory where its config.yml will be loaded.

• /plugins

  Plugins will be copied across from this directory before the server is started.

• /config

  The /config/config.yml file in this volume will be copied accross on startup if it is newer than the config in /server/config.yml.

• 25577

  The listening port of Waterfall, which you will typically want to port map to the standard Minecraft server port of 25565 using:

  -p 25565:25577
  

Waterfall Configuration Guide

This image may be run as a non-root user but does require an attached /server volume that is writable by that uid, such as:

docker run ... -u $uid -v $(pwd)/data:/server loudsoftware/docker-waterfall