Installing & Configuring TShock On Your Terraria Server

Summary

TShock is an essential tool for running Terraria servers. It adds powerful management features like kicking, banning, permissions, and more, allowing you to control your server directly from in-game. TShock also supports plugins, giving you the flexibility to customize your server even further.

Important: Before making any major changes, we recommend creating a full backup of your server to avoid data loss.

Installing TShock

1. Log in to your Control Panel and stop the server.

   
   

2. Navigate to Settings.

   

3. Scroll down to the Installed game and click Swap Game.

   

4. Search for “tShock” and select it from the list.

   

   Any version older then tShock v5 needs to use tshock legacy
   

5. Click Change Game to confirm and begin installation.

   

6. Start your server

   

Warning: Once TShock is installed, your server console will no longer accept commands. All commands must be entered in-game instead. This is a known limitation of TShock and may be fixed in a future update.

Configuring TShock

1. In your server console, look for a line similar to:
   “To setup the server, join the game and type /setup xxxxxxx”
   (The xxxxxxx represents a random number unique to your server.)

   

2. Launch Terraria and join your server.

   

   If you need help joining, check out our guide on Joining your Terraria Server.

3. Once connected, open the in-game chat (press Enter) and type or paste the setup command from the console.

4. If successful, TShock will display confirmation text in your chat.

   

5. Create your owner account using this command:

   /user add [account name] [password] owner

   • Replace the fields in square brackets with the given strings.

   
   

   Your account name doesn’t need to match your in-game character name.

6. If done correctly, you’ll see the message:
   “Account [account name] has been added to group owner!”

7. Log in to your new owner account by entering:

   /login [account name] [password]

   • Replace the fields in square brackets with the given strings.

8. Once you see “Authenticated as [account name] successfully!” your setup is complete.

Your Terraria server is now running with TShock installed and fully configured. Remember to save your login details you’ll need to use them each time you join your server to access admin commands.