Um die einzelnen Discord-Plugins nutzen zu können, muss ein Discord-Server angelegt sein. Auf diesem Server musst du Adminrechte haben. Ein Discord-Server wird wie folgt angelegt:

1. Erstelle dir ein Discord-Konto, insofern du noch keins hast.
2. Melde dich in deinem Discord-Konto an.
3. Klicke in der linken Leiste auf das + für Server hinzufügen.
4. Wähle Create My Own aus.
5. Gib dem Server einen Namen und wahlweise ein Serverlogo.
6. Klicke auf den Button Erstellen.

Herzlichen Glückwunsch, du hast nun einen eigenen Discord-Server erstellt.

Für die Verwendung der Discord-Plugins ist es notwendig eine eigene Discord-App und einen dazugehörigen Discord-Bot zu erstellen. Gehe wie folgt vor:

1. Gehe in die Übersicht deiner Discord-Anwendungen.
2. Klicke auf den Button New Application und gib deiner Anwendung einen Namen. Klicke danach auf den Button Create.
   • Als Ergebnis solltest du nun die angelegt Anwendung sehen und dich im Bereich General Information befinden.
3. Klicke im linken Menü auf Bot.
4. Aktuell dürfte es noch keinen Bot geben. Klicke also auf den Button Add Bot und bestätige die Frage mit dem Button Yes, do it!.
5. Du solltest nun den Bot sehen.

Damit hast du nun eine Anwendung und einen Bot angelegt.

Damit dein Bot mit deinem Discord-Server interagieren kann, muss dieser vorher mit deinem Server verbunden sein. Dies geht wie folgt:

1. Gehe in die Übersicht deiner Anwendungen.
2. Wähle deine Anwendung aus.
3. Notiere dir die Client ID unter General Information.
4. Rufe folgende URL auf https://discord.com/api/oauth2/authorize?client_id=<CLIENT_ID>&scope=bot&permissions=8
   • <CLIENT_ID> muss durch deine Client ID aus Punkt 3 ersetzt werden.
   • Anmerkung: permissions=8 steht dafür, dass der Bot volle Adminrechte bekommt.
5. Wähle bei Bot hinzufügen zu deinen Server aus und klicke auf den Button Weiter.
6. Überprüfe ob die Rechte mit deiner Auswahl übereinstimmen und klicke auf den Button Autorisieren.
7. Bestätige, falls notwendig, dass du kein Roboter bist

Dein Bot ist nun mit deinem Server verbunden.

1. Melde dich in dem Discord-Konto an.
2. Klicke unten links auf Benutzereinstellungen.
3. Wähle unter der Kategorie App-Einstellungen den Menüpunkt Erscheinungsbild.
4. Aktiviere die Option Entwicklermodus in der Kategorie Erweitert.

Um deinen Bot im WSC verwenden zu können, musst du diesen im ACP hinzufügen. Voraussetzung ist, dass der Entwicklermodus aktiv ist und der Bot auf deinem Server ist. Gehe wie folgt vor:

1. Melde dich in deinem ACP mit deinem Admin-Konto an.
2. Gehe zu Konfiguration -> Discord-Bots -> Discord-Bot hinzufügen.
3. Den Bot-Token, die Client-ID und den Client-Secret findest du in deiner Discord-Anwendung (siehe nachfolgende Unterpunkte).
   1. Wähle deine Anwendung aus.
   2. Unter OAuth2 kannst du deine Client ID einsehen.
   3. Die Client Secret bekommst du in OAuth2 wenn du darunter auf den Button Reset Secret klickst. (Achtung: Jedes mal wenn du darauf klickst, werden vorherige Secrets invalide gemacht.)
   4. Klicke links auf den Menüpunkt Bot und klicke bei Token den Button Reset Token. (Achtung: Jedes mal wenn du darauf klickst, werden vorherige Tokens invalide gemacht.)
4. Füge die Informationen aus Punkt 3 ein.
5. Um die Server-ID zu erhalten musst du nun wie folgt vorgehen:
   1. Melde dich in deinem Discord-Konto an.
   2. Auf der linken Seite siehst du die Übersicht deiner Server.
   3. Klicke mit der rechten Maustaste auf deinen Server und klicke auf ID kopieren.
   4. Die kopierte ID gibst du nun bei Server ID ein.
6. Klicke auf den Button Absenden.

Dein Bot ist nun in deiner WSC-Instanz angelegt.

Damit Discord-Sync korrekt läuft, sind einige Einstellungen notwendig. Gehe wie folgt vor:

1. Melde dich im ACP von deinem WSC an und gehe zu Konfiguration -> Discord -> Discord-Sync.
2. Kopiere dir die Callback-URL aus der Beschreibung unter der Option Discord-Server auswählen.
3. Gehe zu deinen Discord-Anwendungen und wähle deine Anwendung aus.
4. Klicke links auf OAuth2.
5. Klicke auf den Button Add Redirect.
6. Füge die Callback-URL aus Punkt 2 und Redirects ein und klicke auf Save Changes.
7. Klicke links auf Bot.
8. Scrolle nach unten und aktiviere die Option Server Members Intent.
   • Das ist notwendig, damit der Bot deine Mitglieder auslesen kann.
9. Klicke auf den Button Save Changes.
10. Melde dich nun in Discord an und gehe zu deinem Server.
11. Klicke oben links auf deinem Servernamen und dann auf Servereinstellungen.
12. Wähle den Menüpunkt Rollen aus.
13. Schiebe deine Bot-Rolle (gleicher Name wie dein Bot) an oberste Stelle deines Servers.
    • Das ist notwendig damit der Bot alle Rechte vergeben kann. Ist die Bot-Rolle unter einer Rolle, kann die entsprechende Rolle vom Bot nicht vergeben werden.

Ich werde immer wieder gefragt warum der Discord-Bot eigentlich nicht permanent online ist. Viele Benutzer gehen sogar davon aus, dass das ein Fehler ist. Nein, das ist kein Fehler. Damit der Discord-Bot permanent online ist, musst dieser mit dem Discord-Gateway verbunden sein. Da dies über Websockets geschieht, ist es aktuell über PHP sehr umständlich das ganze zu implementieren. Wer trotzdem seinen Bot permanent online haben möchte, kann jetzt weiterlesen. Ihr solltet auf jeden Fall ein bisschen Erfahrung mitbringen. Ich werde offiziell keinen Support dazu geben.

Voraussetzungen

• eigenen Server
• NodeJS mit NPM (Installationsanleitung) oder Python 3.5+

Anleitung NodeJS

Erstell auf deinen Server einen neuen Ordner (den Ordnernamen darfst du dir aussuchen). Gehe in diesen Ordner rein und führe den Befehl npm install izy521/discord.io aus. Erstelle nun eine Datei namens discord_bot.js mit folgendem Inhalt:

var Discord = require('discord.io');
 
var botToken = 'INSERT_BOT_TOKEN_HERE';
 
var bot = new Discord.Client({
    token: botToken
});
 
bot.on('ready', function() {
    console.log('Logged in as %s - %s', bot.username, bot.id);
});

bot.connect();

INSERT_BOT_TOKEN_HEREmusst du nun durch deinen Bot-Token ersetzen. Nun kannst das Script mit dem Befehl node discord_bot.js ausführen. Wenn der Bot erfolgreich läuft, solltest du nun auf der Konsole eine Ausgabe sehen und der Bot sollte in Discord online sein.

Damit das Script permanent läuft, empfiehlt es sich das Script in einer Screen-Session oder ähnlichem laufen zu lassen.

Das war es auch schon

Anleitung Python

Für alle die eher auf Python stehen, können das Script von @TitusK verwenden. Dazu muss vorher folgendes ausgeführt werden pip3 install discord.py. Dann wird das untenstehende Script in der Datei discord_bot.py gespeichert.

import discord

# settings
TOKEN = 'INSERT_BOT_TOKEN_HERE'

# create client
client = discord.Client()


@client.event
async def on_ready():
    print('Logged in as')
    print(client.user.name)
    print(client.user.id)

# run client
client.run(TOKEN)

Aufgerufen wird es mit python3 discord_bot.py.

Erhältst du Fehlermeldung Invalid OAuth2 redirect_uri? Dann befolge bitte folgende Anleitung bis einschließlich Punkt 6:

FAQ: Bot-Einstellungen für Discord-Sync

Damit Discord-Sync korrekt läuft, sind einige Einstellungen notwendig. Gehe wie folgt vor:

1. Melde dich im ACP von deinem WSC an und gehe zu Konfiguration -> Discord -> Discord-Sync.
2. Kopiere dir die Callback-URL aus der Beschreibung unter der Option Discord-Server auswählen.
3. Gehe zu deinen Discord-Anwendungen und wähle deine Anwendung aus.
4. Klicke links auf OAuth2.
5. Klicke auf den Button Add Redirect.
6. Füge die Callback-URL aus Punkt 2 und Redirects ein und klicke auf Save Changes.
7. Klicke links auf Bot.
8. Scrolle nach unten und aktiviere die Option Server Members Intent.
   • Das ist notwendig, damit der Bot deine Mitglieder auslesen kann.
9. Klicke auf den Button Save Changes.
10. Melde dich nun in Discord an und gehe zu deinem Server.
11. Klicke oben links auf deinem Servernamen und dann auf Servereinstellungen.
12. Wähle den Menüpunkt Rollen aus.
13. Schiebe deine Bot-Rolle (gleicher Name wie dein Bot) an oberste Stelle deines Servers.
    • Das ist notwendig damit der Bot alle Rechte vergeben kann. Ist die Bot-Rolle unter einer Rolle, kann die entsprechende Rolle vom Bot nicht vergeben werden.

Wenn du die Discord-Shoutbox verwendest und die Fehlermeldung "ungültiger Channel" erhältst, verwendest du vermutlich ein 32-bit-System. Die Discord-Shoutbox setzt allerdings ein 64-bit-System voraus.

Am besten prüfst du das in dem du auf deinem Webserver eine PHP-Datei mit folgendem Inhalt erstellst und diese im Browser aufrufst:

<?php
if (PHP_INT_SIZE === 4) {
    echo "32bit";
} else {
    echo "64bit";
}

Wenn du nun die Meldung 32bit erhältst, verwendest du ein 32-bit-System und solltest dieses wenn möglich auf 64-bit umstellen (lassen).

Solltest du ein 64-bit-System verwenden, dann wende dich bitte an den Support und wir analysieren das Problem genauer.