How to Add an Admin to Your Terraria tShock Server

tShock manages permissions through accounts and groups. An admin is therefore not an entry in a file but a user account consisting of a user name and a password that belongs to a group with far-reaching permissions. You do not need a SteamID or any other player ID for this.

Create an admin via the server console

This is the fastest way because it requires neither a setup code nor an existing account. The server console always has the highest permissions on a tShock server.

1. Start the server
   Start your server via the dashboard.

2. Open the console
   Open the server console in the dashboard.

3. Create the account
   Enter the following command:

   user add <username> <password> owner
   

   Replace <username> and <password> with your own values and keep owner as the group.

4. Join the server
   Join your server: Join server.

5. Log in
   Log in through the in-game chat:

   /login <username> <password>
   

   You now have admin rights and can use all commands of your group.

Create an admin via the setup code

Alternatively you can use the setup assistant that tShock provides on the first start.

1. Read the setup code
   Open the server console in the dashboard. On startup you will find a message like this:

   To setup the server, join the game and type /setup <code>
   

2. Enter the setup command
   Join your server and enter the following in the in-game chat:

   /setup <code>
   

3. Create the account
   Now create your account:

   /user add <username> <password> owner
   

4. Log in
   Log in with your new account:

   /login <username> <password>
   

5. Finish the setup
   Finally, enter once more:

   /setup
   

   This permanently disables the setup system and deletes the setup code.

Manage accounts

All commands work in the in-game chat (with /) and in the server console (without /).

Command	Description
user add <user> <password> <group>	Create a new account
user del <user>	Delete an account
user password <user> <new password>	Change the password
user group <user> <new group>	Move an account to another group

Groups and permissions

tShock ships with several groups whose permissions increase from bottom to top:

Group	Role
guest	Guests without a login
default	Logged-in players without special rights
vip	Players with individual extra rights
newadmin	Entry-level moderation, e.g. kicking
admin	Full moderation including bans
trustedadmin	Additional administrative rights
owner	Almost all rights – the right choice for you as the operator
superadmin	Unrestricted rights, hard-coded into tShock

You manage your own groups and permissions with the following commands:

Command	Description
group list	Show all groups
group listperm <group>	Show the permissions of a group
group add <name> [permissions]	Create a new group
group del <name>	Delete a group
group addperm <group> <permission...>	Add permissions
group delperm <group> <permission...>	Remove permissions
group parent <group> <parent group>	Inherit the permissions of another group
group prefix <group> <text>	Set a chat prefix
group color <group> <R,G,B>	Set a chat color