TShock provides Terraria servers with server-side characters, anti-cheat, and community management tools. https://tshock.co/
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.
TShock, like Terraria, only requires a single port to run. The default is 7777
Port | default |
---|---|
Game | 7777 |
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.
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.
Name | Tag |
---|---|
mono | ghcr.io/ptero-eggs/yolks:mono_latest |
Name | Description | Environment Variable | Default Value | User Viewable | User Editable |
---|---|---|---|---|---|
Max Players | The maximum number of players a server will hold. | MAX_PLAYERS | 8 | Yes | No |
World Size | Defines the worlds size. 3 sizes 1 (small), 2 (medium), 3 (large). | WORLD_SIZE | 1 | Yes | No |
World Name | The name for the world file. | WORLD_NAME | world | Yes | Yes |
Tshock Version | The version on tshock that will be installed. Latest available is: v4.5.18! | TSHOCK_VERSION | v4.5.18 | Yes | No |
#!/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")
if [ -z "$TSHOCK_VERSION" ] || [ "$TSHOCK_VERSION" == "latest" ]; then
DOWNLOAD_LINK=$(echo $LATEST_JSON | jq .assets | jq -r .[].browser_download_url)
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')
else
echo -e "defaulting to latest release"
DOWNLOAD_LINK=$(echo $LATEST_JSON | jq .assets | jq -r .[].browser_download_url)
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
FILETYPE=$(file -F ',' ${DOWNLOAD_LINK##*/} | cut -d',' -f2 | cut -d' ' -f2)
if [ "$FILETYPE" == "gzip" ]; then
tar xzvf ${DOWNLOAD_LINK##*/}
elif [ "$FILETYPE" == "Zip" ]; then
unzip -o ${DOWNLOAD_LINK##*/}
else
echo -e "unknown filetype. Exeting"
exit 2
fi
echo -e "install complete"