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 Rechner zu entpacken.

2. Umgebungsvariablen konfigurieren

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

   • guildID : ID des Discord‑Servers, auf dem der Bot läuft
   • animationRoleWinnerAnimationID : ID der Rolle für Event‑Gewinner
   • animationChannelEventID : ID des Kanals, in den Animations‑Nachrichten gesendet werden sollen

3. Dateien/Code in Ihr Projekt kopieren/verschieben

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

   • commands/animation-add.js : in den Ordner für Slash‑Commands
   • commands/animation-list.js : in den Ordner für Slash‑Commands
   • commands/animation-remove.js : in den Ordner für Slash‑Commands
   • commands/animation-message.js : in den Ordner für Slash‑Commands
   • events/interactionCreate.js : Kopieren Sie den nützlichen Teil des Codes aus dieser Datei, um ihn in Ihre eigene Datei einzufügen
   • utils/arguments/post-message.js : in den Utilities‑Ordner
   • utils/animation.js : in den Utilities‑Ordner

   Kopieren Sie zudem den Initialisierungscode des Moduls in Ihre Hauptdatei index.js. In unserer Version ist Prisma direkt an das client‑Objekt gebunden — fügen Sie diesen Code in Ihr Projekt ein oder passen Sie ihn an Ihre Prisma‑Integration an.

4. Datenbankschema aktualisieren

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

   npx prisma generate
   
   npx prisma migrate dev --name add_animation_model

5. Abhängigkeiten installieren

   Stellen Sie sicher, dass die erforderlichen 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 die Slash‑Commands /animation-add, /animation-list, /animation-remove, /animation-message in einem Testserver, bevor Sie sie in Produktion einsetzen.
• In index.js können Sie die Planung für das Entfernen der Rolle “Event‑Gewinner” nach Bedarf anpassen. (Derzeit auf täglich 23:59 Uhr eingestellt).