Twserver

Teeworlds

This guide covers the twserver module in AlphaGSM.

Status

twserver is currently ENABLED (AUTH) on the documented Ubuntu 24.04 Linux baseline.

Before setup, authenticate Steam or SteamCMD with an account entitled to server app 380840. The current GitHub integration lane still validates both process and Docker runtime selection around that auth-gated prerequisite, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

• screen
• SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
• Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mytwserver create twserver

Run setup:

alphagsm mytwserver setup

Start it:

alphagsm mytwserver start

Check it:

alphagsm mytwserver status

Stop it:

alphagsm mytwserver stop

Setup Details

Setup configures:

• the game port (default 8303)
• the install directory
• SteamCMD downloads the server files

Useful Commands

alphagsm mytwserver update
alphagsm mytwserver backup
alphagsm mytwserver set port 8304
alphagsm mytwserver set servername "AlphaGSM Teeworlds Server"

set port and set servername rewrite autoexec.cfg immediately. The shared alias layer also accepts hostname and maps it to the Teeworlds servername setting.

Notes

• Module name: twserver
• Default port: 8303

Server variables

After create twserver, 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
port	gameport	integer	The UDP/TCP game port Teeworlds listens on.
servername	hostname, name	string	The advertised server name.

Developer Notes

Run File

• Executable: teeworlds_srv
• Location: <install_dir>/teeworlds_srv
• Engine: Custom (SteamCMD)
• SteamCMD App ID: 380840

Server Configuration

• Config file: autoexec.cfg
• Template: See server-templates/twserver/ if available
• Schema-backed sync: AlphaGSM keeps sv_port and sv_name in sync with set port / set servername

Maps and Mods

• Map directory: Check game documentation
• Mod directory: Check game documentation
• Workshop support: No