These docs are for v4.3.22. Click to read the latest docs for v4.4.0.

Disciplinary Measures

Don't worry, I've got this under control!

At some point in time you will encounter those players bent on making the gaming experience horrible for other people. These people will cause harm to your world and your players and you'll need a way to control them.

With the tshock.admin.kick permission you are able to use the /kick permission to immediately remove a player from the server. They will be able to, however, re-join the server immediately. You may provide a reason to kick this player within this command and it will be displayed to them.

Kick Example
/kick Ijwu "You're a crazy jerk!"

If this player returns and continues their harassment then you may need to resort to more permanent measures. With the tshock.admin.ban permission you'll be able to remove a player's privilege to playing on your server. This will be permanent. You can do so with the /ban add command, and like the /kick command you're able to specify a reason.

Ban Example
/ban add Ijwu "You've stolen enough of our cookies, you hideous monster!"

If you wish to unban a player and allow them to return to your server you are able to use the /ban del command with the tshock.admin.ban permission to remove the player from the ban list. Example:

Unban Example
/ban del Ijwu

Ban Subcommands

Sub-command: add

  • Arguments: [name] [reason]
  • Description: Bans the specified player from the server. The reason argument is optional and displays the reason text to the banned player and all other players on the server.
  • Example Usage
  • /ban add Ijwu "Go Away"

Sub-command: addip

  • Arguments: [ip]
  • Description: Bans the specified IP address from the server.
  • Example Usage
  • /ban addip 222.222.222.222

Sub-command: del

  • Arguments: [name]
  • Description: Unbans the specified player.
  • Example Usage
  • /ban del Ijwu

Sub-command: delip

  • Arguments: [ip]
  • Description: Unbans the specified IP address.
  • Example Usage
  • /ban delip 111.111.111.111

Sub-command clear

  • Arguments: [code]
  • Description: Clears all bans when used correctly. Due to the chance that this could be used mistakenly you may run the command without any arguments and receive a message informing you of a ban code. You must use this code as your argument for the next time you run the command. This will act as a confirmation that your intentions are to truly clear all of your bans.
  • Example Usage without code
  • /ban clear
  • Example Usage with code
  • /ban clear 5