Skip to content

Ut3server

Jump to bottom
github-actions[bot] edited this page Oct 17, 2026 · 2 revisions

Unreal Tournament 3

This guide covers the ut3server module in AlphaGSM.

ut3server is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane still exercises both process and Docker runtime selection around that owned-dedicated-tree prerequisite, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

  • screen
  • an owned Unreal Tournament 3 dedicated-server tree
  • optional OpenSpy credentials if you want the server to authenticate and advertise

Quick Start

alphagsm myut3 create ut3server
alphagsm myut3 setup
alphagsm myut3 start
alphagsm myut3 status
alphagsm myut3 stop

ut3server is supported in ENABLED (BYO) mode. Before setup or start, copy an owned UT3 dedicated server tree into your chosen <install_dir>/ so <install_dir>/Binaries/ut3 exists. If you want authenticated public advertising, set gsusername and gspassword with your OpenSpy credentials before starting the server.

Suggested flow:

alphagsm myut3 create ut3server
alphagsm myut3 setup -n 7777 /path/to/ut3server
# copy the owned UT3 dedicated server files into /path/to/ut3server/
alphagsm myut3 set gsusername myopenspyuser
alphagsm myut3 set gspassword myopenspypassword
alphagsm myut3 start

Notes

  • Module name: ut3server
  • Install mode: ENABLED (BYO) server files
  • Default port: 7777
  • Default query port: 6500
  • Query/info protocol: ut3 (Unreal3/GameSpy4 reachability probe)

Server variables

After create ut3server, 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

  • AlphaGSM expects the server executable at Binaries/ut3 relative to the install root.
  • The start surface follows LinuxGSM's UT3 launch pattern, including ConfigSubDir=<server-name>, -queryport, -nohomedir, and -unattended.
  • The active config path defaults to UTGame/Config/<server-name>/UTGame.ini.
  • Automated install is not provided because LinuxGSM does not expose a concrete upstream download path for UT3; this module manages user-provided files instead.

BYO file helper

Inspect this game's required files, source instructions and destinations with alphagsm <server-name> assets requirements; check the declared files with alphagsm <server-name> assets check. File checks do not establish game readiness. This helper checks known sentinels only and directs you to stage the complete compatible distribution manually; managed import is unavailable for this recipe. See BYO files and private SteamCMD acquisition.

Clone this wiki locally