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.

Wenn der Status nach 60 Sekunden noch "Offline" zeigt, prüfe: Sind die Intents aktiviert? Ist der Token korrekt eingetragen (kein führendes/nachfolgendes Leerzeichen)?

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.
Custom-Bot · TeraOne Docs · TeraOne