The Claytonia Gaming Teamspeak server uses TS3AudioBot for music. Below are helpful notes that I have taken to aid in the administration and usage of the bot. I've gone through the GitHub issues and Swagger API docs to find this info, and I wrote it all down for easy reference next time.

These are my personal notes and I want to share them publicly in an effort to help people use TS3AudioBot in the future.

If you have any questions, I'd be happy to help you set up or use the bot. You can find me on the Claytonia Teamspeak and Discord servers.

The Claytonia Teamspeak server is open to the public, feel free to join and test out the bot!

User Commands and General Usage:

TS3AudioBot Tips And Tricks

Playlists

YouTube playlists

!list import MY-GOOD-MUSIC https://www.youtube.com/playlist?list=xxxxxxxxxxxxxxxxx

!list play MY-GOOD-MUSIC

alais add ytpl = "!x (!list clear YTPL1) (!list import YTPL1 (!param 0)) (!list play YTPL1)"

!ytpl https://www.youtube.com/playlist?list=PLjpFxEOCYnaz8dBK3c1lUq4x61TFq_Odr

m3u8 Playlists

!list get https://raw.githubusercontent.com/junguler/m3u-radio-music-playlists/main/80s.m3u 80s

!list play 80s

Local Media Playlist

!list import adamradio /home/tsaudio/bots/default/music/adamradio/

!list play adamradio

Help

!help

!help command list

!help command history

NOT !help list !help history

Custom Commands and Aliases

Aliases must be added to each bot individuality.
To add an alias, use these commands:

!alias add [new command] "![command]"

!alias add come "!bot come"

In this example, the new command is "!come" and it will call the bot to the channel of the user issuing the command.

!alias add hits "!play https://34.105.16.234/alphacorporate-wikzfmaac-ibc4"

This example sets up an alias to play a radio station when the user sends the command: "!hits"

If YouTube links aren't working with a !play alias, you might have to add [URL] before the link.

!alias add hits "!play [URL]https://www.youtube.com/watch?v=-lbbHQbZNKg"

Admin and Config File Stuff

Login

To log in to the web interface, you will need an API token. Send the bot a PM with this command. Note: The Claytonia Teamspeak's web interface is turned off.

!api token

Set default channel

!settings set connect.channel "/34"

Boot Options

How to make the bot do things when it connects to a server.

[events]
#Called when the bot is connected.
onconnect = "!xecute (!bot commander on) (!play https://stream.live.vc.bbcmedia.co.uk/bbc_world_service)"

Alone mode

[events]
#...

#Called when the last client leaves the channel of the bot. Delay can be specified
onalone = "!stop"
#Specifies how long the bot has to be alone until the 'onalone' event gets fired.
#You can specify the time in the ISO-8601 format with quotation marks "PT30S" or like: 15s, 1h, 3m30s
alone_delay = "30s"
#Called when the bot was alone and a client joins his channel. Delay can be specified.
onparty = "!play [Youtube URL]" #any command works. 
#Specifies how long the bot has to be alone until the 'onalone' event gets fired.
#You can specify the time in the ISO-8601 format with quotation marks "PT30S" or like: 15s, 1h, 3m30s
party_delay = "0s"

Auto Reconnect

add to /bots/default/bot.toml

[reconnect]
ontimeout = ["1s", "2s", "5s", "10s", "30s", "1m", "5m", "repeat last"]
onkick = ["1s", "2s", "5s", "10s", "30s", "1m", "5m", "repeat last"]
onban = ["1s", "2s", "5s", "10s", "30s", "1m", "5m", "repeat last"]
onerror = ["30s", "repeat last"]
onshutdown = ["5m", "repeat last"]

Custom Commands and Aliases

!alias add come "!bot come"

!alias add [new command] "![command]"

[commands.alias]
come = "!bot come"
goaway = "!bot move 439" #439 is a channel number
###Youtube search and play###
yt = "!search from youtube (!param 0)"
ytp = "!xecute (!search from youtube (!param 0)) (!search play 0)"
yta = "!xecute (!search from youtube (!param 0)) (!search add 0)"
ytpl = "!x (!list clear YTPL1) (!list import YTPL1 (!param 0)) (!list play YTPL1)"
###Stream Shortcuts###
bbc = "!play https://stream.live.vc.bbcmedia.co.uk/bbc_world_service"
npr = "!play https://npr-ice.streamguys1.com/live.mp3"
80s = "!play http://c2.auracast.net:8048/stream"
hits = "!play https://34.105.16.234/alphacorporate-wikzfmaac-ibc4"
rock = "!play https://24463.live.streamtheworld.com:3690/WQXAFM.mp3"
kissfm = "!list play kissfm"

Youtube-dl

Youtube-dl is required if you want to play music (or playlists) from YouTube, but Youtube-dl is old and doesn't always work. I found that using yt-dlp works better.

pipx install -U yt-dlp

[tools]
#Path to the youtube-dl binary or local git repository.
youtube-dl = { path = "/home/tsaudio/.local/bin/yt-dlp" }

*Bot admin must have the correct command aliases set up for this to work.
** On some servers, adding aliases requires admin permissions.