How To Ban/Unban Players From Your Terraria Server

Summary

If a player is disrupting gameplay, cheating, or breaking your server’s rules, you may need to ban them to maintain a fair and enjoyable environment. Likewise, if someone was banned by mistake or has served a temporary ban, you can unban them easily.

Banning Players on a Vanilla/tModLoader Terraria Server

Banning via Game config:

1. Log in to your Control Panel.

   

2. Navigate to Game Config > Ban List.

   

3. Inside the Ban List, enter the “playername” and “playerIP” as shown.

   

4. Click Save to save your new ban/s.

   

This can also be done via Files > banlist.txt

Your new ban/s will now be saved. However, this does not immediately ban the player/s if in-game. They will have to log-out first for the command to take action.

The easiest and most immediate way to ban is via the Console, read on to learn more.

Banning Via the Console:

1. Log in to your Control Panel.

   

2. Navigate to the Console.

   

3. In the text box below the console log, type the following command:

   1. Replace <playername> with the player’s in-game name:

      ban playername

      

Note: If banning via the console, players must be online at the time you issue the ban command for it to work properly. Once banned, they won’t be able to connect to your server using any character.

Banning Players on a TShock Terraria Server

TShock servers offer more advanced options, including temporary and permanent bans.

Before you start, make sure your account has the tshock.admin.ban permission.

Check out our guide on Adding an Admin User On Your tShock Terraria Server.

To issue a permanent ban:

1. Log into your server and open the in-game chat (press / by default).

2. Type one of the following commands:

• This bans a player by their username and includes a reason:

  /ban add <username> <reason>

  

  The <reason> is optional.

• This bans a player by their IP address instead:

  /ban addip <IP Address>

To issue a temporary ban:

1. Log into your server and open the in-game chat.

2. Use this command format:

   /ban addtemp <username> <time> <reason>

   • Replace the placeholders with the correct name, time duration, and reason for the ban.

Unbanning Players on a Vanilla/tModLoader Terraria Server

1. Log into your Control Panel.

   

2. Navigate to Game Config > Ban List.

   

3. Each banned player will appear twice — once with their username and once with their IP address.

   

4. Delete both lines for the player you want to unban, then click Save.

   

The player/s will be able to re-join your server immediately.

Unbanning Players on a TShock Terraria Server

To unban by username:

1. Log into your server and open the in-game chat.

2. Type:

   /ban del <username>

To unban by IP:

1. Log into your server and open the in-game chat.

2. Type:

   /ban delip <IP Address>

After using these commands, the player will be removed from the ban list and can connect again.

View Ban List of Players on a TShock Terraria Server

1. Log into your server and open the in-game chat.

2. Type:

   /ban list

Tip: use /help to view list of available commands in-game.