Discord-Anwendung anlegen

VirtueBot ist ein Discord-Bot — jeder Bot braucht eine eigene Anwendung im Discord Developer Portal. Dieser Schritt geschieht im Browser, kostet nichts und dauert etwa 10 Minuten.

Am Ende hast du fünf Werte, die du beim Server-Setup eingeben musst:

1. Bot-Token
2. Client-ID (auch „Application ID")
3. Client-Secret
4. Einladungs-Link
5. Redirect-URL (eintragen ins Developer Portal, kein Wert für die Eingabe)

Zusätzlich brauchst du noch deine eigene Discord-User-ID — siehe Vorbereitung, Abschnitt 3.

Schritt 1 — Anwendung anlegen

1. Öffne https://discord.com/developers/applications und melde dich mit deinem Discord-Account an.
2. Klicke oben rechts auf „New Application".
3. Gib einen Namen ein (z. B. VirtueBot oder MeinServer-Bot).
4. Häkchen bei den Nutzungsbedingungen setzen → „Create".

Du landest auf der Anwendungs-Übersicht.

Schritt 2 — Bot-Identität

1. Im linken Menü auf „Bot" klicken.

2. Bei Bedarf bei „Username" den Namen deines Bots anpassen (so wird er im Discord erscheinen).

3. Optional: ein Profilbild hochladen.

4. Bei „Privileged Gateway Intents" beide Schalter einschalten:

   • ✅ Server Members Intent
   • ✅ Message Content Intent

   Diese sind für VirtueBot zwingend. Ohne sie funktionieren Mitgliederlisten, Willkommens-Nachrichten und die Auto-Moderation nicht.

5. „Save Changes" unten klicken.

⚠️ Falls dein Bot später auf mehr als 100 Discord-Servern eingesetzt wird, verlangt Discord eine Verifizierung der privilegierten Intents. Für den Eigenbedarf ist das nicht nötig.

Schritt 3 — Bot-Token kopieren

1. Auf der Bot-Seite scrollst du zum Abschnitt „Token".
2. Klick auf „Reset Token" → „Yes, do it".
3. Der neue Token wird einmalig angezeigt — kopiere ihn sofort und lege ihn an einem sicheren Ort ab (Passwort-Manager).

🔒 Wichtig: Der Bot-Token ist wie ein Passwort. Gib ihn niemandem, lade ihn nicht in öffentliche Repos, und falls er versehentlich rausgeht: hier auf der gleichen Seite einfach „Reset Token" → der alte ist sofort ungültig.

Den kopierten Token brauchst du beim Setup als DISCORD_TOKEN.

Schritt 4 — Client-ID kopieren

1. Im linken Menü auf „General Information" klicken.
2. Bei „Application ID" auf „Copy" klicken.

Das ist deine Client-ID (DISCORD_CLIENT_ID).

Schritt 5 — Client-Secret erzeugen

1. Im linken Menü auf „OAuth2" klicken.
2. Beim Abschnitt „Client Secret" auf „Reset Secret" → „Yes, do it".
3. Den neuen Secret-Wert kopieren und sicher aufbewahren.

Das ist dein Client-Secret (DISCORD_CLIENT_SECRET).

Schritt 6 — Einladungs-Link erzeugen

Mit dem Einladungs-Link fügst du den Bot zu deinen Discord-Servern hinzu.

1. Bleibe im Bereich „OAuth2" und scrolle zu „OAuth2 URL Generator".

2. Im Abschnitt „Scopes" beide Häkchen setzen:

   • ✅ bot
   • ✅ applications.commands

3. Im Abschnitt „Bot Permissions" (erscheint nach Schritt 2):

   Empfohlen für einfaches Setup:

   • ✅ Administrator

   Damit hat der Bot alle Rechte, die er für jedes seiner Features braucht — du musst dich um keine einzelnen Berechtigungen kümmern. Die meisten Self-Hoster nehmen diese Option, weil sie auf dem eigenen Server eh die volle Kontrolle haben.

   Alternativ (für Vorsichtige): wähle die Rechte einzeln. Welche Rechte du dann mindestens brauchst, steht weiter unten unter „Berechtigungen einzeln vergeben".

4. Unten auf der Seite siehst du die „Generated URL". Klick auf „Copy".

Das ist dein Einladungs-Link (OAUTH_LINK).

Schritt 7 — Redirect-URL hinterlegen

Damit Mitglieder sich nach dem Discord-Login zurück ins Webpanel finden, muss die Rück-Adresse im Developer Portal eingetragen sein.

1. Bleibe im Bereich „OAuth2" und scrolle hoch zu „Redirects".
2. Auf „Add Another" klicken.
3. Trage die URL je nach Zugriffsmodus ein:

Du kannst auch mehrere Redirect-URLs eintragen — z. B. lokal zum Testen plus deine Tunnel-Domain für Production.

4. „Save Changes" unten klicken.

Schritt 8 — Bot zum Discord-Server einladen

1. Den Einladungs-Link aus Schritt 6 im Browser öffnen.
2. Im Dropdown deinen Discord-Server wählen.
3. „Authorize" klicken.
4. Captcha lösen.

Der Bot erscheint jetzt in der Mitgliederliste deines Discord-Servers. Er ist offline, weil er noch nicht läuft — das ändert sich, sobald du das Server-Setup abgeschlossen hast.

Werte-Übersicht

Lege dir die Werte griffbereit, z. B. als temporäre Notiz:

DISCORD_TOKEN            = aus Schritt 3
DISCORD_CLIENT_ID        = aus Schritt 4
DISCORD_CLIENT_SECRET    = aus Schritt 5
OAUTH_LINK               = aus Schritt 6

Die Redirect-URL aus Schritt 7 brauchst du nicht beim Setup einzugeben — sie wird vom Bot automatisch verwendet, sobald Discord sie im Developer Portal kennt.

Berechtigungen einzeln vergeben (für Vorsichtige)

Wenn du Administrator nicht vergeben möchtest, kannst du in Schritt 6 statt des Administrator-Häkchens diese Berechtigungen einzeln auswählen. Damit funktionieren alle Features von VirtueBot:

Hinweis: Wenn du eine Berechtigung weglässt, läuft das entsprechende Feature einfach nicht — der Bot meldet im Panel, dass ihm Rechte fehlen.

Wenn dir das zu viel zu konfigurieren ist: nimm einfach Administrator. Der Bot läuft auf deinem eigenen Discord-Server, dem du sowieso vertraust.

Bot später auf weitere Server einladen

Du kannst denselben Bot auf mehreren Discord-Servern nutzen — im Free Tier auf einem, mit aktiver Lizenz auf beliebig vielen.

Einfach den Einladungs-Link aus Schritt 6 erneut öffnen und im Dropdown einen anderen Server wählen.

Weiter geht's

Jetzt hast du alles bereit. Weiter mit der Installation.