Troubleshooting

Slash-Commands erscheinen nicht

• guildId leer → Commands sind global registriert (~1 h Verzögerung). Trage die guildId ein → sofort verfügbar.
• Bot ohne Scope applications.commands eingeladen → neu einladen (siehe Discord-Bot erstellen).

Bot startet nicht / Fehler beim Login

• „Kein Bot-Token” / „Keine Client-ID” → token/clientId fehlen. Prüfe config.json bzw. DISCORD_TOKEN/DISCORD_CLIENT_ID.
• Ungültiger Token → im Developer Portal Reset Token und neu eintragen.

Bot joint, aber kein Ton

1. Hat der Bot im Channel die Rechte Connect und Speak?
2. Erlaubt der Server/Container ausgehende Verbindungen zur Audioquelle?
3. Ist die Quelle erreichbar (Stream-URL testweise im Browser öffnen)?

YouTube spielt nicht (mehr)

Die YouTube-Extraktion bricht regelmäßig – dann hilft ein aktuelles yt-dlp:

• Docker: neues Image ziehen (docker compose pull && docker compose up -d). Das Image wird ohnehin wöchentlich neu gebaut.
• Lokal: bin/yt-dlp -U.

„Missing Access”

Dem Bot fehlen Rechte im Ziel-Channel/-Server oder er ist nicht korrekt eingeladen. Rollen-/Kanalrechte prüfen und ggf. neu einladen.

Bot ist nach Server-Reboot offline

Nur mit restart: unless-stopped (bzw. always) startet der Container nach einem Reboot automatisch. Ein direkt gestarteter Node-Prozess tut das nicht – dafür Docker oder einen systemd-Dienst nutzen.

Auto-Join-Änderung ist nach Neustart weg

/autojoin speichert in der config.json unter CONFIG_PATH. Im Container muss /data ein Volume sein, sonst geht der Stand beim Neustart verloren.