🤖 EGM Fraktions Bot

Handbuch für Discord-Bot mit Trello-Integration

📋 Features

🔗 Bot-Einladung

Erforderliche Berechtigungen

Der Bot benötigt folgende Discord-Berechtigungen:

Alternativ mindestens:

⚙️ Setup-Anleitung für Server-Admins

Nach dem Einladen des Bots auf deinen Server, folge diesen Schritten:

0. Berechtigungen für Befehle konfigurieren (Optional)

Standardmäßig können nur Administratoren die Bot-Befehle verwenden. Um anderen Rollen oder Mitgliedern Zugriff zu geben:

  1. Gehe zu Server-Einstellungen → Integrationen
  2. Finde den EGM Fraktions Bot in der Liste
  3. Klicke auf den Bot, um die Befehls-Berechtigungen zu öffnen
  4. Für jeden Befehl oder alle Befehle zusammen:
    • Klicke auf das ⚙️ Zahnrad-Symbol
    • Füge Rollen oder Kanäle hinzu, die den Befehl verwenden dürfen
    • Oder entferne die Standard-Administrator-Beschränkung
Empfohlene Berechtigungen:

1. Trello-Verbindung einrichten

Erforderlich für: Mitgliederverwaltung, Trainings, Abwesenheiten

/trello-setup
  1. Klicke auf den generierten OAuth-Link
  2. Autorisiere den Zugriff auf dein Trello-Konto
  3. Wähle das Trello-Board aus, das für die Mitgliederverwaltung verwendet werden soll
  4. Der Bot erstellt automatisch eine Template-Karte im niedrigsten Rang
Wichtig: Die Person, die diesen Befehl ausführt, muss Zugriff auf das Trello-Board haben.

2. Ränge konfigurieren

Erforderlich für: Mitgliederverwaltung

/trello-rang

Für jeden Rang in deiner Fraktion/Organisation:

  1. Wähle die Trello-Liste (Spalte) aus, die diesem Rang entspricht
  2. Wähle die Discord-Rollen aus, die diesem Rang zugeordnet werden sollen (mehrere möglich)
  3. Setze das Power-Level (höher = ranghöher, z.B. 10, 20, 30)
Hinweise:

3. Mitglieder-Logs konfigurieren (Optional aber empfohlen)

Aktiviert Benachrichtigungen für: Mitgliederaktionen

/member-logs

Wähle für jede Log-Art den Kanal und optional eine Benachrichtigungsrolle:

Empfehlung: Richte mindestens einen Log-Kanal für alle Aktionen ein.

4. Ticket-System einrichten (Optional)

Erforderlich für: Support-Tickets

/ticket-setup
  1. Wähle den Kanal, in dem die Ticket-Nachricht angezeigt werden soll
  2. Passe Titel, Beschreibung und Design an
/ticket-category

Für jede Ticket-Kategorie:

  1. Gib einen Namen ein (z.B. "Support", "Bewerbung", "Beschwerde")
  2. Wähle ein Emoji
  3. Wähle die Discord-Kategorie, in der Tickets erstellt werden
  4. Wähle optional Rollen, die bei neuen Tickets benachrichtigt werden

5. Trainings-System einrichten (Optional)

Erforderlich für: Ausbildungsverwaltung

/training-add

Für jede Ausbildung/Fortbildung:

  1. Gib den Namen ein (z.B. "Erste Hilfe", "Fahrzeugkunde")
  2. Wähle eine Kategorie (z.B. "Grundausbildung", "Spezialausbildung")
  3. Wähle optional Trainer-Rollen (mehrere möglich - alle ausgewählten Rollen können die Ausbildung durchführen)
  4. Wähle optional eine Abschluss-Rolle (wird bei Erfolg vergeben)
Automatische Synchronisation: Hinweis: Du kannst bis zu 25 verschiedene Trainer-Rollen pro Fortbildung auswählen. Wenn keine Rolle ausgewählt wird, kann jeder die Fortbildung durchführen.
/training-logs

Konfiguriere Log-Benachrichtigungen für:

6. Management-Panel erstellen (Optional aber empfohlen)

Ermöglicht Mitgliedern: Abmeldungen, Trainings durchführen

/management-setup
  1. Wähle den Kanal für das Panel
  2. Passe Titel, Beschreibung und Design an
Panel-Funktionen:
Hinweis: Abwesenheits-Labels werden automatisch 7 Tage nach Ablauf entfernt.

📝 Verfügbare Befehle

Basis-Befehle

Trello-Setup (Admin)

Mitgliederverwaltung (Admin)

Trainings-Verwaltung (Admin)

Ticket-System (Admin)

Management-Panel (Admin)

❓ Häufig gestellte Fragen

Q: Was passiert, wenn ich ein Mitglied befördere?

A: Der Bot verschiebt die Trello-Karte in die nächste Liste, entfernt die alten Rang-Rollen, fügt die neuen hinzu und sendet eine Log-Benachrichtigung.

Q: Kann ich Ränge nachträglich ändern?

A: Ja, verwende einfach /trello-rang erneut. Bestehende Mitglieder behalten ihre Position, aber neue Rollen werden synchronisiert.

Q: Was ist das Power-Level?

A: Das Power-Level bestimmt die Hierarchie der Ränge. Höhere Zahlen = höherer Rang. Verwende Lücken (10, 20, 30) für spätere Einfügungen.

Q: Kann ich die Sortierung der Trello-Spalten ändern?

A: Ja! Mit /trello-config kannst du zwischen zwei Sortierungen wählen:

Die Spalten werden automatisch neu angeordnet.

Q: Werden Trainings automatisch synchronisiert?

A: Ja! Neue Trainings werden sofort auf alle bestehenden Mitglieder-Karten hinzugefügt. Entfernte Trainings werden von allen Karten entfernt.

Q: Können mehrere Rollen eine Fortbildung durchführen?

A: Ja! Beim Erstellen einer Fortbildung mit /training-add kannst du bis zu 25 verschiedene Trainer-Rollen auswählen. Alle ausgewählten Rollen können die Fortbildung durchführen. Wenn keine Rolle ausgewählt wird, kann jedes Mitglied die Fortbildung durchführen.

Q: Wie funktioniert die Abwesenheitsverwaltung?

A: Mitglieder melden sich über das Management-Panel ab. Der Bot erstellt ein gelbes Label auf ihrer Trello-Karte im Format "Abgemeldet DD.MM.YYYY-DD.MM.YYYY". Labels werden 7 Tage nach Ablauf automatisch entfernt.

Q: Muss ich alle Features einrichten?

A: Nein. Die Trello-Verbindung und Ränge sind erforderlich für die Mitgliederverwaltung. Tickets, Trainings und Management-Panel sind optional.

Q: Was passiert bei einem Bot-Neustart?

A: Alle Konfigurationen bleiben erhalten. Background-Jobs (Rang-Sortierung, Label-Cleanup) starten automatisch.

Q: Was wird gelöscht, wenn ich die Trello-Verbindung trenne?

A: Der /trello-disconnect Befehl entfernt:

Wichtig: Die Trello-Listen, Karten und Labels bleiben auf deinem Trello-Board unverändert. Nur die Bot-Verbindung wird getrennt.

Q: Wie kann ich nicht-Admins Zugriff auf Befehle geben?

A: Gehe zu Server-Einstellungen → Integrationen → EGM Fraktions Bot und konfiguriere die Berechtigungen für jeden Befehl. Du kannst bestimmte Rollen oder Kanäle freigeben.

🔧 Technische Details

EGM Fraktions Bot - Version 1.0