How do I setup my ts3 bot?

When setting up your bot there are several fields that you need to enter. While we have tried to make the field descriptions as clear as possible some users still have a hard time understanding each one.

TeamSpeak 3 server address:
The default that is displayed is What you should enter should be your server’s connection information but without the port. Please note that if you are using some type of no-port feature for your server you still need to use the ID or actual server port to get this setup. You can add a hostname or even an IP address as long as it points to your teamspeak server.


  • you normally connect with You would enter into this feild and then 900 would go into the “Teamspeak 3 virtual server port” field.
  • you normally connect with You would need to enter your original hostname or IP (the one that required you to use a port) instead of your customized connection details.
  • you normally connect with If ts.mydomain directly resolves to your server then you would still put but make sure you still put in the server ID or port as explained later in this guide.

Teamspeak 3 server query port, default is 10011:
As stated in the description it is normally 10011 you can get the exact query port from your hosting provider or if you are hosting your server yourself it can be found in your teamspeak configuration file.

Teamspeak 3 query account name, which should be used by the bot:
within your teamspeak 3 client go to tools > ServerQuery Login. It will ask you to put in a username. Choose the username that you would like your bot to have; something with no spaces like: botuser . Once you have done that the server will generate a password and display it to you. The username you will place in this field.

NOTE: If you are hosting your own teamspeak 3 server DO NOT use the main serveradmin query account. It is a significant security risk if you do.

Teamspeak 3 server query account password:
The password generated in that same tools > ServerQuery Login section would go into this field.

Teamspeak 3 virtual server ID or -1 to write the Teamspeak 3 Port into the next text field.:
You should place your server ID into this section. For TserverHQ users you can find this in your control panel in the teamspeak 3 browser. For other users you can get this from your hosting provider or from query commands. If getting your ID seems to difficult you can just leave this as -1 and input your port in the next field.

Teamspeak 3 virtual server port, only needed if the virtual server id was set to -1.
Here you can just put your teamspeak 3 UDP port. This would be the set of number you need to add after the hostname when connecting to your server. If you used the server id field before this then just ignore this field. It won’t matter.

Slow mode:
As the description states it slows down your bot if it hasn’t been whitelisted. We have all of our TserverHQ servers whitelisted with the bot, but if you are using the bot for another provider and you don’t want to use slowmode your provider would need to whitelist

Once you have put in all your settings properly you should see a successful connection and the bot should then be working. You can then mess with the settings and get your both exactly how you’d like it.

  • 4191 Users Found This Useful
Was this answer helpful?

Related Articles

ts3 bot chat commands

Most functions of the bot can be controlled from the control panel. There are a few things you...

Common Permission Errors

There are common errors you will see in the bot logs showing that you don't have the correct...

How do I disable slowmode on my bot?

If you disable slowmode on your bot you would need to add our IP to your whitelist