Hallo TeamSpeak-Freunde! Seid ihr es leid, dass eure TS3-Sitzungen leise und trist sind oder dass ihr euch ständig um manuelle Verwaltungsaufgaben kümmern müsst? Stellt euch vor, ein virtueller DJ spielt eure Lieblingssongs, während ein unsichtbarer Helfer den Server sauber hält und Regeln durchsetzt. Klingt gut, oder? Genau das ermöglichen Music- und Verwaltungs-Bots in TeamSpeak 3!
In diesem umfassenden Guide zeigen wir euch Schritt für Schritt, wie ihr solche Bots auf eurem Server implementiert, damit euer TS3-Erlebnis auf das nächste Level gehoben wird. Egal ob ihr ein erfahrener Admin seid oder gerade erst mit TS3 beginnt – wir machen es euch einfach.
### Warum überhaupt einen Bot? Die Vorteile auf einen Blick
Bevor wir ins Detail gehen, lasst uns kurz die Frage klären: Wozu brauche ich überhaupt einen Bot? Die Antwort ist simpel: Automatisierung und Unterhaltung!
1. **Music-Bots:**
* **Ständige Verfügbarkeit:** Ein Bot spielt Musik, auch wenn niemand aktiv im Kanal ist oder der Bot-Besitzer offline geht. Ideal für Gaming-Clans oder als Hintergrundmusik.
* **Entlastung der Clients:** Niemand muss Bandbreite oder Systemressourcen opfern, um Musik zu streamen. Der Bot übernimmt das.
* **Vielfältige Quellen:** Die meisten Bots unterstützen YouTube, SoundCloud und andere Streaming-Dienste.
* **Interaktive Steuerung:** Nutzer können oft über Chatbefehle oder ein Webinterface Songs vorschlagen, skippen oder die Lautstärke anpassen.
2. **Verwaltungs-Bots (Admin-Bots):**
* **Automatisierung:** Begrüßen neue Benutzer, vergeben Rollen basierend auf Beitrittszeiten, überprüfen Server-Aktivitäten oder verschieben AFK-Nutzer automatisch.
* **Sicherheit:** Erkennen und melden von Spam, beleidigendem Verhalten oder unerwünschten VPN-Verbindungen.
* **Server-Wartung:** Automatische Backups, Channel-Aufräumarbeiten oder Benachrichtigungen bei Problemen.
* **Entlastung der Administratoren:** Admins müssen weniger Zeit mit Routineaufgaben verbringen und können sich auf wichtigere Dinge konzentrieren.
Kurz gesagt: Bots machen euren TeamSpeak 3 Server effizienter, sicherer und unterhaltsamer.
### Die Grundlagen: Was ihr benötigt, bevor es losgeht
Bevor wir uns in die Installation stürzen, gibt es ein paar grundlegende Voraussetzungen, die ihr erfüllen solltet:
1. **Ein eigener TS3-Server:** Dies ist offensichtlich. Ihr benötigt administrative Rechte (ServerQuery-Zugang) auf eurem TS3-Server. Wenn ihr einen Server bei einem Hoster gemietet habt, fragt nach den ServerQuery-Zugangsdaten.
2. **Ein Virtueller Privater Server (VPS) oder Dedicated Server:** Bots laufen nicht direkt auf eurem Heim-PC, es sei denn, dieser ist 24/7 online und leistungsstark genug. Für zuverlässigen Bot-Betrieb ist ein VPS oder ein eigener Root-Server mit einem Linux-Betriebssystem (z.B. Ubuntu, Debian oder CentOS) die beste Wahl. Kostenlose Optionen gibt es selten, aber günstige VPS sind schon für wenige Euro im Monat erhältlich.
3. **Grundkenntnisse in Linux:** Ihr solltet euch mit grundlegenden Befehlen in der Linux-Kommandozeile (Shell) auskennen, insbesondere mit SSH (Secure Shell) für den Zugriff auf euren Server.
4. **SSH-Client:** Programme wie PuTTY (Windows) oder der Terminal (macOS/Linux) ermöglichen euch den Zugriff auf euren Server.
Habt ihr diese Punkte abgehakt? Wunderbar, dann kann es losgehen!
### Die Bot-Auswahl: Welcher Bot ist der Richtige für dich?
Es gibt eine Vielzahl von Bots für TeamSpeak 3, jeder mit seinen Stärken und Schwächen. Wir konzentrieren uns auf zwei beliebte und leistungsstarke Optionen als Beispiele:
* **Für Musik:** Der SinusBot
Der SinusBot ist der Goldstandard unter den TS3-Music-Bots. Er ist stabil, ressourcenschonend und bietet Funktionen wie YouTube, SoundCloud, lokale Dateien, Playlists und eine intuitive Weboberfläche. Der Aufwand bei der Installation lohnt sich definitiv.
* **Für Verwaltung:** JTS3ServerMod
Der JTS3ServerMod ist ein vielseitiger Verwaltungs-Bot (in Java geschrieben), der unzählige Funktionen wie Begrüßungsnachrichten, AFK-Mover, Channel-Cleaner und Server-Backups bietet. Er ist modular aufgebaut, sodass ihr nur benötigte Funktionen aktiviert. Alternativen sind der TS3-PHP-Framework oder andere spezifische Skripte.
Für diesen Guide werden wir die Installation des SinusBot detailliert behandeln, da er häufig nachgefragt wird und eine typische Bot-Installation gut veranschaulicht. Die Prinzipien lassen sich aber auf andere Bots übertragen.
### Schritt-für-Schritt-Anleitung: Installation des SinusBot (Music-Bot)
Wir gehen davon aus, dass ihr einen **Linux-VPS** mit Ubuntu 20.04 (oder neuer) oder Debian 11 (oder neuer) verwendet. Passt die Befehle gegebenenfalls an eure Distribution an.
**Vorbereitung eures Linux-Servers (Root-Zugriff über SSH):**
1. **System aktualisieren:**
Bevor ihr Software installiert, solltet ihr euer System auf den neuesten Stand bringen:
„`bash
sudo apt update && sudo apt upgrade -y
„`
2. **Notwendige Abhängigkeiten installieren:**
Der SinusBot benötigt einige Bibliotheken und Programme, um korrekt zu funktionieren (z.B. FFmpeg für Audio-Decodierung, ALSA für Sound-Emulation):
„`bash
sudo apt install -y curl ffmpeg libglib2.0-0 libsndfile1 libopus0 libgconf-2-4 libnss3 libasound2 python3 python3-pip
„`
3. **Eigenen Benutzer für den Bot erstellen (Sicherheit):**
Es ist gute Praxis, den Bot nicht als Root laufen zu lassen. Erstellt einen neuen Benutzer, z.B. `sinusbot`:
„`bash
sudo adduser –disabled-login –gecos „” sinusbot
„`
Dieser Benutzer hat keine Login-Shell und kein Passwort, was die Sicherheit erhöht.
4. **Zum neuen Benutzer wechseln:**
„`bash
sudo su – sinusbot
„`
Von nun an arbeiten wir als der Benutzer `sinusbot`.
**Installation des SinusBot:**
1. **SinusBot herunterladen:**
Besucht die offizielle SinusBot-Website (www.sinusbot.com/prebuild/). Sucht nach der neuesten Linux-Version (meist die `amd64.tar.bz2` für 64-Bit-Systeme) und kopiert den Download-Link.
Ladet ihn auf euren Server herunter:
„`bash
curl -O https://www.sinusbot.com/prebuild/SinusBot-0.14.4-00100f7.tar.bz2 # Link anpassen!
„`
*Hinweis: Der Link ist nur ein Beispiel. Achtet darauf, den aktuellen Link von der SinusBot-Website zu verwenden!*
2. **Entpacken der Dateien:**
„`bash
tar -xjvf SinusBot-*.tar.bz2
„`
Dies erstellt einen Ordner `SinusBot`.
3. **In das SinusBot-Verzeichnis wechseln:**
„`bash
cd SinusBot
„`
4. **TeamSpeak 3 Client herunterladen (Wichtig!):**
Der SinusBot benötigt einen TeamSpeak 3 Client, um sich mit dem Server zu verbinden und Audio zu streamen. Geht auf die offizielle TeamSpeak-Website (www.teamspeak.com/downloads) und kopiert den Download-Link für den 64-Bit Linux Client (`client_linux_amd64-…`).
Ladet ihn in euer SinusBot-Verzeichnis herunter:
„`bash
curl -O https://files.teamspeak-services.com/releases/client/3.5.6/TeamSpeak3-Client-linux_amd64-3.5.6.run # Link anpassen!
chmod +x TeamSpeak3-Client-linux_amd64-3.5.6.run
./TeamSpeak3-Client-linux_amd64-3.5.6.run
„`
Folgt den Anweisungen. Wenn ihr nach einem Installationspfad gefragt werdet, gebt den *aktuellen* Ordner (`./`) an, damit der Client im SinusBot-Verzeichnis entpackt wird. Bestätigt die Lizenzbedingungen.
5. **Ersten Start des SinusBot:**
Jetzt wird es spannend! Startet den Bot zum ersten Mal:
„`bash
./sinusbot
„`
Der Bot generiert Konfigurationsdateien und fragt euch nach einem Admin-Passwort für die Weboberfläche. Legt ein sicheres Passwort fest. Die Standard-Portnummer ist 8087.
Wenn alles klappt, seht ihr Ausgaben wie „HTTP-Server listening on 0.0.0.0:8087”. Drückt `Strg+C`, um den Bot wieder zu beenden.
**Konfiguration des SinusBot über das Webinterface:**
1. **Zugriff auf das Webinterface:**
Öffnet euren Webbrowser und gebt die IP-Adresse eures VPS gefolgt von Port 8087 ein, z.B. `http://DEINE_VPS_IP:8087`.
Meldet euch mit `admin` und dem zuvor festgelegten Passwort an.
2. **TeamSpeak 3 Server hinzufügen:**
Im Webinterface navigiert ihr zu „Settings” (Zahnrad-Symbol oben rechts).
Klickt auf „Instances” (Instanzen).
Klickt auf „Add New Instance”.
* **TS3 Server IP/Port:** Die IP-Adresse eures TS3-Servers (z.B. `ts.eurer-server.de` oder `123.45.67.89`).
* **ServerQuery Username & Password:** Dies sind die Anmeldedaten für den ServerQuery-Zugriff auf euren TS3-Server. Diese bekommt ihr vom Hoster oder habt sie als Serverbesitzer selbst generiert.
* **Nickname:** Der Name, den der Bot auf eurem TS3-Server tragen soll (z.B. „Mein MusicBot”).
* **Default Channel:** Der Kanal, in den der Bot standardmäßig wechseln soll.
* **Initial Server Group ID:** Optional, um dem Bot eine bestimmte Servergruppe zu geben (z.B. „Bot”).
Klickt auf „Save”.
3. **Bot starten und verbinden:**
Geht zurück zum Haupt-Dashboard des SinusBot-Webinterfaces. Ihr solltet eure neu hinzugefügte Instanz sehen. Klickt auf den Play-Button, um sie zu starten. Der Bot sollte sich nun mit eurem TeamSpeak 3 Server verbinden und in den angegebenen Kanal wechseln.
**Den SinusBot im Hintergrund laufen lassen (Systemd Service):**
Damit der Bot auch nach dem Schließen eurer SSH-Verbindung weiterläuft, richten wir einen Systemd-Dienst ein.
Beendet zuerst euren SSH-Login als `sinusbot` und kehrt zum Root-Benutzer zurück:
„`bash
exit
„`
Erstellt die Systemd-Service-Datei:
„`bash
sudo nano /etc/systemd/system/sinusbot.service
„`
Fügt folgenden Inhalt ein:
„`
[Unit]
Description=SinusBot by Michael Friese
After=network.target
[Service]
Type=forking
User=sinusbot
WorkingDirectory=/home/sinusbot/SinusBot
ExecStart=/home/sinusbot/SinusBot/sinusbot
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
„`
Speichert die Datei (Strg+O, Enter, Strg+X).
Ladet die Systemd-Konfiguration neu und startet den Dienst:
„`bash
sudo systemctl daemon-reload
sudo systemctl start sinusbot
sudo systemctl enable sinusbot
„`
Überprüfen, ob der Bot läuft:
„`bash
sudo systemctl status sinusbot
„`
Es sollte „active (running)” angezeigt werden.
Herzlichen Glückwunsch! Euer Music-Bot läuft nun 24/7 auf eurem VPS!
### Den JTS3ServerMod (Verwaltungs-Bot) hinzufügen (Kurzer Überblick)
Die Installation des JTS3ServerMod ist etwas einfacher, da er in Java geschrieben ist und keine speziellen TeamSpeak-Client-Abhängigkeiten hat.
1. **Java installieren:**
Stellt sicher, dass Java auf eurem VPS installiert ist (Java 11 oder neuer wird empfohlen):
„`bash
sudo apt install -y openjdk-11-jre-headless
„`
2. **JTS3ServerMod herunterladen:**
Besucht die offizielle Website (github.com/Splamy/JTS3ServerMod/releases) und ladet die neueste `.jar`-Datei herunter. Erstellt einen neuen Benutzer und ein Verzeichnis, ähnlich wie beim SinusBot.
„`bash
sudo adduser –disabled-login –gecos „” jts3bot
sudo su – jts3bot
mkdir jts3servermod && cd jts3servermod
curl -O https://github.com/Splamy/JTS3ServerMod/releases/download/v1.0.12/JTS3ServerMod.jar # Link anpassen!
„`
3. **Konfiguration:**
Startet den Bot einmalig, um die Konfigurationsdatei zu generieren:
„`bash
java -jar JTS3ServerMod.jar
„`
Beendet ihn wieder (Strg+C). Bearbeitet die generierte `config.ini` im Ordner. Hier müsst ihr eure TeamSpeak 3 ServerQuery-Zugangsdaten eintragen (IP, Port, Query-Login, Query-Passwort) und die gewünschten Funktionen aktivieren/konfigurieren (z.B. Willkommensnachrichten, AFK-Mover).
4. **Bot starten und persistent machen:**
Startet den Bot erneut mit `java -jar JTS3ServerMod.jar` (oder als Systemd-Dienst, analog zum SinusBot, aber mit `ExecStart=/usr/bin/java -jar /home/jts3bot/jts3servermod/JTS3ServerMod.jar`).
### Wichtige Hinweise zu Berechtigungen und Sicherheit
* **ServerQuery-Rechte:** Gebt eurem ServerQuery-Benutzer nur die absolut notwendigen Rechte. Für einen Music-Bot sind das primär Sprachrechte, Kanal-Wechselrechte und die Möglichkeit, Nicknames zu ändern. Für Admin-Bots können mehr Rechte (z.B. Kicken/Bannen, Channel erstellen) nötig sein. Niemals den vollen Admin-ServerQuery-Account für Bots verwenden, es sei denn, ihr wisst genau, was ihr tut!
* **Token-Management:** Erstellt separate ServerQuery-Tokens für jeden Bot, falls euer Hoster dies erlaubt.
* **Firewall:** Stellt sicher, dass die Ports 8087 (für SinusBot-Webinterface) und der TeamSpeak 3 Query-Port (standardmäßig 10011) auf eurem VPS freigegeben sind, falls ihr eine Firewall (z.B. UFW, Firewalld) aktiviert habt.
* **Updates:** Haltet eure Bots und euer Betriebssystem regelmäßig auf dem neuesten Stand, um Sicherheitslücken zu schließen.
### Häufige Probleme und Lösungsansätze
* **Bot verbindet sich nicht mit TS3:**
* Überprüft eure ServerQuery-Anmeldedaten (IP, Port, Benutzername, Passwort) im Bot-Konfigurationsinterface.
* Stellt sicher, dass der Query-Port (standardmäßig 10011) auf eurem VPS und Server erreichbar ist.
* Überprüft die Logs des Bots (oft im Bot-Verzeichnis unter `logs/`).
* **Kein Sound vom Music-Bot:**
* Überprüft, ob der TeamSpeak 3 Client korrekt im SinusBot-Verzeichnis installiert wurde.
* Stellt sicher, dass FFmpeg und ALSA installiert sind.
* Prüft die Lautstärke des Bots im TS3-Client und im Bot-Webinterface.
* **Webinterface nicht erreichbar:**
* Überprüft, ob der Bot läuft (mit `sudo systemctl status sinusbot`).
* Stellt sicher, dass der Port 8087 auf eurem VPS nicht durch eine Firewall blockiert ist.
* Überprüft, ob ihr die korrekte IP-Adresse des VPS verwendet.
### Fazit
Einen Music- oder Verwaltungs-Bot zu eurem TeamSpeak 3 Server hinzuzufügen, ist ein großer Schritt, um eure Community zu bereichern und euch das Leben als Administrator zu erleichtern. Auch wenn die Installation auf einem Linux-VPS anfangs etwas komplex wirken mag, ist es mit dieser Anleitung und ein wenig Geduld machbar.
Ihr habt nun die Werkzeuge, eurem TS3-Server eine neue Dimension zu verleihen – sei es durch Musik-Playlists oder intelligente Automatisierung, die euren Alltag vereinfacht. Experimentiert mit den verschiedenen Funktionen der Bots und passt sie an die Bedürfnisse eurer Community an. Viel Spaß beim Botting!