Custom-Bot
TeraOne-Features unter deinem eigenen Bot-Namen laufen lassen
Mit einem Custom-Bot läuft TeraOne unter deinem eigenen Discord-Bot-Account — mit deinem gewählten Namen, Avatar und Banner. Für deine Community sieht es so aus, als ob dein eigener Bot alle Features bereitstellt. Die technische Basis bleibt TeraOne.
Wann sinnvoll?
- Du möchtest Branding: Der Bot soll "GameServer-Bot" heißen, nicht "TeraOne"
- Du möchtest, dass Slash-Commands mit deinem Bot-Namen erscheinen
- Du betreibst mehrere Server und möchtest ein konsistentes Markenbild
Voraussetzungen
- Ein Discord-Account (kein separates Developer-Konto nötig, nur Registrierung im Developer-Portal)
- Der Bot muss mit Admin-Berechtigungen eingeladen werden
Schritt-für-Schritt-Einrichtung
Schritt 1: Discord Application erstellen
Öffne https://discord.com/developers/applications und klicke "New Application". Wähle einen Namen (dieser Name ist auch der Standard-Bot-Name). Klicke "Create".
Schritt 2: Bot-Token generieren
Öffne den Tab "Bot" in deiner Application. Klicke auf "Reset Token" und bestätige. Kopiere den Token sofort — er wird danach nicht mehr angezeigt.
Schritt 3: Privileged Gateway Intents aktivieren
Noch im Tab "Bot" unter "Privileged Gateway Intents" müssen alle drei Intents aktiviert sein:
- SERVER MEMBERS INTENT → AN
- PRESENCE INTENT → AN
- MESSAGE CONTENT INTENT → AN
Schritt 4: Name, Avatar und Banner
Im Tab "Bot" kannst du Username und Avatar des Bots setzen. Im Tab "General Information" kannst du einen App-Icon und eine Beschreibung hinterlegen. Banner und andere Profildetails setzt du nach dem ersten Login des Bots über Discord-Einstellungen.
Schritt 5: Einladungslink generieren
Öffne den Tab "Installation". Unter "Default Install Settings" stelle sicher, dass "guild_install" aktiviert ist. Kopiere den generierten Install-Link (oder erstelle ihn manuell mit scope bot+applications.commands und permissions 8 für Administrator).
Schritt 6: Bot einladen
Öffne den Einladungslink in deinem Browser, wähle deinen Server und bestätige. Der Bot benötigt Administrator-Rechte sowie den Scope applications.commands, damit Slash-Commands registriert werden können.
Schritt 7: Token im TeraOne-Dashboard eintragen
Öffne Dashboard → Einstellungen → Custom-Bot. Füge den Token in das Token-Feld ein und klicke "Speichern". TeraOne startet den Bot innerhalb weniger Sekunden.
Schritt 8: Warten bis Status "Online"
Im Dashboard siehst du unter dem Custom-Bot-Tab den aktuellen Status. Nach dem Speichern des Tokens dauert es bis zu 30 Sekunden, bis der Bot auf Discord als Online erscheint.
Was der Custom-Bot kann und nicht kann
Kann: Alle TeraOne-Module (Leveling, Moderation, AutoMod, Anti-Alt, Audit-Log, Willkommen, Reaction-Roles, YouTube, DayZ-Killfeed) unter eigenem Namen und Avatar. Bot-Presence (Name, Status, Activity) ist Custom-Bot-exklusiv — gilt nicht server-global.
Kann nicht: Eigene Slash-Commands jenseits der TeraOne-Befehle registrieren. Wenn du eigene Commands willst, benötigst du einen separaten Bot.
Token-Sicherheit
Behandle den Bot-Token wie ein Passwort. Speichere ihn nicht in öffentlichen Repositories oder Discord-Nachrichten.
Fehlersuche
- Status bleibt "Offline"
- Prüfe: Ist der Token exakt kopiert (kein Leerzeichen am Anfang/Ende)? Sind alle 3 Privileged Intents im Developer Portal aktiviert? Hat der Bot Administrator-Berechtigung auf dem Server?
- "Invalid Token"-Fehler im Dashboard
- Gehe ins Developer Portal → Reset Token → neuen Token kopieren → im Dashboard ersetzen. Alte Tokens werden nach einem Reset sofort ungültig.
- Slash-Commands erscheinen nicht in Discord
- Discord braucht bis zu 1 Stunde für globale Command-Registrierung nach Bot-Start. Prüfe außerdem, ob der Bot mit dem Scope applications.commands eingeladen wurde.
- Leveling gibt kein XP
- MESSAGE CONTENT INTENT fehlt wahrscheinlich. Im Developer Portal → Bot → Privileged Intents → Message Content → AN.
Häufige Fragen
- Kann ich denselben Custom-Bot-Token für mehrere Discord-Server nutzen?
- Nein. Jeder Discord-Server in TeraOne hat seinen eigenen Custom-Bot-Slot. Du musst für jeden Server eine eigene Discord Application anlegen.
- Was passiert mit dem TeraOne-Standardbot, wenn ich einen Custom-Bot aktiviere?
- TeraOne zieht sich zurück: Auf deinem Server übernimmt der Custom-Bot alle Funktionen. Der TeraOne-Standardbot ist weiterhin auf dem Server, aber inaktiv für deine Guild.
- Wie viele Slash-Commands registriert TeraOne beim Custom-Bot?
- TeraOne registriert dieselben Slash-Commands wie beim Standard-Bot: /rank, /leaderboard, /streak, /ban, /kick, /mute usw. Custom-Commands darüber hinaus sind nicht möglich.