Dedicated server guide

TerraTech Worlds

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

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

Runtime familywine-proton

Declared runtimes: Docker or a Linux host process. This module declares the Wine/Proton compatibility family.

Network bindings

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

Mods and plugins

No mod support is declared in this snapshot; review the game guide before adding mods.

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.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-terratechworldsserver create terratechworldsserver
Complete interactive setup ./alphagsm-docker my-terratechworldsserver setup
Start the game server ./alphagsm-docker my-terratechworldsserver start
Check the instance status ./alphagsm-docker my-terratechworldsserver status

./alphagsm-docker start
./alphagsm-docker my-terratechworldsserver create terratechworldsserver
./alphagsm-docker my-terratechworldsserver setup
./alphagsm-docker my-terratechworldsserver start
./alphagsm-docker my-terratechworldsserver 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.

Create the game instance ./alphagsm my-terratechworldsserver create terratechworldsserver
Complete interactive setup ./alphagsm my-terratechworldsserver setup
Check the host prerequisites ./alphagsm my-terratechworldsserver doctor
Start the game server ./alphagsm my-terratechworldsserver start
Check the instance status ./alphagsm my-terratechworldsserver status

./alphagsm my-terratechworldsserver create terratechworldsserver
./alphagsm my-terratechworldsserver setup
./alphagsm my-terratechworldsserver doctor
./alphagsm my-terratechworldsserver start
./alphagsm my-terratechworldsserver status

This guide covers the terratechworldsserver module in AlphaGSM.

terratechworldsserver 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 path remains Wine/Proton-backed with generic udp lifecycle checks on the managed game port.

Requirements

screen
Wine or Proton-GE on Linux hosts
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myterratec create terratechworldsserver

Run setup:

alphagsm myterratec setup

Start it:

alphagsm myterratec start

Check it:

alphagsm myterratec status

Stop it:

alphagsm myterratec stop

Setup Details

Setup configures:

the game port (default 7777)
the install directory
SteamCMD downloads the Windows dedicated server files

Useful Commands

alphagsm myterratec update
alphagsm myterratec backup

Notes

Module name: terratechworldsserver
Default port: 7777

Server variables

After create terratechworldsserver, 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: TT2Server.exe launcher on Windows; AlphaGSM's Linux lane now bypasses it and launches TT2/Binaries/Win64/TT2Server-Win64-Shipping.exe directly under Wine.
Location: <install_dir>/TT2Server.exe and <install_dir>/TT2/Binaries/Win64/TT2Server-Win64-Shipping.exe
Engine: Windows dedicated server via Wine/Proton
SteamCMD App ID: 2533070

AlphaGSM launches the Windows dedicated binary with -log, tracks readiness through TT2/Saved/Logs/TT2.log, and treats info --json protocol udp on the managed game port as the readiness contract.

Current validation status: the 2026-05-28 follow-up tightened the Linux launch contract after proving that the root TT2Server.exe bootstrap path stalls in a headless SDL/Xalia UI layer before the real server starts. A focused live probe against the inner TT2Server-Win64-Shipping.exe under xvfb-run plus Wine created TT2/Saved/Logs/TT2.log, reached LogNet: ... listening on port 7777, and responded to AlphaGSM's generic UDP probe while A2S and TCP both failed.

A fresh end-to-end AlphaGSM rerun on 2026-05-28 now passes on that direct binary UDP contract. Anonymous SteamCMD setup for app 2533070 completed, the managed AlphaGSM port (52707 in the focused run) synced into dedicated_server_config.json, TT2/Saved/Logs/TT2.log reached Created socket for bind address: 0.0.0.0:52707, IpNetDriver listening on port 52707, and Bringing World ..., and AlphaGSM status, query, info, and info --json all succeeded with protocol udp before a clean stop. This lane is ready for parent tracker/changelog promotion from validation queue to passed on the generic UDP contract.

Server Configuration

Config files: dedicated_server_config.json
Template: See server-templates/terratechworldsserver/ if available

Maps and Mods

Map directory: Check game documentation
Mod directory: Check game documentation
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 TerraTech Worlds?

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

Which runtimes can run TerraTech Worlds?

Declared runtimes: Docker or a Linux host process. This module declares the Wine/Proton compatibility family.

Which ports does TerraTech Worlds use?

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

Can I add mods to TerraTech Worlds?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up TerraTech Worlds?

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