Alpha Game Server Manager

Dedicated server guide

Minecraft Paper

Manage minecraft.paper 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: discordsrv, essentialsx, essentialsxantibuild, essentialsxchat, essentialsxprotect, essentialsxspawn, luckperms, placeholderapi, protocollib, vault, viabackwards, viarewind, viaversion. The optional discordsrv 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: discordsrv. Omit all optional mod steps for a base server.

  1. Start the Docker manager ./alphagsm-docker start
  2. Create the game instance ./alphagsm-docker my-minecraft-paper create minecraft.paper
  3. Complete interactive setup ./alphagsm-docker my-minecraft-paper setup
  4. Optional: add discordsrv # Optional curated mod: discordsrv; add discordsrv ./alphagsm-docker my-minecraft-paper mod add manifest discordsrv
  5. Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm-docker my-minecraft-paper mod apply
  6. Start the game server ./alphagsm-docker my-minecraft-paper start
  7. Check the instance status ./alphagsm-docker my-minecraft-paper status
./alphagsm-docker start
./alphagsm-docker my-minecraft-paper create minecraft.paper
./alphagsm-docker my-minecraft-paper setup
# Optional curated mod: discordsrv; add discordsrv
./alphagsm-docker my-minecraft-paper mod add manifest discordsrv
# Optional: apply the mod plan
./alphagsm-docker my-minecraft-paper mod apply
./alphagsm-docker my-minecraft-paper start
./alphagsm-docker my-minecraft-paper 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. Optional curated example: discordsrv. Omit all optional mod steps for a base server.

  1. Create the game instance ./alphagsm my-minecraft-paper create minecraft.paper
  2. Complete interactive setup ./alphagsm my-minecraft-paper setup
  3. Optional: add discordsrv # Optional curated mod: discordsrv; add discordsrv ./alphagsm my-minecraft-paper mod add manifest discordsrv
  4. Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm my-minecraft-paper mod apply
  5. Check the host prerequisites ./alphagsm my-minecraft-paper doctor
  6. Start the game server ./alphagsm my-minecraft-paper start
  7. Check the instance status ./alphagsm my-minecraft-paper status
./alphagsm my-minecraft-paper create minecraft.paper
./alphagsm my-minecraft-paper setup
# Optional curated mod: discordsrv; add discordsrv
./alphagsm my-minecraft-paper mod add manifest discordsrv
# Optional: apply the mod plan
./alphagsm my-minecraft-paper mod apply
./alphagsm my-minecraft-paper doctor
./alphagsm my-minecraft-paper start
./alphagsm my-minecraft-paper status

This guide covers the minecraft.paper module in AlphaGSM.

minecraft.paper 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 mypaper create minecraft.paper

Run setup:

alphagsm mypaper setup

Start it:

alphagsm mypaper start

Check it:

alphagsm mypaper status

Stop it:

alphagsm mypaper stop

Setup Details

Setup configures:

  • the game port (default 25565)
  • the install directory

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 mypaper update
alphagsm mypaper backup

Notes

  • Module name: minecraft.paper
  • Default port: 25565

Server variables

After create minecraft.paper, 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: paper.jar
  • Location: <install_dir>/paper.jar
  • Engine: Java (PaperMC)

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-paper/ if available

Maps and Mods

  • Map directory: world/
  • Mod directory: plugins/
  • Workshop support: No
  • Map notes: The world directory contains all world data. Delete it to regenerate.
  • Mod notes: AlphaGSM can install built-in manifest families such as viaversion, viabackwards, viarewind, luckperms, vault, placeholderapi, protocollib, essentialsx, essentialsxchat, essentialsxspawn, essentialsxprotect, essentialsxantibuild, and discordsrv, track direct plugin jar URLs for Paper, and install Mod DB-backed archives when they expose plugin payloads under approved plugin paths. The checked-in manifest now auto-installs ViaVersion and EssentialsX companion prerequisites when needed.

Plugin Sources

Paper plugin management is separate from other Minecraft variants.

  • AlphaGSM stores Paper plugin cache/state under .alphagsm/mods/minecraft-paper/ so it does not collide with vanilla, Bedrock, or proxy variants.
  • Current plugin source support includes manifest for checked-in reproducible plugin families, url for direct plugin .jar files, and moddb for canonical Mod DB page URLs that resolve to provider-hosted plugin archives.
  • AlphaGSM records installed plugin files per entry so mod cleanup removes only tracked plugins and leaves unrelated files alone.

Examples:

alphagsm mypaper mod add manifest viaversion
alphagsm mypaper mod add manifest viabackwards
alphagsm mypaper mod add manifest viarewind
alphagsm mypaper mod add manifest luckperms
alphagsm mypaper mod add manifest essentialsxchat
alphagsm mypaper mod add url https://plugins.example.invalid/TestPlugin.jar
alphagsm mypaper mod add moddb https://www.moddb.com/mods/paper-plugin-pack/downloads/paper-plugin-pack
alphagsm mypaper mod apply
alphagsm mypaper mod cleanup

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

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

Which runtimes can run Minecraft Paper?

Declared runtimes: Docker or a Linux host process.

Which ports does Minecraft Paper use?

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

Can I add mods to Minecraft Paper?

Declared curated families: discordsrv, essentialsx, essentialsxantibuild, essentialsxchat, essentialsxprotect, essentialsxspawn, luckperms, placeholderapi, protocollib, vault, viabackwards, viarewind, viaversion. The optional discordsrv example installs its dependencies and applies the mod plan before launch.

How should I back up Minecraft Paper?

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