Duell-Erinnerung (Duel Reminder)

Das Duel-Reminder-Modul sendet automatisch tägliche Embeds mit Duellstrategien für Dark War Survival. Jeder Wochentag hat seine eigene Vorlage mit einer dedizierten Strategie.

Modul aktivieren

1. Dashboard → Ihr Server → Toggle Duel Reminder
2. Klicken Sie auf Edit und konfigurieren Sie Kanal und Sendezeit
3. Speichern Sie die Änderungen

Konfiguration

Option	Typ	Standard	Beschreibung
channel_id	string / null	null	Kanal für Erinnerungen (erforderlich)
send_hour	number (0–23)	8	Sendestunde
send_minute	number (0–59)	0	Sendeminute
timezone_offset	number	2	Zeitzonen-Offset (UTC+X)
last_message_id	string / null	—	ID der letzten gesendeten Nachricht (auto)
templates	object / null	null	Benutzerdefinierte Vorlagen (null = Standard)

Dashboard — Konfiguration

Das Bearbeitungspanel enthält:

• Channel — Dropdown mit Textkanälen
• Send Time — Felder für Stunde + Minute
• Timezone — UTC-Offset (z.B. +2 für MESZ)
• Templates — Bearbeitung der Vorlagen pro Tag (optional)

Funktionsweise

1. Jede Minute prüft der Bot, ob die konfigurierte Uhrzeit erreicht ist
2. Wenn ja und heute noch nicht gesendet:
   • Löscht die gestrige Nachricht (damit der Kanal sauber bleibt)
   • Baut ein Embed aus der Tagesvorlage
   • Sendet die neue Nachricht
   • Speichert die Nachrichten-ID (zum Löschen am nächsten Tag)

Kanalbereinigung

Der Bot löscht automatisch die vorherige Nachricht vor dem Senden einer neuen — dadurch enthält der Kanal immer nur die aktuelle Tagesstrategie.

Vorlagen

Vorlagen sind pro Wochentag organisiert:

{
  "Monday": {
    "content": "@everyone",
    "embed": {
      "title": "⚔️ Montagsstrategie",
      "description": "Heute kämpfen wir mit Infanterie...",
      "color": "#E74C3C",
      "image": "https://...",
      "footer": { "text": "Viel Erfolg!" }
    }
  },
  "Tuesday": { ... },
  "Wednesday": { ... },
  ...
}

Standardvorlagen

Wenn templates in der Konfiguration null ist, verwendet der Bot Standardvorlagen aus der Datei duel_templates.json.

Benutzerdefinierte Vorlagen

Über das Dashboard können Vorlagen für jeden Wochentag mit eigenem Inhalt überschrieben werden:

• Text über dem Embed (Content)
• Embed-Titel
• Beschreibung (Strategie)
• Farbe
• Bild
• Thumbnail
• Footer

Befehle

/duel send

Sendet manuell die heutige Erinnerung (nur Admin).

Nützlich für:

• Ersten Test nach der Konfiguration
• Erneutes Senden, wenn etwas schiefgelaufen ist
• Sofortiges Senden erzwingen

/duel preview

Vorschau der heutigen Vorlage ohne Versand an den Kanal (ephemeral).

Zeitzone

Der Bot verwendet den konfigurierten UTC-Offset, um:

• Den "heutigen" Wochentag zu bestimmen
• Zu prüfen, ob die Sendezeit erreicht ist

Beispiel

Die Einstellung timezone_offset: 2 (UTC+2 / MESZ) bedeutet, dass send_hour: 8 die Nachricht um 8:00 Uhr mitteleuropäischer Sommerzeit (6:00 UTC) sendet.

Überwachte Ereignisse

Das Modul lauscht auf keine Discord-Events — es arbeitet ausschließlich über eine zyklische Aufgabe (tasks.loop).

Zyklische Aufgabe

• _daily_check — prüft jede Minute alle Server mit aktiviertem Modul

Tipps

Best Practices

• Setzen Sie send_hour auf eine Stunde vor der typischen Duellzeit im Spiel
• Verwenden Sie content: "@everyone" in der Vorlage, um den gesamten Server zu pingen
• Konfigurieren Sie einen dedizierten Kanal (z.B. #duel-strategy) — der Bot hält dort nur eine Nachricht
• Verwenden Sie Bilder in den Vorlagen — visuelle Strategien sind leichter verständlich

Testen

Verwenden Sie /duel preview, um zu sehen, wie die heutige Vorlage aussieht, ohne sie an den Kanal zu senden. Wenn Sie zufrieden sind, sendet /duel send sie sofort.

warnung

Das Modul erfordert eine konfigurierte channel_id. Ohne Kanal werden keine Erinnerungen gesendet (aber der Bot meldet keinen Fehler — er überspringt einfach den Server).