Dedicated server guide

TShock

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

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

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

Declared curated families: autoteam, bagger, banguard, facommands, omni, perplayerloot, qol, ranksystem, replenisher, smartregions, timeranks, tslootchest. The optional autoteam example installs its dependencies and applies the mod plan before launch.

Backup hook

Backup hook support is unknown in this snapshot; review the game guide for backup and restore procedures.

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. Optional curated example: autoteam. Omit all optional mod steps for a base server.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-terraria-tshock create terraria.tshock
Complete interactive setup ./alphagsm-docker my-terraria-tshock setup
Optional: add autoteam # Optional curated mod: autoteam; add autoteam ./alphagsm-docker my-terraria-tshock mod add manifest autoteam
Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm-docker my-terraria-tshock mod apply
Start the game server ./alphagsm-docker my-terraria-tshock start
Check the instance status ./alphagsm-docker my-terraria-tshock status

./alphagsm-docker start
./alphagsm-docker my-terraria-tshock create terraria.tshock
./alphagsm-docker my-terraria-tshock setup
# Optional curated mod: autoteam; add autoteam
./alphagsm-docker my-terraria-tshock mod add manifest autoteam
# Optional: apply the mod plan
./alphagsm-docker my-terraria-tshock mod apply
./alphagsm-docker my-terraria-tshock start
./alphagsm-docker my-terraria-tshock status

Host process

Create the game instance ./alphagsm my-terraria-tshock create terraria.tshock
Complete interactive setup ./alphagsm my-terraria-tshock setup
Optional: add autoteam # Optional curated mod: autoteam; add autoteam ./alphagsm my-terraria-tshock mod add manifest autoteam
Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm my-terraria-tshock mod apply
Check the host prerequisites ./alphagsm my-terraria-tshock doctor
Start the game server ./alphagsm my-terraria-tshock start
Check the instance status ./alphagsm my-terraria-tshock status

./alphagsm my-terraria-tshock create terraria.tshock
./alphagsm my-terraria-tshock setup
# Optional curated mod: autoteam; add autoteam
./alphagsm my-terraria-tshock mod add manifest autoteam
# Optional: apply the mod plan
./alphagsm my-terraria-tshock mod apply
./alphagsm my-terraria-tshock doctor
./alphagsm my-terraria-tshock start
./alphagsm my-terraria-tshock status

This guide covers the terraria.tshock module in AlphaGSM.

terraria.tshock is currently PASSED on the documented Ubuntu 24.04 Linux baseline. The checked-in GitHub validation path for this server is Docker-first through the shared steamcmd-linux runtime image with the required .NET runtimes already baked in.

Requirements

screen
dotnet on process-backed hosts
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mytshock create terraria.tshock

Run setup:

alphagsm mytshock setup

Create its first world and start it:

alphagsm mytshock start --autocreate

Check it:

alphagsm mytshock status

Stop it:

alphagsm mytshock stop

Setup Details

Setup configures:

the game port (default 7777)
the install directory
downloads and extracts the server archive

World Selection and Reset

start --autocreate creates the configured world only when it is missing. If the world already exists, the option does nothing and startup behaves like plain start. Use alphagsm mytshock connect to answer the native console prompts.

To start over, stop the server and run alphagsm mytshock reset-world. It lists the world data to delete and asks for confirmation; -Y bypasses that prompt. wipe is an alias for the same operation.

See world creation and reset for settings, supported paths, and the full lifecycle.

Useful Commands

alphagsm mytshock update
alphagsm mytshock backup

Notes

Module name: terraria.tshock
Default port: 7777

Developer Notes

Run File

Executable: TShock.Server
Location: <install_dir>/TShock.Server
Engine: Custom

Current upstream Linux releases ship a native TShock.Server apphost inside a release zip that contains a nested tar archive. AlphaGSM unwraps that nested archive during setup. The shared steamcmd-linux Docker runtime image also includes the required .NET 9 runtime for the current TShock build.

Server Configuration

Config file: See game module source
Template: See server-templates/terraria-tshock/ if available
Query/info protocol: TCP on the configured game port

Maps and Mods

Map directory: Check game documentation
Mod directory: ServerPlugins/
Workshop support: No

Plugin Sources

TShock plugin management is separate from vanilla Terraria and uses its own AlphaGSM cache/state root.

AlphaGSM stores TShock plugin cache/state under .alphagsm/mods/terraria-tshock/ so it does not collide with other Terraria variants.
Current plugin source support is manifest, url, and moddb.
manifest uses AlphaGSM's checked-in TShock plugin registry. The built-in families currently include banguard, smartregions, omni, perplayerloot, autoteam, facommands, timeranks, ranksystem, qol, replenisher, bagger, and tslootchest.
url accepts direct plugin .dll downloads and .zip plugin packages, including release zips that expose a bare plugin root instead of a prebuilt ServerPlugins/ directory.
moddb accepts canonical Mod DB download or addon page URLs when the resolved payload contains TShock plugin files under ServerPlugins/, tshock/, or as a bare plugin-root archive.
AlphaGSM records installed plugin files per entry so mod cleanup removes only tracked plugins and leaves unrelated files alone.

Examples:

alphagsm mytshock mod add manifest banguard
alphagsm mytshock mod add manifest smartregions
alphagsm mytshock mod add manifest perplayerloot
alphagsm mytshock mod add manifest timeranks
alphagsm mytshock mod add manifest tslootchest
alphagsm mytshock mod apply
alphagsm mytshock mod cleanup

alphagsm mytshock mod add url https://plugins.example.invalid/ExamplePlugin.dll
alphagsm mytshock mod apply
alphagsm mytshock mod cleanup

alphagsm mytshock mod add moddb https://www.moddb.com/mods/example/downloads/example-plugin-pack
alphagsm mytshock mod apply
alphagsm mytshock mod cleanup

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

serverconfig.txt

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 TShock?

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

Which runtimes can run TShock?

Declared runtimes: Docker or a Linux host process.

Which ports does TShock use?

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

Can I add mods to TShock?

How should I back up TShock?

Backup hook support is unknown in this snapshot; review the game guide for backup and restore procedures.

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