Waffenkammer (Armory)

Das Armory-Modul verwaltet das Waffenkammer-Rotationssystem in Dark War Survival: 8 Slots mit Buffs, wöchentliche Zuweisungen an Allianzen und Ankündigungen über die aktuelle Verteilung.

Modul aktivieren

1. Dashboard → Ihr Server → Toggle Armory
2. Klicken Sie auf Edit, um den Ankündigungskanal zu konfigurieren
3. Speichern Sie die Änderungen

Konfiguration

Option	Typ	Standard	Beschreibung
announcement_channel_id	string / null	null	Kanal für Zuweisungs-Ankündigungen
history_mode	string	"command"	Historienmodus: "command" oder "embed"
history_message_id	string / null	null	ID der Historien-Nachricht (Embed-Modus)
history_channel_id	string / null	null	Historienkanal (Embed-Modus)

Waffenkammer-Slots

Jeder Server hat 8 Waffenkammer-Slots (automatisch erstellt):

• Nummer (1–8)
• Name (im Dashboard konfigurierbar)
• Buff-Beschreibung

Slots werden in der Tabelle armory_slots gespeichert.

Dashboard — Konfiguration

Das Bearbeitungspanel von Armory enthält:

• Announcement Channel — Dropdown mit Kanälen
• Slots Configuration — Bearbeitung der Namen und Beschreibungen der 8 Slots
• Current Assignments — Übersicht der aktuellen Woche

Befehle

/armory assign

Weist einer Allianz einen Waffenkammer-Slot für die aktuelle Woche zu.

Parameter	Erforderlich	Beschreibung
slot	✅	Slot-Nummer (1–8)
alliance_name	✅	Allianzname (ILIKE-Suche)

Voraussetzungen: Administrator oder aktueller Präsident.

Ablauf:

1. Prüft Berechtigungen (Admin oder Präsident)
2. Sucht Allianz nach Name (teilweise Übereinstimmung)
3. Upsert der Zuweisung für die aktuelle Woche
4. Sendet Ankündigungs-Embed an announcement_channel_id
5. Protokolliert die Zuweisung

/armory clear

Entfernt die Allianzzuweisung von einem Slot für die aktuelle Woche.

Parameter	Erforderlich	Beschreibung
slot	✅	Slot-Nummer (1–8)

Voraussetzungen: Administrator oder aktueller Präsident.

Wöchentliche Rotation

Zuweisungen basieren auf Wochen:

• Die Woche beginnt am Montag 00:00 UTC
• Jede Woche hat einen eigenen Satz an Zuweisungen
• Alte Zuweisungen bleiben in der Historie

Ankündigungsformat

Das Ankündigungs-Embed enthält:

• Titel: "🏰 Armory Assignments"
• Beschreibung: "Week of [Datum]"
• 8 Felder (eines pro Slot): Slot-Name + zugewiesene Allianz + Buff-Beschreibung
• Footer mit Aktualisierungsdatum

┌─────────────────────────────────────┐
│ 🏰 Armory Assignments              │
│ Week of June 9, 2026               │
├─────────────────────────────────────┤
│ 1. Infantry Armory                  │
│ **Alliance Alpha**                  │
│ +10% Infantry Attack                │
│                                     │
│ 2. Cavalry Armory                   │
│ *Unassigned*                        │
│ +10% Cavalry Defense                │
│ ...                                 │
└─────────────────────────────────────┘

Berechtigungen

Aktion	Wer darf
Assign / Clear	Administrator oder aktueller Präsident
Ansicht	Jeder (Embed im Kanal)

Präsident + Armory

Das Waffenkammer-System ist zur Zusammenarbeit mit dem Presidents-Modul konzipiert — der Präsident ist für die wöchentliche Verteilung der Waffenkammer unter den Allianzen verantwortlich.

Datenbank

Tabelle	Beschreibung
armory_slots	guild_id, slot_number, name, buff_description
armory_assignments	guild_id, slot_number, alliance_id, week_start, assigned_by, assigned_at

Constraint: UNIQUE(guild_id, slot_number, week_start) — eine Allianz pro Slot pro Woche.

Protokollierung

Aktionen werden durch Logs unter der Kategorie armory protokolliert:

• 🏰 Armory Assigned — Slot-Nummer, Allianz, wer zugewiesen hat
• 🏰 Armory Cleared — Slot-Nummer

Tipps

Best Practices

• Konfigurieren Sie announcement_channel_id auf einen für Allianz-Anführer sichtbaren Kanal
• Geben Sie Slots beschreibende Namen passend zu den Buffs im Spiel
• Rotieren Sie die Zuweisungen wöchentlich für fairen Zugang
• Der Präsident sollte die Zuweisungen zu Beginn jeder Woche vornehmen

Workflow

1. Präsident entscheidet über die Waffenkammer-Verteilung
2. Verwendet /armory assign für jeden Slot
3. Bot sendet Embed mit vollständiger Verteilung
4. Allianz-Anführer sehen, welche Waffenkammer sie diese Woche haben