TShock for Terraria: Admin Commands and Permissions Setup

Quick answer: TShock is the standard admin framework for vanilla Terraria. It does not change gameplay the way tModLoader does, it wraps the vanilla server with commands, permission groups, and anti-cheat so you can actually moderate a real multiplayer world. It ships as its own server executable, so you install it the same way you would any Terraria server jar: download it, point your server at it, and run it in place of the stock dedicated server.

If tModLoader is Terraria's answer to "I want new content," TShock is the answer to "I want to run this server without babysitting it."

What TShock actually adds

• Permission groups. Give trusted players moderator commands without making everyone an admin, or lock down building and item spawning to a whitelist.
• Admin commands. Kick, ban, mute, teleport, item and NPC spawning, world control, all from in-game chat or the console.
• Anti-cheat. Catches common exploits like item duplication and illegal item spawning before they wreck an economy or a build.
• A plugin ecosystem. Beyond the built-in commands, TShock supports its own plugins for things like economy systems, region protection, and custom commands, separate from tModLoader's mod ecosystem.

None of this changes what Terraria is. Bosses, items, and progression stay vanilla. That is the whole point: TShock is for server owners who want control over their community, not new content.

TShock vs tModLoader, picked for the right reason

These solve different problems and you can only run one at a time on a given server:

• Pick TShock if your priority is moderating a public or semi-public server, protecting builds, and having real admin tools for a community that is bigger than a few friends who trust each other completely.
• Pick tModLoader if your priority is new content, mods like Calamity or Thorium, and you are fine with everyone needing the exact same mod list to join.

A small private world with friends you trust often does not need either, vanilla is enough. TShock earns its place once the server is public, growing, or you are tired of being the only person who can fix a griefing incident.

Setting it up

1. Download the TShock release that matches your Terraria version. TShock tracks Terraria's version numbers closely, running a mismatched version is the most common reason a fresh install refuses to start.
2. Point your server at the TShock executable instead of the stock TerrariaServer file. On our panel this means selecting TShock from the server type dropdown rather than vanilla or tModLoader, no manual file swapping needed.
3. First boot creates your config and a superadmin account. The console prints a temporary setup token on first launch, use it to claim the superadmin account from inside the game with /register or the login prompt, then change that password immediately.
4. Set up permission groups through /group commands or the config files. A common starting point is a default group for regular players and a separate group for anyone helping moderate.
5. Add plugins if you want them. Drop TShock plugin DLLs into the ServerPlugins folder and restart. Economy and region-protection plugins are the most commonly requested additions.

Common early mistakes

• Forgetting to secure the superadmin account. The default setup token is meant to be claimed once and replaced with a real password immediately, leaving it unclaimed is an open door.
• Running TShock and expecting tModLoader mods to work. They are separate server types. If you want both new content and admin tools, that is a tModLoader-only path, TShock does not run alongside mods.
• Overly broad default permissions. The default player group can build and interact more freely than you might expect on a public server, tighten it before opening the doors.

FAQ

Does TShock cost anything? No, it is free and open source, maintained by the Terraria server community.

Can I switch from vanilla to TShock without losing my world? Yes, TShock runs on top of the same world files. Point it at your existing world and it loads normally, gaining the admin layer on top.

Do players need to install anything to join a TShock server? No. TShock changes what the server does, not the client. Anyone with a normal, unmodded Terraria client can join.

Can I run TShock on a small hosting plan? Yes. TShock's own overhead is light, most groups are comfortable on a 2GB plan unless the player count or world activity is already pushing a vanilla server that size. See our guide to Terraria RAM sizing for the specifics.