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. Modul herunterladen & Ordner entpacken

   Laden Sie den Modulordner (häufig im .zip- oder .rar-Format) von der offiziellen Quelle herunter.
   Verwenden Sie ein Tool wie WinRAR oder 7‑Zip, um den Skriptordner auf Ihrem Rechner zu entpacken.

2. Erstellung Ihres Twitter Bearer-Tokens

   • Anmeldung bei der Twitter-Entwicklerplattform
     Gehen Sie zu: Dashboard, um sich anzumelden oder ein Konto zu erstellen.
     Wenn Sie dies zum ersten Mal tun, müssen Sie ein Abonnement wählen oder auf Sign up for Free Account klicken.
     Beschreiben Sie den Zweck der API-Nutzung; Beispiel (auf Englisch):
     

     Retrieving a user’s ID allows us to access their recent tweets, analyze updates in real time, and automatically share them on our Discord server. This keeps the community informed of the latest messages and activities. All while linking back to Twitter so they can comment on the messages.

     
     Aktivieren Sie die erforderlichen Optionen und klicken Sie auf Submit.
   
   

   • Erzeugen des Bearer-Tokens für Ihre Anwendung
     Gehen Sie zur Seite: Projects and apps

     
     

     Dort sollte ein Projekt vorhanden sein (Name ggf. automatisch vergeben). Beachten Sie, dass im kostenlosen Plan in der Regel nur eine App erlaubt ist.

     
     

     Klicken Sie im Projekt auf das Zahnrad App Settings und dann auf Keys and tokens.
     Unter Authentication Tokens klicken Sie auf Generate, um den Bearer Token zu erstellen.
     Kopieren Sie den angezeigten Bearer Token in Ihre .env-Datei.

   
   
   • ⚠️ Wenn Sie nicht bezahlen möchten, gibt es Quoten pro 15-Minuten-Intervall
     Mit dem Modul können bis zu 1 Twitter-Konto hinzugefügt werden. Für mehr Konten passen Sie die Quoten auf der Seite Quotas an.
   
   

   Vorsichtsmaßnahmen!

   Bewahren Sie diese Informationen sicher auf! 🔒
   Teilen Sie Ihren Bearer-Token niemals mit Dritten!
   Dieser Token authentifiziert Ihre Anwendung bei Twitter und ermöglicht API‑Anfragen.

3. Umgebungsvariablen konfigurieren

   Öffnen Sie die mit dem Skript gelieferte .env-Datei und fügen Sie die erforderlichen Variablen hinzu/ändern Sie diese:

   • twitterChannelID : ID des Kanals, in den Tweet-Benachrichtigungen gesendet werden
   • twitterRoleID : ID der Rolle für Benutzer, die Benachrichtigungen erhalten möchten (z. B. Mitgliederrolle oder eine spezielle Rolle)
   • twitterTokenBearer : Ihr Twitter Bearer-Token (siehe Schritt 2)
   • twitterChannelFollowerID : ID des Sprachkanals, dessen Name mit der Anzahl der Follower aktualisiert wird (Konto in Code konfigurieren, siehe nächsten Schritt)

4. Dateien/Code in Ihr Projekt kopieren

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

   • commands/notification/notification-add.js : in Ihren Commands-Ordner
   • commands/notification/notification-list.js : in Ihren Commands-Ordner
   • commands/notification/notification-remove.js : in Ihren Commands-Ordner
   • utils/notification/twitter.js : in Ihren Utilities-Ordner
   • utils/utils.js : in Ihren Utilities-Ordner

   Fügen Sie außerdem den Initialisierungscode des Moduls in Ihre Hauptdatei index.js ein.
   In unserer Implementierung ist Prisma direkt an das client-Objekt gebunden — passen Sie das entsprechend Ihrer Einrichtung an.

   ❗ Optional: Sie können die Konstante PSEUDO_UPDATE_CHANNEL_STAT ändern, um den Statistikkanal zu aktualisieren, oder die Zeile auskommentieren.
   Das Pseudonym muss mit dem in der Datenbank gespeicherten Wert übereinstimmen.

   

5. Datenbankschema aktualisieren

   Fügen Sie das Datenmodell für Twitter-Benachrichtigungen in prisma/schema.prisma ein und führen Sie die Migrationen aus:

   npx prisma generate
   
   npx prisma migrate dev --name add_twitter_notification

6. Abhängigkeiten installieren

   Stellen Sie sicher, dass die erforderlichen Abhängigkeiten installiert sind:

   npm install

7. Bot neu starten

   Starten Sie Ihren Bot neu, damit das Skript geladen wird.

Berechtigungen für Befehle anpassen

Gehen Sie auf Ihren Server > Servereinstellungen > Integrationen. Klicken Sie im Bereich Bots und Anwendungen auf Ihren Bot.

Im Tab Befehle können Sie Ausnahmen hinzufügen, um die Berechtigungen der vom Modul hinzugefügten Befehle zu verwalten.

Ohne Anpassung haben alle Servermitglieder Zugriff auf die Modul‑Befehle.

Tipps

• Für den Befehl /notification-add müssen Sie den Account‑Namen eingeben, wie er in der URL angegeben ist.
  Beispiel: https://x.com/JoycaOff
  => Der Name, der bei Verwendung des Befehls eingegeben werden muss, ist JoycaOff (ohne das @).