Getting Started

Let's get your new TShock installation built. Sound good? Great!

Let's install TShock, quickly.

You'll need:

  • Microsoft .NET Framework 4.5 (on Windows)
  • Mono 4+ (on Linux/BSD/UNIX derivatives)
  • 2GB of RAM (dedicated to Terraria, free, not total system RAM)

Download & Extract

Download the latest version of TShock from Github Releases. Once you've downloaded it, extract it with your favorite extraction program.

❗️

Be sure to extract the archive!

If you just run TShock from inside the archive (like when you double click on it in Windows), you aren't actually creating a TShock server, and all of your settings will be lost when you shutdown the server!

👍

Upgrading?

To upgrade TShock, backup your server by copying it to a separate location. Then follow the upgrade process.

  1. Replace the TerrariaServer.exe file in the existing installation folder with the one from the archive.
  2. Replace all dll files from the archive with all of the files in the archive.
  3. Upgrade plugins as needed. The latest plugins can be found in resource manager on the forums.

📘

Want to start fast?

Sometimes the server will offer defaults in parenthesis, like (so). If you want to take the suggestion in parenthesis, simply hit enter when you see a prompt that ends in them, rather than retyping the suggestion. It saves time!

🚧

Installing Mono?

TShock requires the mono-complete package. We recommend the absolute latest versions of Mono, following the instructions from the official Xamarin/Microsoft website, not the packages shipped with your linux distribution. On macOS, we highly suggest installing Mono with Homebrew (brew install mono).

Some users have experienced issues with these instructions too. If your server won't let players join, install mono-devel.

Finally, consider trying to increase the Mono thread per CPU count.

MONO_THREADS_PER_CPU=50 mono TerrariaServer.exe

Become Admin

If you're not upgrading your server, you need to make yourself a super admin to use TShock.

  1. Start TShock by running TerrariaServer.exe. This can be done by double clicking on the server in Windows, or running mono TerrariaServer.exe in Linux.
  2. Select a world you want to start the server with. You can select a new world each time you start the server, or generate one if you want.
  3. Select your desired server port. The default Terraria server port is 7777.
  4. When the server starts, you'll see a message that says "To become superadmin, join the game and type /auth [authcode]." Take note of the code displayed in your server console.
  5. Start the game, and join your server. Your local IP address is 127.0.0.1 or localhost. If you're renting a server from a service provider, your IP address is listed in your control panel. Make sure to use the port you selected in step 3.
  6. Once inside the game, type /auth code, where code is your auth code from step 4.
  7. Immediately after, type /user add [username] [password] superadmin. Replace username and password with your desired username and password, without brackets.
  8. Login using /login [username] [password]. If you login successfully, great! If not, repeat step 7 or post on the forums to get more help.
  9. Type /auth to finish setup.

❗️

Protect your SuperAdmin Account

The SuperAdmin account contains all privileges on your server. It's important that you make your password strong, long, and hard to guess.

🚧

Something break?

If you need to start fresh, you can always do so by deleting the TShock database file and the authcode lock file.

  • Delete tshock.sqlite in the tshock folder.
  • Delete auth.lck in the same folder as TerrariaServer.exe.

This will remove all users and restore TShock to a pre-installation state. If this isn't what you want to do, ask the forums.