// Terraria

A Terraria server with TShock: plugins and management

A Terraria server with TShock: plugins and management

A vanilla Terraria server is set up in a few minutes and perfectly fine for an evening of building with friends. But as soon as your server grows — more players, strangers joining, a world you've grown attached to — you run into its limits: no accounts, no permissions, no protection against griefers. That is exactly what TShock is for: server software that replaces the vanilla server and turns it into a fully manageable platform, with plugins, permissions and regions. And the best part: your players notice nothing, they simply join with their normal Terraria.

Vanilla or TShock: what's the difference?

The vanilla server is the bare program that ships with Terraria. It does exactly one thing: run a world. TShock is a free, open-source alternative that builds a complete management layer on top of that:

  • Accounts and groups. Players register, and you decide per group what's allowed: from guest to moderator to administrator.
  • Commands. Teleport players, change the time, give items, hand out bans — in-game or via the console.
  • Regions. Protect areas against building and destroying, ideal for your spawn and shared projects.
  • Plugins. Extensions that give your server functionality vanilla simply doesn't have.

The most important thing to remember: TShock changes nothing about the game itself. No new items, no new bosses — for that you need tModLoader, more on which further down. TShock runs entirely on the server side, so anyone with a regular Terraria installation can join right away.

First start: claim your superadmin immediately

On a hosted server you pick TShock as the server software and start it via the panel; on a Terraria server from MC-Node that's ready in a few clicks. Then comes the most important step of the whole process: making yourself the top administrator. TShock secures that with a one-time setup code:

  1. Look in the console. On first start, TShock shows a setup code, clearly marked among the startup lines.
  2. Join your server with your normal Terraria client.
  3. Type in the chat /setup followed by the code from the console. You are now temporarily in setup mode.
  4. Create your account with /user add jouwnaam wachtwoord superadmin and log in with /login jouwnaam wachtwoord.
  5. Close setup mode with /setup once more. From now on the code is useless.

Do this immediately after the first start. As long as no superadmin exists, your server is a rudderless ship — and you don't want a setup code floating around while players are already online.

The settings that really matter

TShock keeps its configuration in config.json in the tshock folder. You can get lost in there for days, but three things you want sorted from day one:

  • A server password as long as your server isn't meant for everyone. A public server without a password will be found sooner or later — including by people with less noble intentions.
  • Spawn protection and regions. At the very least protect your spawn area with a region (via the /region commands), so new players don't start in an excavated crater. Give big communal builds their own region.
  • Permissions per group. Go through the default groups and ask yourself for every permission: do I want a random newcomer to be able to do this? Explosives are the classic one to lock behind a higher rank.

To be fair: TShock has a lot of options and the defaults aren't ideal for every server. Take an hour to walk through the config; it pays for itself twice over at the first visit from a bored griefer.

Plugins: the directions worth exploring

Plugins are .dll files you drop into the ServerPlugins folder, after which you restart the server. The community has built hundreds over the years; these directions show up on virtually every serious server:

  • Protection and rollback — more extensive anti-grief than the built-in regions, including rolling back damage that's been done.
  • Economy and shops — a currency, shops and rewards for bosses or events.
  • Warps and homes — teleport points, so players don't have to walk across the map for half an hour.
  • Chat and Discord bridges — pipe server chat into your community Discord and back.

Two practical warnings. First: always check that a plugin was made for your TShock version, otherwise your server won't start or the plugin silently does nothing. Second: add plugins one at a time and test in between. If something breaks, you immediately know who did it.

TShock or tModLoader? A short detour

The question always comes up: can I run mods too? That's about tModLoader, and it's a fundamentally different route. tModLoader adds content — new items, bosses and complete overhauls — but requires every single player to run tModLoader with the same mods. TShock adds management and asks nothing of players at all. Combining the two isn't straightforward; in practice you pick one. Rule of thumb: if you want new content, choose tModLoader; if you want a well-managed (semi-)public server with vanilla gameplay, choose TShock. The full trade-off is in our article on Terraria server hosting, below under further reading.

World management and backups

Your Terraria world is a single .wld file, and that makes backups surprisingly simple — and unforgivable to skip. A griefer, a corrupted save file or a failed plugin experiment: with yesterday's backup it's a shrug, without one it's game over. At the very least make a backup before every big moment: defeating the Wall of Flesh (hardmode changes your world permanently), major events and every plugin change. On the MC-Node panel you make backups with one click and can download them too (how to make a backup), so there's always a copy outside the server.

One closing tip: don't expect to get everything perfect in one evening. Start with your superadmin, a password and a protected spawn — that covers most of the misery — and calmly build out the rest as your server grows.

Further reading

// TRY IT YOURSELF
Your Terraria server online in 60 seconds
View packages →