Installation

Befolgen Sie diese Schritte, um das Skript korrekt in Ihren Bot zu installieren.

Achtung

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

Installationsschritte

1. Modul herunterladen & Ordner entpacken

   Laden Sie den Modulordner (in der Regel im .zip- oder .rar-Format) von der offiziellen Quelle herunter.
   Verwenden Sie ein Tool wie WinRAR oder 7-Zip, um den Skript-Ordner auf Ihrem Computer zu entpacken.

2. Umgebungsvariablen konfigurieren

   Öffnen Sie die mitgelieferte .env-Datei und fügen Sie die benötigten Umgebungsvariablen hinzu bzw. passen Sie diese an, damit das Modul korrekt funktioniert.

   • guildID : ID des Discord-Servers, auf dem der Bot eingesetzt wird
   • channelBirthdayID : ID des Chats, in dem Geburtstagsnachrichten verschickt werden sollen

3. Dateien/Code in Ihr Projekt kopieren/verschieben

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

   • commands/birthday.js in Ihren Slash-Commands-Ordner
   • utils/birthday.js in Ihren Utilities-Ordner

   Kopieren Sie außerdem den Modul-Registrierungscode in Ihre Hauptdatei index.js. In dieser Datei haben wir prisma direkt mit dem Objekt “client” verknüpft. Fügen Sie diesen Code in Ihre Datei ein oder passen Sie ihn entsprechend Ihrer Verwendung von prisma an.

4. Datenbankschema aktualisieren

   Fügen Sie das Datenmodell für Geburtstage in Ihre Datei prisma/schema.prisma ein und führen Sie die erforderlichen Migrationen aus, um die Änderungen in der Datenbank anzuwenden.
   Führen Sie folgende Befehle aus:

   npx prisma generate
   
   npx prisma migrate dev --name add_birthday_model

5. Abhängigkeiten installieren

   Stellen Sie sicher, dass die benötigten Abhängigkeiten installiert sind, indem Sie Ihre package.json prüfen und folgenden Befehl ausführen:

   npm install

6. Bot neu starten

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

Berechtigungen für Befehle ändern

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

Auf der Registerkarte Befehle können Sie Ausnahmen hinzufügen, um die Berechtigungen für die 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

• Testen Sie den Slash-Befehl /birthday in einem Testserver, bevor Sie das Modul produktiv einsetzen.
• In index.js können Sie die Planung des Versands der Geburtstagsnachrichten anpassen (aktuell auf täglich 08:00 Uhr eingestellt).
• In utils/birthday.js können Sie den Inhalt der an Benutzer gesendeten Geburtstagsnachrichten nach Belieben anpassen.