TShock Groups, Permissions and Regions: Protect Your Terraria Server
TShock gives you fine control over what players can do. The main tools are groups, permissions and regions.
Groups
Every account belongs to a group. TShock includes default groups such as guest, default and admin groups, and a superadmin group at the top. You can see them with the group commands in the console.
- /group list shows existing groups.
- /group add name permission adds a group with a permission.
- /group addperm name permission gives a group a permission.
- /group delperm name permission removes one.
- /user group username groupname changes someone's group.
Command names can vary a little between versions, so use /help to confirm them.
Permissions
A permission is a text node such as tshock.world.modify. Giving a permission to a group allows its members to do that action. Start with the fewest permissions needed, because it is easier to grant more later.
Regions
Regions protect part of the world, such as your spawn area. A typical flow:
- Select two corners with /region set 1 and /region set 2.
- Create it with /region define name.
- Allow a player with /region allow username name.
- Check or remove it with /region list and /region delete name.
Players without access cannot build inside the region.
Spawn protection
TShock also has spawn protection settings in tshock/config.json that stop building near spawn. This is useful for public servers.
Tips
- Turn on a server password if only friends should join.
- Keep the superadmin account to yourself, and give moderators a lower group.
- Edit config.json only while the server is stopped.
- Back up the tshock folder along with your world.
Troubleshooting
- If a player cannot build, check their group and any region covering the spot.
- If you lock yourself out, use the console, which can run commands with full rights.
Ask us on Discord for help.