Dedicated server guide

Minecraft Velocity

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

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

Host process

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

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

This guide covers the minecraft.velocity module in AlphaGSM.

minecraft.velocity 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 25 for Velocity 4.x/current releases; Java 21 for Velocity 3.x
Python packages from requirements.txt

Docker selects Java from the installed Velocity version, independently of the Minecraft game version. An explicit java_major setting takes precedence. The Java 25 selection fix is awaiting replacement GitHub CI validation.

Quick Start

Create the server:

alphagsm myvelocity create minecraft.velocity

Run setup:

alphagsm myvelocity setup

Start it:

alphagsm myvelocity start

Check it:

alphagsm myvelocity status

Stop it:

alphagsm myvelocity stop

Setup Details

Setup configures:

the game port (default 25565)
the install directory

On first setup, AlphaGSM starts Velocity briefly to generate velocity.toml and then writes the selected port to its bind setting. It does not create or require BungeeCord's config.yml.

Useful Commands

alphagsm myvelocity update
alphagsm myvelocity backup

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

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

Notes

Module name: minecraft.velocity
Default port: 25565

Server variables

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

Server Configuration

Config file: velocity.toml
Key settings (in velocity.toml):
- bind — Listen address and game 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-velocity/ if available

Maps and Mods

Map directory: N/A (proxy)
Mod directory: plugins/
Workshop support: No
Map notes: Velocity 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 Velocity-compatible jar for variant-specific families. Velocity keeps its own cache/state under .alphagsm/mods/minecraft-velocity/.

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

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

Which runtimes can run Minecraft Velocity?

Declared runtimes: Docker or a Linux host process.

Which ports does Minecraft Velocity use?

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

Can I add mods to Minecraft Velocity?

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

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