> For the complete documentation index, see [llms.txt](https://wiki.primeapi.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.primeapi.de/bungeesystem/discord-bot.md).

# Discord Bot

Das Einrichten des Discord Bots kann einem schwierig vorkommen. Mit der richtigen Anleitung ist es jedoch Kinderleicht

## Vorbereitung

### Discord Applikation

#### Schritt 1: Erstellen

Begib dich auf und erstelle eine Applikation

![Erstellen einer neuen Applikation](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN_zr3wyu3ff9dNWuNz%2Fuploads%2Fgit-blob-4e634419c10e29aec17aff8fe16b04aad0a26732%2Fr2ikovq%20\(2\)%20\(2\)%20\(2\).png?alt=media)

#### Schritt 2: Name vergeben

![Vergabe eines Namens für die Applikation](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNFT4eeQIkovfkT_A6%2FtheEQnQ.png?alt=media\&token=5f68b709-627b-48b2-9ea6-b12ea70e193a)

#### Schritt 3: Bot erstellen

![Der Applikation einen Bot hinzufügen](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNFT4cWUcnhH2ZaptT%2FvS8orLO.png?alt=media\&token=4b17bfaf-7f26-4246-b899-3f7845b26906)

#### Schritt 4: Bot-Token kopieren

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNGCnNMaX4679JRwvZ%2FUYvmAhY.png?alt=media\&token=5572fac7-53e8-4dbb-8ddf-c970412d3c9d)

{% hint style="danger" %}
Speichere dir diesen Token ab! Wir brauchen diesen token Später
{% endhint %}

#### Schritt 5: Bot auf deinen Server einladen

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNGjV6R-Vx-R_TfzIF%2F3kyftVu.png?alt=media\&token=d5fec3d4-a574-476b-9ac8-61d4e4ab8a9e)

Unter OAuth2 musst du nun bei `SCOPES` `bot` auswählen und unter `BOT PERMISSIONS` musst du `Administartor` auswählen. Nun kopierst du den Link, und öffnest ihn in einem neuen Tab

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNH4JUoubVrfkR1yyv%2FmvGrFAs.png?alt=media\&token=38e072df-47ee-47dc-b14c-6215d191d2d8)

In diesem Fenster nun deinen Server auswählen, auf Weiter klicken und im nächsten Fenster Autorisieren auswählen.

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNHRWIvTLio_6sD-D7%2FoH2eeHj.png?alt=media\&token=3f32c0a3-c119-4eba-af08-b8988a48e59d)

Nun kannst du den Bot auf deinem Server betrachten

### Developer Modus

Damit du die Config richtig einstellen kannst, musst du bei deinem Discord den Developer Modus aktivieren.\
In deinen Einstellungen kannst du unter Erweitert den Entwickler-Modus aktivieren.

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNIFaKA1hP6rnL309w%2FhE5S7hO.png?alt=media\&token=857d949a-fb37-4b9e-a3b0-3e6dc803b3fd)

## Einrichtung der Config

### Connection

Unter connection findest du verschiedene Einstellmölichkeiten.\
1 Key ➟ Hier gibst du den Key den du dir vorher kopiert hast an\
2 Status ➟ - Hier gibst du den OnlineStatus des Bots an. (grüner, gelber oder roter Kreis) (Liste aller möglichen Status: [*JDA Wiki*](https://ci.dv8tion.net/job/JDA/javadoc/net/dv8tion/jda/api/OnlineStatus.html) \_\_ )\
3 Activity.Type ➟ - Hier gibst du die Art der Acitify an. (Spielt..., Guckt.., etc...) (Liste aller möglichen Typs: [*JDA Wiki*](https://ci.dv8tion.net/job/JDA5/javadoc/net/dv8tion/jda/api/entities/Activity.ActivityType.html) )\
4 Activitity.Value ➟ - Die aktivität die angezeigt wird nach dem Typ. Bspw. \[Spiel] verifizieren\
5 Guild ➟ - Guild steht hier für deinen Discord-Server. Hier musst du die ID deiner Guilde angeben. Diese erhälst du indem du Rechtsklick auf dein Server-Icon machst, und dort die ID kopierst

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNPPu9yCLBlZtiFStb%2FCbNtTiM.png?alt=media\&token=8b141dfe-1d2b-4a2f-ad38-a5f9698aee1c)

### Verifikation

**Command**

{% hint style="info" %}
Dadurch das die Verarbeitung von SlashCommands nicht dirket ist, kann dies einige Minuten dauern bis er angezeigt wird
{% endhint %}

1 Command ➟ Hier gibts du den Namen des Befehls an, der zur Verifikation genutzt wird.\
2 Info ➟ Die Information zum Verify-Command im Discord\
3 Code ➟ Hier gibts du den Namen an, welchen das Argument für den Verifycode im Discord haben soll\
4 Description ➟ Die Information was man beim 'Code' angegeben werden muss\
5 Groups-Verify-Apply ➟ Soll man bei der Verifikation die 'Verify' Gruppe im Discord erhalten\
6 Groups-Roles-Apply ➟ Soll man Team oder andere Rollen erhalten\
\
Wie muss ich die Gruppen angeben?\
\
`permission:Rollen-ID`.\
\
permission ➟ Bei welcher Ingame Permission soll die Gruppe vergeben werden\
Rollen-ID ➟ Welche Rolle soll dieser Spieler im Discord bekommen.\ <br>

Wie bekomme ich die Rollen-ID herraus?

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MN_zr3wyu3ff9dNWuNz%2F-MbNDTtX4MRwajTnnpjK%2F-MbNPPu6pM9MACPL-f7z%2F48Ue2db.png?alt=media\&token=caeba47a-b240-4045-9d2f-100db07f2e86)

### Notify & Report

Wenn du Notify antiwierst erhälst du in deinem Discord immer wenn jemand einen **Spieler bannt** eine Nachricht in einen angegebenen Channel.

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN_zr3wyu3ff9dNWuNz%2Fuploads%2Fgit-blob-9163e80bfff9f7efadcb328183aa782c020ea333%2Fimage2.png?alt=media)

Wenn du Report aktivierst, wehälst du in deinem Discord immer wenn jemand einen **Spieler reported** einen Nachricht in einen angegebenen Channel.

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN_zr3wyu3ff9dNWuNz%2Fuploads%2Fgit-blob-b374d6965bf45d449dc80aa74138c052be6011ab%2Fsdds.png?alt=media)

Du musst bei beidem den Channel als ID angeben. Die ID gibts du an, indem du Rechtsklick auf den Channel machst und dort auf 'ID kopieren' klickst.

![](https://1763128652-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN_zr3wyu3ff9dNWuNz%2Fuploads%2Fgit-blob-15f80eb0a08f69a6927a3aa633a4e516a7df5de6%2Fasdasdasda.png?alt=media)
