How do I add a player to the Terraria whitelist?

Use the console in ZAP-Hosting Gameserver Management with the command whitelist . TShock saves the list in tshock/whitelist.txt.

Terraria: Whitelist

Information on how to set up your Terraria server whitelist at ZAP-Hosting → Learn more now

10 November 20261 min read0 Views0 helpful

Introduction

A whitelist is an access list that restricts who can join your server. For Terraria hosting, this usually runs on a TShock server where you enable the whitelist feature. It is managed via a whitelist file and commands.

Enabling the Whitelist

Connect to your server via FTP and check if your server uses TShock. Then open the TShock configuration file tshock/config.json and enable the whitelist setting:

Code

"EnableWhitelist": true

Save the file and restart the server. TShock now requires whitelist approval for incoming connections.

Managing Whitelist Players

To add an entry, open the console in the ZAP-Hosting Gameserver Management and use the whitelist command with the player's IP address.

text

whitelist 203.0.113.25

TShock stores the list in tshock/whitelist.txt. To remove an entry, connect via FTP, open the file, delete the corresponding IP line, save, and restart the server.

txt

203.0.113.25
198.51.100.10

Checking the Whitelist Function

After restarting, try to connect from an IP address not on the list. Access should be blocked. Then connect from an IP that is on the whitelist.

If players can still join without being listed, double-check that EnableWhitelist in config.json is set to true and that the server is actually running as TShock.

Conclusion

If you have followed all steps correctly, your whitelist is now active, allowing you to precisely control who can access your server. If access still does not work as expected, restart the server again and check the file or console output to ensure the change was applied.

If you have further questions or issues, our support team is available daily to assist you! 🙂

FAQ

Frequently asked questions

Open the file tshock/config.json via FTP, set "EnableWhitelist": true, save, and restart the server.

Use the console in ZAP-Hosting Gameserver Management with the command whitelist <IP address>. TShock saves the list in tshock/whitelist.txt.

Connect via FTP, open tshock/whitelist.txt, delete the IP line, save, and restart the server.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.

Which 🍪 cookies would you like to allow?

Terraria: Whitelist

Introduction

Enabling the Whitelist

Managing Whitelist Players

Checking the Whitelist Function

Conclusion

Frequently asked questions

Terraria

Enabling the Whitelist

Managing Whitelist Players

Checking the Whitelist Function

Conclusion

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting