Egg Repository

Pterodactyl Community Egg Repository

tshock

The t-shock modded terraria server. https://tshock.co/

Report an Issue!

Report an issue with this egg on GitHub using the buttons below

Read Me

TShock

TShock provides Terraria servers with server-side characters, anti-cheat, and community management tools. https://tshock.co/

From their GitHub

TShock is a toolbox for Terraria servers and communities. That toolbox is jam packed with anti-cheat tools, server-side characters, groups, permissions, item bans, tons of commands, and limitless potential. It's one of a kind.

Server Ports

TShock, like Terraria, only requires a single port to run. The default is 7777

Portdefault
Game7777

Plugins may require ports to be added to the server.

Extra Information

If you want to download mods in the console, the startup command has to be changed.

New startup: mono TerrariaServer.exe -ip 0.0.0.0 -port {{SERVER_PORT}} -maxplayers {{MAX_PLAYERS}}

This will remove the autocreate function, and will thus allow you to download mods and generate world. Afterwards, you can change it back with the correct world name to start automatic. Word name is set in the configuration panel.

Any version older then TShock v5 needs to use the legacy egg, and version newer or v5 must use the normal TShock one.

Migration from v4 to v5

If you're upgrading from TShock 4, you swith to the new egg copying the tshock configuration folder over (containing the sqlitedb file as well as the json configuration files, etc) to the new server, and starting the new server that way.

Yolks
NameTag
Dotnet 6ghcr.io/ptero-eggs/yolks:dotnet_6
Variables and Startup

Startup Command

./TShock.Server -ip 0.0.0.0 -port {{SERVER_PORT}} -maxplayers {{MAX_PLAYERS}} -world {{WORLD_NAME}}.wld -autocreate {{WORLD_SIZE}}

Variables

Max Players

The maximum number of players a server will hold.

Environment Variable: MAX_PLAYERS
Default Value: 8
User Viewable:✅
User Editable:❌
World Size

Defines the worlds size. 3 sizes 1 (small), 2 (medium), 3 (large).

Environment Variable: WORLD_SIZE
Default Value: 1
User Viewable:✅
User Editable:❌
World Name

The name for the world file.

Environment Variable: WORLD_NAME
Default Value: world
User Viewable:✅
User Editable:✅
Tshock Version

The version on tshock that will be installed. default is latest non-pre-release

Environment Variable: TSHOCK_VERSION
Default Value: latest
User Viewable:✅
User Editable:❌
Install Script
#!/bin/bash
# Vanilla tModloader Installation Script
#
# Server Files: /mnt/server
## install packages to get version and download links
apt update
apt install -y curl wget jq file unzip

## get release info and download links
LATEST_JSON=$(curl --silent "https://api.github.com/repos/Pryaxis/TShock/releases/latest")
RELEASES=$(curl --silent "https://api.github.com/repos/Pryaxis/TShock/releases")
MATCH=$([[ "$(uname -m)" == "x86_64" ]] && echo "(linux-x64|linux-amd64)" || echo "linux-arm64")

echo "${MATCH}"

if [ -z "$TSHOCK_VERSION" ] || [ "$TSHOCK_VERSION" == "latest" ]; then
    DOWNLOAD_LINK=$(echo $LATEST_JSON | jq .assets | jq -r .[].browser_download_url | grep -i -E "${MATCH}" | head -1 )
else
    VERSION_CHECK=$(echo $RELEASES | jq -r --arg VERSION "$TSHOCK_VERSION" '.[] | select(.tag_name==$VERSION) | .tag_name')
    if [ "$TSHOCK_VERSION" == "$VERSION_CHECK" ]; then
        DOWNLOAD_LINK=$(echo $RELEASES | jq -r --arg VERSION "$TSHOCK_VERSION" '.[] | select(.tag_name==$VERSION) | .assets[].browser_download_url' |  grep -i -E "${MATCH}" | head -1 )
    else
        echo -e "defaulting to latest release"
        DOWNLOAD_LINK=$(echo $LATEST_JSON | jq .assets | jq -r .[].browser_download_url | grep -i -E "${MATCH}" | head -1)
    fi
fi

## mkdir and cd to /mnt/server/
mkdir -p /mnt/server

cd /mnt/server

## download release
echo -e "running: wget $DOWNLOAD_LINK"
wget $DOWNLOAD_LINK -O TShock.zip

unzip -o TShock.zip

tar xvf TShock-*.tar

rm TShock.zip TShock-*.tar

chmod +x TShock.Server

echo -e "install complete"
Installation Imageghcr.io/ptero-eggs/installers:debianInstallation Entrypoint/bin/bash