Alpha Game Server Manager

Dedicated server guide

Unreal Tournament 99

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

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

Build setup commands
Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

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

Mods and plugins

Mod support is declared; review the game guide for its providers and activation requirements.

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.

  1. Start the Docker manager ./alphagsm-docker start
  2. Create the game instance ./alphagsm-docker my-ut99server create ut99server
  3. Complete interactive setup ./alphagsm-docker my-ut99server setup
  4. Start the game server ./alphagsm-docker my-ut99server start
  5. Check the instance status ./alphagsm-docker my-ut99server status
./alphagsm-docker start
./alphagsm-docker my-ut99server create ut99server
./alphagsm-docker my-ut99server setup
./alphagsm-docker my-ut99server start
./alphagsm-docker my-ut99server 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.

  1. Create the game instance ./alphagsm my-ut99server create ut99server
  2. Complete interactive setup ./alphagsm my-ut99server setup
  3. Check the host prerequisites ./alphagsm my-ut99server doctor
  4. Start the game server ./alphagsm my-ut99server start
  5. Check the instance status ./alphagsm my-ut99server status
./alphagsm my-ut99server create ut99server
./alphagsm my-ut99server setup
./alphagsm my-ut99server doctor
./alphagsm my-ut99server start
./alphagsm my-ut99server status

This guide covers the ut99server module in AlphaGSM.

ut99server is currently PASSED in the checked-in support tracker on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane validates both process and Docker runtimes for this module, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

  • screen
  • 7z or 7zz (p7zip-full on Debian/Ubuntu)
  • Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myut99serv create ut99server

Run setup:

alphagsm myut99serv setup

Start it:

alphagsm myut99serv start

Check it:

alphagsm myut99serv status

Stop it:

alphagsm myut99serv stop

Setup Details

Setup configures:

  • the game port (default 7777)
  • the install directory
  • downloads and runs the OldUnreal Linux installer
  • accepts the Epic Games Terms of Service non-interactively for automated setup

Useful Commands

alphagsm myut99serv update
alphagsm myut99serv backup

Mod Sources

Unreal Tournament 99 content management currently targets the canonical custom content directories under the server root:

  • Maps/
  • Music/
  • Sounds/
  • Textures/

Current mod source support is direct url entries only.

  • mod add url <https-url> accepts supported archive URLs such as .zip, .7z, or tar variants when the payload unpacks into the approved UT99 content directories above.
  • mod add url <https-url> also accepts direct content-file URLs such as .unr, .utx, .uax, and .umx; AlphaGSM places each file into the matching canonical content directory automatically.
  • mod cleanup removes only AlphaGSM-tracked files and keeps its cache/state under .alphagsm/mods/ut99server/.
  • The first UT99 content slice intentionally excludes System/ payloads, code packages, and mutators; archives that require those paths are rejected instead of being partially installed.

Examples:

alphagsm myut99serv mod add url https://example.invalid/mappack.zip
alphagsm myut99serv mod add url https://example.invalid/DM-Deck-Test.unr
alphagsm myut99serv mod apply
alphagsm myut99serv mod cleanup

Notes

  • Module name: ut99server
  • Default port: 7777

Server variables

After create ut99server, 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: architecture-specific OldUnreal launcher
  • Typical amd64 location: <install_dir>/System64/ucc-bin-amd64
  • Compatibility wrapper: <install_dir>/System64/ucc-bin when present
  • Engine: Custom

Server Configuration

  • Config file: typically System64/UnrealTournament.ini on modern Linux installs
  • Max players: 16
  • Template: See server-templates/ut99server/ if available

Query and Info

  • alphagsm <server> query and alphagsm <server> info currently use generic UDP reachability
  • the screen log at alphagsm-home/logs/ is the best readiness signal for startup diagnostics

Maps and Mods

  • Map directory: Maps/
  • Mod directory: Maps/, Music/, Sounds/, Textures/
  • Mod notes: AlphaGSM can now track direct archive and direct content-file url entries for UT99, install only approved custom-content payloads, and clean up only AlphaGSM-managed files from .alphagsm/mods/ut99server/. The initial UT99 content surface rejects System/ payloads on purpose.
  • Workshop support: No

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 Unreal Tournament 99?

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

Which runtimes can run Unreal Tournament 99?

Declared runtimes: Docker or a Linux host process.

Which ports does Unreal Tournament 99 use?

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

Can I add mods to Unreal Tournament 99?

Mod support is declared; review the game guide for its providers and activation requirements.

How should I back up Unreal Tournament 99?

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