Dedicated server guide

BungeeCord

Manage minecraft.bungeecord 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

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

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-bungeecord create minecraft.bungeecord
Complete interactive setup ./alphagsm-docker my-minecraft-bungeecord setup
Optional: add geyser # Optional curated mod: geyser; add geyser ./alphagsm-docker my-minecraft-bungeecord mod add manifest geyser
Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm-docker my-minecraft-bungeecord mod apply
Start the game server ./alphagsm-docker my-minecraft-bungeecord start
Check the instance status ./alphagsm-docker my-minecraft-bungeecord status

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

Host process

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

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

This guide covers the minecraft.bungeecord module in AlphaGSM.

minecraft.bungeecord 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 17 or compatible runtime
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mybungeeco create minecraft.bungeecord

Run setup:

alphagsm mybungeeco setup

Start it:

alphagsm mybungeeco start

Check it:

alphagsm mybungeeco status

Stop it:

alphagsm mybungeeco stop

Setup Details

Setup configures:

the game port (default 25565)
the install directory
downloads the BungeeCord proxy jar automatically

Useful Commands

alphagsm mybungeeco update
alphagsm mybungeeco backup

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

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

Notes

Module name: minecraft.bungeecord
Default port: 25565

Server variables

After create minecraft.bungeecord, 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: BungeeCord.jar
Location: <install_dir>/BungeeCord.jar
Engine: Java (BungeeCord proxy)

Server Configuration

Config file: config.yml
Key settings (in config.yml):
- listeners[0].host — Proxy bind host and port
- listeners[0].motd — Message of the day
- listeners[0].max_players — Maximum players shown in server ping
- servers — Downstream backend server definitions
- motd — Message of the day
- online-mode — Mojang authentication
Template: See server-templates/minecraft-bungeecord/ if available

By default AlphaGSM resolves the latest successful upstream BungeeCord Jenkins build and downloads BungeeCord.jar automatically during setup. You can also override that with --version <build-number> or --url <jar-url>.

Maps and Mods

Map directory: N/A (proxy)
Mod directory: plugins/
Workshop support: No
Map notes: BungeeCord 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. BungeeCord keeps its own cache/state under .alphagsm/mods/minecraft-bungeecord/.

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 BungeeCord?

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

Which runtimes can run BungeeCord?

Declared runtimes: Docker or a Linux host process.

Which ports does BungeeCord use?

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

Can I add mods to BungeeCord?

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 BungeeCord?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

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