Beschreibung

Dieses Modul bietet eine automatisierte und flexible Verwaltung der Gewinner von Events, erleichtert die Nachverfolgung von Events auf dem Server und lässt dem Server gleichzeitig die Freiheit, diese Rolle individuell zu nutzen. Dank dieser Rolle können Sie damit Sonderberechtigungen vergeben, exklusive Vorteile anbieten oder einfach aktive Mitglieder Ihrer Community würdigen.

Sobald Titel, Beschreibung, Bild (optional) und der Name des Erstellers (optional) angegeben sind:

Sie erhalten eine personalisierte Animationsnachricht, die automatisch in den im .env konfigurierten Kanal gesendet wird, wie unten dargestellt:

Sie können die Liste einsehen und Event-Gewinner über den Slash-Befehl /animation-add hinzufügen. Jedes Mal, wenn Tage hinzugefügt werden, werden diese zu den verbleibenden Tagen des Mitglieds addiert, falls dieses bereits Gewinner eines vorherigen Events war:

Jeden Tag um 23:59 prüft das Modul, ob die Rolle “Event-Gewinner” einem Mitglied entzogen werden soll.

❗ Wichtig

• Das Modul ist nicht funktionsfähig, wenn nur die Dateien heruntergeladen werden; es muss in einen bereits funktionierenden Discord‑Bot integriert werden.
• Wir verwenden Prisma als ORM zur Verwaltung der Datenbank; stellen Sie sicher, dass Ihr Projekt ebenfalls Prisma nutzt oder passen Sie den Code entsprechend an.

⚠️ Voraussetzungen

• Ein funktionierender Discord‑Bot mit den notwendigen Berechtigungen zum Registrieren von Slash‑Commands.
• Kenntnisse in der Entwicklung von Discord‑Bots (JavaScript) und in der Datenbankverwaltung, um dieses Script nutzen und an Ihre Bedürfnisse anpassen zu können.

Dateien/Ordner

• Verzeichniscommands

  • animation-add.js Implementierung des Slash‑Befehls /animation-add
  • animation-list.js Implementierung des Slash‑Befehls /animation-list
  • animation-remove.js Implementierung des Slash‑Befehls /animation-remove
    
    ‘Pflichtargument “id_user”: ID des zu entfernenden Nutzers aus der Gewinnerliste’
  • animation-message.js Implementierung des Slash‑Befehls /animation-message
    
    Optionales Argument “id_role”: falls angegeben, taggt die Nachricht diese Rolle
    
    Optionales Argument “id_message”: falls angegeben, wird die Nachricht bearbeitet statt eine neue zu erstellen
• Verzeichnisevents

  • interactionCreate.js Datei zur Wiederherstellung von Interaktionen
• Verzeichnisprisma

  • schema.prisma Datenmodell für das Modul (Prisma)
• Verzeichnisutils

  • Verzeichnisarguments

    • post-message.js Liste der Argumente für den Befehl zum Senden der Animationsnachricht
  • animation.js Hilfsfunktionen zur Verwaltung der Gewinner
• .env Erforderliche Umgebungsvariablen
• index.js Einstiegspunkt des Scripts
• package.json Abhängigkeiten

Abhängigkeiten & Versionen

Dies sind die während der Entwicklung und Tests verwendeten Versionen:

• @prisma/client@6.18.0
• discord.js@14.24.0
• dotenv@16.6.1
• node-schedule@2.1.1
• moment@2.30.1