JTS3ServerMod Tutorial: Eigenen TeamSpeak 3 Bot unter Linux hosten :: ITv4.de
JTS3ServerMod Tutorial: Eigenen TeamSpeak 3 Bot unter Linux hosten
Dieser Beitrag wurde vor 2 Jahren zuletzt überarbeitet. Es kann daher durchaus vorkommen, dass Verlinkungen nicht mehr gültig sind, sich Oberflächen verändert haben oder Funktionen gar nicht mehr so funktionieren, wie hier erklärt. Es wäre daher super, wenn du in so einem Falle über die Fehler melden-Funktion Feedback geben würdest. Vielen Dank!

Mit dem JTS3ServerMod kann man ganz leicht seinen eigenen TeamSpeak 3 Bot laufen lassen. Dieser hilft einem ungemein beim Kicken von Clients mit unangemessenem Namen, verschiebenen von inaktiven Clients und vielem mehr. Die Einrichtung unter Linux zeige ich hier.


Vorbereitung

Da der Bot unter Java läuft, stellst du zunächst sicher, dass auf deinem vServer Java installiert ist. Falls dies nicht der Fall ist, kannst du Java mit einem Befehl installieren:

apt-get -y install default-jre

Außerdem solltest du noch einen neuen Benutzer anlegen, beispielsweise namens JTS3Bot.

Lade dir auf deinen PC die neueste Version des Bots aus dem Forum herunter. Den Downloadlink findest du im Thread ganz unten bei -= Download =-.

Da du später interne Daten aus deinem Server auslesen musst, solltest du noch YaTQA auf deinem PC herunterladen und installieren.

In YaTQA gibst du die Serve-IP, den Benutzername serveradmin und das serveradmin-Passwort ein, um dich zu verbinden.


Bot einrichten

Um mit der Einrichtung des Bots zu starten, entpackst du die zuvor heruntergeladene JTS3ServerMod_X.X.X.zip. Begib dich in /JTS3ServerMod/config/server1/ und lösche hier die JTS3ServerMod_server.cfg.

Navigiere einen Ordner zurück, in /config/. Kopiere hier die JTS3ServerMod_server_example.cfg in den Ordner /server1/ und benenne die Datei um in JTS3ServerMod_server. Editiere nun die JTS3ServerMod_server.cfg mit einem beliebigen Editor.

Hier werden alle Einstellungen des Bots gesetzt, beginnend mit den allgemeinen Daten und Verbindungs-Informationen des TeamSpeak Servers.

Zeile & Einstellung Bedeutung
6 (ts3_server_address) IP-Adresse des TeamSpeak-Servers
12 (ts3_server_query_password) ServerQuery Admin Passwort
24 (bot_channel_id) Optional die Channel-ID des Channels, in den der Bot soll
33 (bot_check_interval) Wie oft der Bot in der Sekunde reagieren soll. Bei 1 dauert es somit maximal 1 Sekunde, bis er bei z. B. einem Blacklist-Nickname handelt
46 (bot_server_query_name) Name des Bots
52 (bot_date_pattern) Datum-Format. dd.MM.yyy HH:mm:ss wäre es für Deutschland
57 (bot_timezone) Zeitzone. Für Deutschland DE
59 (bot_connect_forever) Ob der Bot versuchen soll neu zu verbinden, wenn TeamSpeak-Server down
69 (bot_admin_list) Die Eindeutige-ID von den Admins, die die Admin-Befehle des Bots nutzen dürfen. ID liest man mit Strg + I aus
116 (bot_functions_disabled) Bot-Funktionen, nicht verwendet werden soll. Beispielsweise "advertising" für die Funktion Advertising

Bot-Funktion konfigurieren

Als Nächster Schritt werden alle Funktionen konfiguriert, die verwendet werden sollen. Da alle Einstellungen kommentiert sind, sollte dies selbsterklärend sein. Dennoch zeige ich am Beispiels der Funktion MuteMover, wie man eine Funktion einrichtet.

Die Funktions-Namen findest du im Bereich der Zeile # Function list. Der Name steht nach dem Doppelpunkt der Funktion. Für MuteMover ist dies mute. Scrolle nun also in der Config herunter, bis du zu den Zeilen der Funktion kommst, die alle mit mute_ anfangen.

Da du für die Einstellung gleich Channel-ID's benötigst, brauchst du jetzt YaTQA. Hier klickst du im oberen Menü auf Server und machst in der Liste einen Doppelklick auf deinen Server. Wieder im oberen Menü klickst du diesmal auf Benutzer. Nun siehst du in der linken Spalte alle Channel des Servers. Mit einem Klick auf einen erhältst du rechts unteranderem die Channel-ID.

Screenshot

Die Server-Gruppen-ID's lassen sich im TeamSpeak-Client auslesen. Begib dich hierzu zu Rechte Server Gruppen. Die Zahl in der Klammer ist die Server-Gruppen-ID.

Alle Zeilen der Konfiguration findest du in der folgenden Tabelle mit Erklärung. Darunter befindet sich noch ein Beispiel wie eine Konfiguration aussehen kann, ohne Kommentare.

Einstellung Bedeutung
mute_moveback Client zurück verschieben, wenn er sich enmuted hat? Schreibe hier yes oder no
mute_headphone Zählt Headset-muten zum Muten? Schreibe hier yes oder no
mute_microphone Zählt Mikrofon-muten zum Muten? Schreibe hier yes oder no
mute_headphone_hardware Verschieben auch aktivieren, wenn kein Headset/Lautsprecher angeschlossen ist
mute_microphone_hardware Verschieben auch aktivieren, wenn kein Mikrofon aktiviert ist
mute_condition_mode Müssen alle Bedingungen von oben zutreffen oder nur eine? Schreibe hier all oder one
mute_channel_id Channel-ID des Channels, wo hin verschoben werden soll
mute_delay Delay in Sekunden, bis Client verschoben wird
mute_channel_list Channel-ID's von Channeln, die ignoriert bzw. welche überwacht werden sollen. Getrennt mit Komma ohne Leerzeichen
mute_channel_list_mode Einstellung darüber: Sollen diese Channel ignoriert oder nur diese überwacht werden? Schreibe hier ignore oder only
mute_group_list Servergruppen-ID's, die ignoriert bzw. welche überwacht werden sollen. Getrennt mit Komma ohne Leerzeichen
mute_group_list_mode Einstellung darüber: Sollen diese Gruppen ignoriert oder nur diese überwacht werden? Schreibe hier ignore oder only
mute_message_mode Nachricht an den Client, dass er verschoben wurde. Möglichkeiten: poke, chat oder none
mute_file Pfad zur Datei, in der die Nachricht steht. Befindet sich im Ordner der Config.

Im folgenden eine Beispiel-Konfiguration dieser Funktion ohne Kommentare.

mute_moveback = yes
mute_headphone = yes
mute_microphone = no
mute_headphone_hardware = yes
mute_microphone_hardware = yes
mute_condition_mode = one
mute_channel_id = 15
mute_delay = 120
mute_channel_list = 1,2,6,9
mute_channel_list_mode = only
mute_group_list = 26,35
mute_group_list_mode = ignore
mute_message_mode = none
mute_file = %apphome%config/server1/mutemessages.cfg

Bot starten

Der Bot wird nicht installiert, er muss lediglich gestartet werden. Daher ist das meiste auch schon getan, jetzt wird der Ordner JTS3ServerMod nur noch auf den Server hochgeladen. Melde dich per FTP mit dem neu erstellten Benutzer an und vergebe anschließend, falls noch nicht gesetzt, auf den Ordner und alles darunter die Rechte 0755.

Verbinde dich nun mit Putty mit dem Server und mache das Start-Script noch ausführbar: chmod +x jts3servermod_startscript.sh

Der Bot wird jetzt einfach gestartet. Screen ist nicht erforderlich, er läuft auch weiter, selbst wenn du Putty beendest: ./jts3servermod_startscript.sh start

Screenshot

Die Logs vom Bot findest du direkt im Hauptverzeichnis des Bots in der JTS3ServerMod_server1.log. Da noch nicht alle Funktionen eingerichtet sind, werden hier einige Fehler erscheinen. Wichtig ist jedoch erst einmal, dass der Bot mit dem TeamSpeak-Server verbunden ist.

Screenshot

Dass der Bot auch wirklich verbunden ist und auch läuft, kannst du im Client selbst auch jederzeit überprüfen. Nutze dazu im Server-Chat bzw. im Chat mit dem Bot den Befehl !botinfo. Du erhältst als Privat-Chat eine Antwort vom Bot. Mit dem Befehl !bothelp werden dir alle Befehle aufgelistet. Damit Änderungen wirksam werden, muss der Bot bei jeder Änderung neu geladen werden. Entweder mit !botreload oder in Putty per ./jts3servermod_startscript.sh restart

Zuletzt aktualisiert
17.03.2019
Drucken
War dieser Artikel hilfreich?
1
Hinterlasse einen Kommentar

Hast du Fragen, Probleme oder Anregungen? Hier kannst du öffentliches Feedback geben und anderen helfen.

Die mit * markierten Felder sind Pflichtfelder. Möchtest du über neue Antworten auf deinen Kommentar informiert werden, kannst du deine E-Mail-Adresse hinterlegen. Diese wird nicht veröffentlicht.

EurenikZ
EurenikZ

Ich bin Janis, 22 Jahre alt und komme aus Frankfurt am Main. Ich habe eine abgeschlossene IHK-Ausbildung zum Fachinformatiker für Systemintegration und arbeite als Junior IT-Administrator in einem IT-Systemhaus. Neben meinem vServer beschäftige ich mich viel mit Coden und meinen Webseiten sowie Telegram Bots.

Themen
IT-Wissensdatenbank

In der IT-Wissensdatenbank findest du leicht verständliche Erklärungen zu diversen IT-Themen!

Zur IT-Wissensdatenbank
Melde dich für den Newsletter an

Mit dem kostenlosen Newsletter wirst du gelegentlich über die neuesten Tipps & Tricks per E-Mail informiert!