Installation

Befolgen Sie diese Schritte, um das Skript korrekt auf Ihrem Bot zu installieren.

Achtung

Diese Anweisungen setzen voraus, dass Sie bereits einen funktionierenden Discord-Bot haben und wissen, wie Sie Skripte zu Ihrem Bot hinzufügen.

Installationsschritte

1. Laden Sie das Modul herunter und entpacken Sie den Ordner

   Holen Sie sich den Modulordner (häufig im .zip- oder .rar-Format) von der offiziellen Quelle. Verwenden Sie ein Tool wie WinRAR oder 7-Zip, um den Skriptordner auf Ihrem Computer zu extrahieren.

2. Erstellen Sie Ihre YouTube-API-Schlüssel

   • Anmeldung bei der Google-Entwicklerplattform
     Gehen Sie zu: Dashboard, um sich anzumelden oder ein Konto zu erstellen, um auf das Dashboard zuzugreifen.
   
   
   • Erstellen Sie ein Projekt
     Klicken Sie auf Projekt erstellen, geben Sie den Namen Ihres Projekts ein und bestätigen Sie die Erstellung.
   
   
   • Aktivierung der YouTube-API auf Ihrem Google-Konto
     Gehen Sie zu: YouTube API, um die Google API zu aktivieren.
   
   

   • Erstellen Sie Ihre Anwendung
     Klicken Sie auf Anmeldeinformationen oder gehen Sie zu diesem Link: Anmeldeinformationen

     
     

     Klicken Sie auf Anmeldeinformationen erstellen, und wählen Sie API-Schlüssel

     
     

     Füllen Sie die folgenden Felder aus:

     • Name (der Name Ihrer Anwendung, z.B. BotYoutube)
     • Anwendungsbeschränkungen => IP-Adressen und geben Sie die IP-Adresse Ihres VPS/Ihrer Maschine ein
     • Wählen Sie im Abschnitt API-Beschränkungen YouTube Data API v3

     Bestätigen Sie dann die Erstellung. Ein Schlüssel wird angezeigt, den Sie in die .env-Datei einfügen können.

   
   
   • ⚠️ Wenn Sie nicht bezahlen möchten, haben Sie eine tägliche Quote zu beachten
     Über das Modul können Sie bis zu 5 YouTube-Konten eingeben. Wenn Sie mehr möchten, müssen Sie dies auf der Seite Quoten anpassen.
   
   

   Vorsichtsmaßnahmen!

   Bewahren Sie diese Informationen sicher auf! 🔒
   Teilen Sie Ihren Schlüssel niemals mit jemandem!
   Diese Kennung wird verwendet, um Ihre Anwendung bei YouTube zu authentifizieren und Antworten auf Ihre Anfragen zu erhalten.

3. Konfigurieren Sie die Umgebungsvariablen

   Öffnen Sie die .env-Datei, die mit dem Skript bereitgestellt wird, und fügen Sie die erforderlichen Umgebungsvariablen für das ordnungsgemäße Funktionieren des Moduls hinzu und ändern Sie sie.

   • youtubeChannelID : ID des Kanals, in dem die YouTube-Benachrichtigungen gesendet werden
   • youtubeRoleID : ID der Rolle der Personen, die Benachrichtigungen erhalten möchten (In der Regel die Mitgliederrolle, um den gesamten Server zu benachrichtigen, oder eine von Ihnen erstellte Rolle, damit die Mitglieder diese Rolle auswählen können, um über ein neues Video informiert zu werden!)
   • youtubeAPIKey : Der YouTube-API-Schlüssel (Siehe Schritt 2)
   • youtubeChannelFollowerID : ID des Sprachkanals, der bezüglich der Anzahl der Follower aktualisiert wird (Konfigurieren Sie das Konto im Code, siehe den nächsten Schritt)

4. Kopieren/verschieben Sie die Dateien/Codes in Ihr Projekt

   Kopieren Sie die folgenden Dateien in die entsprechenden Ordner Ihres Discord-Bot-Projekts:

   • commands/notification/notification-add.js : in den Ordner Ihrer Befehle
   • commands/notification/notification-list.js : in den Ordner Ihrer Befehle
   • commands/notification/notification-remove.js : in den Ordner Ihrer Befehle
   • utils/notification/youtube.js : in den Ordner Ihrer Dienstprogramme
   • utils/utils.js : in den Ordner Ihrer Dienstprogramme

   Kopieren Sie auch den Indexierungscode des Moduls in Ihre Hauptdatei index.js. In dieser Datei haben wir Prisma direkt mit dem “Client”-Objekt verknüpft, fügen Sie diesen Code in Ihre Datei ein oder passen Sie ihn an, je nachdem, wie Sie Prisma verwenden.

   ❗ Wenn Sie möchten, können Sie PSEUDO_UPDATE_CHANNEL_STAT ändern, um den Statistikkanal zu aktualisieren, oder diese Zeile kommentieren. Das Pseudonym muss dasselbe sein wie das, das in der Datenbank gespeichert ist.

   

5. Aktualisieren Sie das Datenbankschema

   Fügen Sie das Datenmodell für den Abruf von Benachrichtigungen über neue YouTube-Videos in Ihre prisma/schema.prisma-Datei ein und führen Sie die erforderlichen Migrationen aus, um die Änderungen an Ihrer Datenbank anzuwenden. Führen Sie den folgenden Befehl aus:

   npx prisma generate
   
   npx prisma migrate dev --name add_youtube_notification

6. Installieren Sie die Abhängigkeiten

   Stellen Sie sicher, dass die erforderlichen Abhängigkeiten installiert sind, indem Sie Ihre package.json überprüfen und Folgendes ausführen:

   npm install

7. Starten Sie den Bot neu

   Starten Sie Ihren Bot neu, damit das Skript berücksichtigt wird.

Befugnisse der Befehle ändern

Greifen Sie auf Ihren Server zu, und gehen Sie zu Servereinstellungen > Integrationen. Klicken Sie im Abschnitt Bots und Anwendungen auf Ihren Bot.

Im Tab Befehle können Sie Ausnahmen hinzufügen, um die Berechtigungen der verschiedenen Befehle zu verwalten, die von unserem Modul hinzugefügt wurden.

Wenn Sie diese Berechtigungen nicht konfigurieren, haben alle Mitglieder Ihres Servers Zugriff auf die Befehle des Moduls.

Tipps

• Für den Befehl /notification-add müssen Sie den Namen des YouTube-Kanals eingeben, der in der URL des Kanals angegeben ist. Beispiel: https://www.youtube.com/@Joyca => Der Name, der bei der Verwendung des Befehls eingegeben werden muss, ist Joyca (ohne das @).