Dedicated server guide

Minecraft Waterfall

Manage minecraft.waterfall with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Recorded lifecycle pass · Support evidence: 2026-10-16.

Build setup commands

Runtime familyjava

Declared runtimes: Docker or a Linux host process.

Network bindings

25565/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

Declared curated families: geyser, luckperms, viabackwards, viarewind, viaversion. The optional geyser example installs its dependencies and applies the mod plan before launch.

Backup hook

Backup hook support is unknown in this snapshot; review the game guide for backup and restore procedures.

Choose a supported runtime

Linux and Docker quickstart

Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup. Optional curated example: geyser. Omit all optional mod steps for a base server.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-minecraft-waterfall create minecraft.waterfall
Complete interactive setup ./alphagsm-docker my-minecraft-waterfall setup
Optional: add geyser # Optional curated mod: geyser; add geyser ./alphagsm-docker my-minecraft-waterfall mod add manifest geyser
Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm-docker my-minecraft-waterfall mod apply
Start the game server ./alphagsm-docker my-minecraft-waterfall start
Check the instance status ./alphagsm-docker my-minecraft-waterfall status

./alphagsm-docker start
./alphagsm-docker my-minecraft-waterfall create minecraft.waterfall
./alphagsm-docker my-minecraft-waterfall setup
# Optional curated mod: geyser; add geyser
./alphagsm-docker my-minecraft-waterfall mod add manifest geyser
# Optional: apply the mod plan
./alphagsm-docker my-minecraft-waterfall mod apply
./alphagsm-docker my-minecraft-waterfall start
./alphagsm-docker my-minecraft-waterfall status

Host process

Create the game instance ./alphagsm my-minecraft-waterfall create minecraft.waterfall
Complete interactive setup ./alphagsm my-minecraft-waterfall setup
Optional: add geyser # Optional curated mod: geyser; add geyser ./alphagsm my-minecraft-waterfall mod add manifest geyser
Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm my-minecraft-waterfall mod apply
Check the host prerequisites ./alphagsm my-minecraft-waterfall doctor
Start the game server ./alphagsm my-minecraft-waterfall start
Check the instance status ./alphagsm my-minecraft-waterfall status

./alphagsm my-minecraft-waterfall create minecraft.waterfall
./alphagsm my-minecraft-waterfall setup
# Optional curated mod: geyser; add geyser
./alphagsm my-minecraft-waterfall mod add manifest geyser
# Optional: apply the mod plan
./alphagsm my-minecraft-waterfall mod apply
./alphagsm my-minecraft-waterfall doctor
./alphagsm my-minecraft-waterfall start
./alphagsm my-minecraft-waterfall status

This guide covers the minecraft.waterfall module in AlphaGSM.

minecraft.waterfall is currently PASSED on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane still exercises both process and Docker runtime selection, and the validated Linux lifecycle stays aligned across both backends while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

screen
Java 21 or compatible runtime
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mywaterfal create minecraft.waterfall

Run setup:

alphagsm mywaterfal setup

Start it:

alphagsm mywaterfal start

Check it:

alphagsm mywaterfal status

Stop it:

alphagsm mywaterfal stop

Setup Details

Setup configures:

the game port (default 25565)
the install directory

Useful Commands

alphagsm mywaterfal update
alphagsm mywaterfal backup

Built-in manifest plugin families, direct plugin jars, and provider-hosted plugin archives can all be managed through AlphaGSM:

alphagsm mywaterfal mod add manifest viaversion
alphagsm mywaterfal mod add manifest viabackwards
alphagsm mywaterfal mod add manifest viarewind
alphagsm mywaterfal mod add manifest luckperms
alphagsm mywaterfal mod add manifest geyser
alphagsm mywaterfal mod add url https://plugins.example.invalid/TestPlugin.jar
alphagsm mywaterfal mod add moddb https://www.moddb.com/mods/proxy-pack/downloads/proxy-pack
alphagsm mywaterfal mod apply
alphagsm mywaterfal mod cleanup

Notes

Module name: minecraft.waterfall
Default port: 25565

Server variables

After create minecraft.waterfall, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE

This module does not declare schema-backed keys. set --list after create is still the live source of truth.

Developer Notes

Run File

Executable: waterfall.jar
Location: <install_dir>/waterfall.jar
Engine: Java (Waterfall proxy)

Server Configuration

Config file: config.yml. On first setup AlphaGSM waits for Waterfall to finish writing a usable listener configuration before applying the managed port.
Key settings (in config.yml):
- listeners[].host — Proxy listen address and port (default 25565)
- motd — Message of the day
- max-players — Maximum players
- level-seed — World generation seed
- online-mode — Mojang authentication
Template: See server-templates/minecraft-waterfall/ if available

Maps and Mods

Map directory: N/A (proxy)
Mod directory: plugins/
Workshop support: No
Map notes: Waterfall is a proxy and does not host worlds.
Mod notes: AlphaGSM can install built-in manifest families such as viaversion, viabackwards, viarewind, luckperms, and geyser, place plugin .jar files from direct URLs into plugins/, and install Mod DB-backed archives when they contain plugin payloads under approved proxy plugin paths. mod cleanup removes only AlphaGSM-managed plugin files. The checked-in manifest now auto-installs ViaVersion-stack prerequisites when needed and selects the Bungee-compatible jar for variant-specific families. Waterfall keeps its own cache/state under .alphagsm/mods/minecraft-waterfall/.

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Minecraft Waterfall?

Recorded lifecycle pass. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Which runtimes can run Minecraft Waterfall?

Declared runtimes: Docker or a Linux host process.

Which ports does Minecraft Waterfall use?

25565/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Minecraft Waterfall?

Declared curated families: geyser, luckperms, viabackwards, viarewind, viaversion. The optional geyser example installs its dependencies and applies the mod plan before launch.

How should I back up Minecraft Waterfall?

Backup hook support is unknown in this snapshot; review the game guide for backup and restore procedures.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides