How to unban a player on your Terraria server

On your server's Overview page, click Bans on the Active players card, then Unban next to the player's name. The ban is lifted straight away, with no restart. On Terraria Vanilla and tModLoader this works even while the server is stopped. On TShock the server must be running.

Lift a ban

1. Open your server in the panel. You land on Overview.
2. On the Active players card, click Bans.
3. The window Bans lists the banned players by name. Click Unban next to the name.

4. A message says Unbanned and the name, and They can join again, unless their address is also banned under another name.

Nobody is banned means the list is empty.

Terraria Vanilla and tModLoader

A Terraria ban is a name and an internet address, kept in banlist.txt at the top of Files. The Bans list shows each name, with a count of addresses when one name was banned from more than one. Unban removes every ban under that name.

If two players on the same home connection were both banned, their address is on the list twice. Lifting one name leaves the address blocked under the other name, so lift both.

A ban someone added to banlist.txt by hand has no name the panel can show. The window then says the ban was added by hand: edit banlist.txt in Files to change it, deleting the address line and the //name line above it.

TShock

TShock keeps its bans in its own database, as numbered tickets. The Bans list groups them by player name and lifts them all with Unban. Start the server first: Start the server to lift a TShock ban. TShock changes its bans only while it runs.

A TShock ban made in game on a player who was not logged in may have no name. The window then says to type ban list in the Console and ban del followed by each of its numbers.

Messages you may see

• The ban list could not be read just now. Try again in a moment. Try again. If it stays, open banlist.txt in Files instead.
• banlist.txt is too large to edit here. Open it under Files instead.
• Someone else is changing the ban list. Try again in a moment.
• On TShock: Sent to TShock, but its ban list has not changed yet. Open Bans again in a moment.

Who can do it

The Bans button needs Use the console and the file permission Read contents. Unban also needs Create and upload. See How to let a friend help run your Terraria server.

Good to know

• On tModLoader with Language set to anything but English, the Active players card does not show, so neither does Bans. Lift a ban in banlist.txt in Files instead, or set Language to English.
• Ban someone: How to kick or ban a player on your Terraria server.