Alpha Game Server Manager

Dedicated server guide

Unreal Tournament 2004

Manage ut2k4server 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-ut2k4server create ut2k4server
  3. Complete interactive setup ./alphagsm-docker my-ut2k4server setup
  4. Start the game server ./alphagsm-docker my-ut2k4server start
  5. Check the instance status ./alphagsm-docker my-ut2k4server status
./alphagsm-docker start
./alphagsm-docker my-ut2k4server create ut2k4server
./alphagsm-docker my-ut2k4server setup
./alphagsm-docker my-ut2k4server start
./alphagsm-docker my-ut2k4server 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-ut2k4server create ut2k4server
  2. Complete interactive setup ./alphagsm my-ut2k4server setup
  3. Check the host prerequisites ./alphagsm my-ut2k4server doctor
  4. Start the game server ./alphagsm my-ut2k4server start
  5. Check the instance status ./alphagsm my-ut2k4server status
./alphagsm my-ut2k4server create ut2k4server
./alphagsm my-ut2k4server setup
./alphagsm my-ut2k4server doctor
./alphagsm my-ut2k4server start
./alphagsm my-ut2k4server status

This guide covers the ut2k4server module in AlphaGSM.

Status: PASSED on 2026-05-29

Requirements

  • screen
  • 7z or 7zz from p7zip-full or an equivalent package
  • Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myut2k4ser create ut2k4server

Run setup:

alphagsm myut2k4ser setup

Start it:

alphagsm myut2k4ser start

Check it:

alphagsm myut2k4ser status

Stop it:

alphagsm myut2k4ser stop

Setup Details

Setup configures:

  • the game port (default 7777)
  • the install directory
  • runs the full OldUnreal native Linux installer and patch flow
  • keeps per-instance runtime state under .alphagsm/ut2k4-home so one server's user config does not leak into another instance

Useful Commands

alphagsm myut2k4ser update
alphagsm myut2k4ser backup

Mod Sources

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

  • Animations/
  • KarmaData/
  • Maps/
  • Music/
  • Sounds/
  • StaticMeshes/
  • 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 UT2004 content directories above.
  • mod add url <https-url> also accepts direct content-file URLs such as .ut2, .utx, .uax, .ukx, .usx, .ogg, and .ka; 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/ut2k4server/.
  • The first UT2004 content slice intentionally excludes System/ payloads, mutators, and code packages; archives that require those paths are rejected instead of being partially installed.

Examples:

alphagsm myut2k4ser mod add url https://example.invalid/mappack.zip
alphagsm myut2k4ser mod add url https://example.invalid/DM-Rankin-FE.ut2
alphagsm myut2k4ser mod apply
alphagsm myut2k4ser mod cleanup

Notes

  • Module name: ut2k4server
  • Default port: 7777
  • query, info, and info --json currently use generic udp reachability on the managed game port
  • the current stop path may fall back to AlphaGSM's managed kill after the graceful shutdown window if the UT2004 console does not exit on stop

Server variables

After create ut2k4server, 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: System/ucc-bin
  • Location: <install_dir>/System/ucc-bin
  • Engine: Custom

Server Configuration

Maps and Mods

  • Map directory: Maps/
  • Mod directory: Animations/, KarmaData/, Maps/, Music/, Sounds/, StaticMeshes/, Textures/
  • Mod notes: AlphaGSM can now track direct archive and direct content-file url entries for UT2004, install only approved custom-content payloads, and clean up only AlphaGSM-managed files from .alphagsm/mods/ut2k4server/. The initial UT2004 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 2004?

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

Which runtimes can run Unreal Tournament 2004?

Declared runtimes: Docker or a Linux host process.

Which ports does Unreal Tournament 2004 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 2004?

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

How should I back up Unreal Tournament 2004?

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