Dedicated server guide

Minecraft Vanilla

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

No mod support is declared in this snapshot; review the game guide before adding mods.

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.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-minecraft-vanilla create minecraft.vanilla
Complete interactive setup ./alphagsm-docker my-minecraft-vanilla setup
Start the game server ./alphagsm-docker my-minecraft-vanilla start
Check the instance status ./alphagsm-docker my-minecraft-vanilla status

./alphagsm-docker start
./alphagsm-docker my-minecraft-vanilla create minecraft.vanilla
./alphagsm-docker my-minecraft-vanilla setup
./alphagsm-docker my-minecraft-vanilla start
./alphagsm-docker my-minecraft-vanilla status

Host process

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.

Create the game instance ./alphagsm my-minecraft-vanilla create minecraft.vanilla
Complete interactive setup ./alphagsm my-minecraft-vanilla setup
Check the host prerequisites ./alphagsm my-minecraft-vanilla doctor
Start the game server ./alphagsm my-minecraft-vanilla start
Check the instance status ./alphagsm my-minecraft-vanilla status

./alphagsm my-minecraft-vanilla create minecraft.vanilla
./alphagsm my-minecraft-vanilla setup
./alphagsm my-minecraft-vanilla doctor
./alphagsm my-minecraft-vanilla start
./alphagsm my-minecraft-vanilla status

This guide is for running a normal vanilla Minecraft server with AlphaGSM.

minecraft.vanilla 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 Java-backed lifecycle stays aligned across both backends while local runs remain process-backed by default unless you opt into the Docker backend.

What You Need

Java 21 or another compatible Java runtime
screen
the Python packages in requirements.txt

Quick Start

Create the server:

alphagsm mymc create minecraft.vanilla

Run setup:

alphagsm mymc setup

Start it:

alphagsm mymc start

Check it:

alphagsm mymc status

Stop it:

alphagsm mymc stop

What Setup May Ask For

the Minecraft version
a download URL
the port
where to install the server
where Java is installed

Setup downloads the jar and writes the managed server.properties plus eula.txt when the EULA is accepted, without launching a temporary Java server. The first JVM is started by alphagsm <name> start, so setup cannot leave the game port occupied.

Resetting the World

Stop the server, then run alphagsm mymc reset-world (or wipe). AlphaGSM lists the world data to delete and asks for confirmation. Add -Y to skip the prompt. Run start afterwards to generate a fresh world.

See world creation and reset for exactly which files are removed and the supported layouts.

Useful Commands

alphagsm mymc message "hello world"
alphagsm mymc backup

Best Working Example

The best full example in the repository is:

tests/smoke_tests/run_minecraft_vanilla.sh

It uses this command flow:

alphagsm itmc create minecraft.vanilla
alphagsm itmc set javapath /path/to/java-wrapper.sh
alphagsm itmc setup -n -l PORT /tmp/minecraft-server -u SERVER_URL
alphagsm itmc start
alphagsm itmc status
alphagsm itmc message "hello world"
alphagsm itmc stop
alphagsm itmc status

Notes

minecraft is the short name people usually type.
minecraft.vanilla is the full module name.
If you want the most realistic example, follow the smoke test.

Server variables

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

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

Key	Aliases	Type	What it does
`difficulty`	—	string	The world difficulty. Example: `easy`.
`gamemode`	—	string	The default game mode. Example: `survival`.
`map`	gamemap, level, world, startmap, worldname	string	The selected world or level name. Example: `world`.
`maxplayers`	users	integer	The maximum number of players allowed on the server. Example: `20`.
`port`	gameport	integer	The port the server listens on. Example: `25565`.
`servername`	hostname, name	string	The server name shown in the client list. Example: `AlphaGSM Server`.

Developer Notes

Run File

Executable: minecraft_server.jar
Location: <install_dir>/minecraft_server.jar
Engine: Java (Mojang)

Server Configuration

Config file: server.properties
Key settings (in server.properties):
- server-port — 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-vanilla/ if available

Maps and Mods

Map directory: world/
Mod directory: Not supported (vanilla)
Workshop support: No
Map notes: The world directory contains all world data. Delete it to regenerate.
Mod notes: Vanilla servers do not support mods. Use Paper or Forge for mod support.

Configuration templates

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

server.properties

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

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

Which runtimes can run Minecraft Vanilla?

Declared runtimes: Docker or a Linux host process.

Which ports does Minecraft Vanilla use?

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

Can I add mods to Minecraft Vanilla?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up Minecraft Vanilla?

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