How to Kick and Ban Players on Your Terraria tShock Server

tShock comes with a full-featured ban system: time-limited bans, reasons and ticket numbers for lifting bans selectively. All commands work both in the in-game chat and in the server console of your dashboard.

Show players

who

This command lists all connected players. With who -i you additionally get the index of every player, which lets you address them unambiguously.

Kick a player

kick <player> [reason]

The player is removed from the server but can rejoin immediately. If you do not provide a reason, tShock inserts a default text.

Ban a player

ban add <target> [reason] [duration] [flags]

The player is removed from the server immediately and can no longer connect. In response tShock gives you a ticket number – you need it later to lift the ban.

Specifying a duration

The duration uses the format 0d0h0m0s – days, hours, minutes, seconds. If you leave it out, the ban is permanent.

Flags

Flags define what the ban is tied to. Without any flag tShock bans the account, the device identifier and the IP address at the same time.

Ban offline players

If the player is no longer on the server, use the -e flag together with a prefix that states what the ban refers to:

Lift a ban

ban del <ticket number>

There is no unban command – you always lift a ban through its ticket number.

1. Find the ticket number
   List the bans:

   ban list
   

   With many entries you can page through them using ban list 2, ban list 3 and so on.

2. Check the entry
   Details about an entry are shown by:

   ban details <ticket number>
   

3. Delete the ban
   Lift the ban:

   ban del <ticket number>
   

Mute a player

mute <player> [reason]

unmute <player>

The player stays on the server but can no longer write in the chat.

Command overview