# GuildBot – Benutzerhandbuch Öffentliches Benutzerhandbuch zum Nebelreich-GuildBot für Mitglieder, Bewerber, Gäste und Interessierte. # Willkommen beim GuildBot # Was ist der GuildBot? Der GuildBot unterstützt die Organisation des Nebelreichs auf Discord. Er übernimmt wiederkehrende Verwaltungsaufgaben und sorgt dafür, dass Informationen einheitlich, nachvollziehbar und nur für die jeweils berechtigten Personen zugänglich sind. Zu seinen Aufgaben gehören: - Verknüpfung von Discord-Mitgliedern mit SWGoH-Ally-Codes - Anzeige des persönlichen Kontos - Verwaltung von Absenzen und TB-Phasenabmeldungen - Verwaltung von Punkten und Challenges - Begleitung von Probezeiten - Empfang und Freischaltung von Neuankömmlingen - Kommunikationschecks - vertrauliche Sitzungen - Tagesrapport und Verwaltungsübersichten - demokratische Jahreswahlen Der Bot ersetzt keine persönliche Beurteilung und kein Gespräch. Er schafft eine verlässliche organisatorische Grundlage und reduziert manuelle Listen. # Wer darf welche Funktionen verwenden? | Benutzergruppe | Typische Möglichkeiten | | --- | --- | | Neuankömmlinge | Regeln bestätigen und privaten Empfang öffnen | | Aktive Mitglieder | Ally-Codes verwalten, eigenes Konto ansehen, Absenzen melden, Challenges beantragen und an Wahlen teilnehmen | | Empfangsteam | Empfang prüfen, Neuankömmlinge begleiten und Empfangsthreads abschliessen | | Offiziere und Anführer | Mitglieder-, Punkte-, Challenge-, Absenz-, Probezeit-, Rapport-, Kommunikationscheck- und Wahlverwaltung | | Ältestenrat | vertrauliche Sitzungen einsehen und verwalten | | Administratoren | Bot konfigurieren, bereitstellen, sichern und Fehler beheben | Ein sichtbarer Slash-Befehl bedeutet nicht automatisch, dass jede Person ihn verwenden darf. Der GuildBot kontrolliert beim Ausführen die Discord-Rollen und teilweise zusätzliche Discord-Berechtigungen. Die meisten persönlichen und administrativen Antworten sind nur für die ausführende Person sichtbar. Discord kennzeichnet solche Antworten mit dem Hinweis, dass nur du die Nachricht sehen kannst. # Erste Schritte # Slash-Befehle verwenden 1. Öffne in Discord einen Kanal, in dem der GuildBot verwendet werden darf. 2. Gib `/` ein. 3. Wähle einen Befehl des GuildBots. 4. Fülle die von Discord angezeigten Felder aus. 5. Prüfe deine Angaben und sende den Befehl ab. Mit `/hilfe` zeigt der Bot eine rollenabhängige Übersicht. Mitglieder sehen ihre Selbstverwaltungsbefehle; Offiziere erhalten zusätzliche Verwaltungsbereiche. Falls mehrere Ally-Codes registriert sind, zeigt der Bot bei kontobezogenen Vorgängen ein Auswahlmenü. Diese Auswahl ist nur für die ausführende Person sichtbar und läuft nach kurzer Zeit ab. # Registrierung Mit der Registrierung wird dein Discord-Konto mit einem oder mehreren SWGoH-Spielerkonten verbunden. ```text /register ally_code:123-456-789 ``` Der Ally-Code muss genau neun Ziffern enthalten. Bindestriche sind erlaubt. Weitere Spielerkonten können mit demselben Befehl ergänzt werden. Ein Ally-Code kann immer nur einem Discord-Mitglied zugeordnet sein. Der optionale Parameter `spieler` erlaubt die Zuordnung zu einem anderen aktiven Gildenmitglied. Verwende diese Möglichkeit nur mit Zustimmung der betroffenen Person oder für eine abgesprochene Korrektur. Historische Punkte und Challenges werden geschützt: War ein Ally-Code früher einer anderen Person zugeordnet und besitzt Historiedaten, verhindert der Bot eine automatische Übertragung. # Mein Konto anzeigen ```text /konto ``` Die persönliche Übersicht enthält je nach Datenbestand alle aktiven Ally-Codes, den Punktestand je Ally-Code, einzelne offene Punkte mit Datum und Grund, aktuelle und angekündigte Absenzen sowie offene Challenges und deren Status. Offiziere können über das optionale Feld `spieler` ein anderes Konto aufrufen. Normale Mitglieder können nur ihr eigenes Konto ansehen. # Befehlsübersicht für Mitglieder
BefehlZweck
`/hilfe`verfügbare Funktionen anzeigen
`/register`Ally-Code registrieren
`/unregister`Ally-Code-Zuordnung deaktivieren
`/mitglieder`registrierte Mitglieder und Ally-Codes anzeigen
`/konto`eigenes Konto mit Punkten, Absenzen und Challenges anzeigen
`/regel_list`aktive Punktegründe anzeigen
`/add_challenge`Challenge beantragen
`/edit_challenge`eigenen noch nicht genehmigten Antrag bearbeiten
`/cancel_challenge`eigene offene Challenge zurückziehen
`/challenge_list`eigene Challenges anzeigen
`/add_absenz`Absenz eintragen
`/edit_absenz`eigene Absenz bearbeiten
`/del_absenz`eigene Absenz löschen
`/tb_abmeldung`einzelne TB-Phasen abmelden
`/wahl status`Stand der aktuellen oder letzten Wahl anzeigen
Verwaltungsbefehle erscheinen teilweise ebenfalls in Discord, werden aber ohne erforderliche Rolle vom GuildBot abgewiesen. # Registrierung entfernen ```text /unregister ally_code:123-456-789 ``` Der Befehl deaktiviert die Zuordnung, löscht aber keine Historie. Eine spätere erneute Registrierung desselben Ally-Codes reaktiviert die bestehende Zuordnung. Mitglieder können nur eigene Ally-Codes abmelden. Offiziere dürfen fremde Zuordnungen korrigieren. Mit dem optionalen Feld `spieler` kann zusätzlich geprüft werden, ob der Ally-Code der erwarteten Person gehört. # Mitgliederübersicht ```text /mitglieder ``` Die Übersicht zeigt aktive registrierte Mitglieder mit ihren Ally-Codes. Die Antwort ist nur für die aufrufende Person sichtbar. Mitglieder ohne registrierten Ally-Code erscheinen nicht in der Liste. # Absenzen # Eine Absenz melden Eine Absenz informiert die Gildenleitung über einen Zeitraum eingeschränkter Verfügbarkeit. ```text /add_absenz von:02.10.2026 bis:10.10.2026 teilnahme: grund: ``` Pflichtfelder: - `von` und `bis`: Zeitraum im angezeigten Datumsformat - `teilnahme`: TB und Raid, nur TB, nur Raid oder keine Gildenevents - `grund`: Urlaub, Krankheit, Militär, Unfall, Beruf/Arbeit, Familie/Privat, Pause oder Sonstiges Das Enddatum darf nicht vor dem Startdatum liegen. Eine neue Absenz darf nicht vollständig in der Vergangenheit liegen. Medizinische oder andere sensible Einzelheiten sind nicht erforderlich. Offiziere können mit dem optionalen Feld `spieler` eine Absenz für ein anderes Mitglied erfassen. # Was eine Absenz bedeutet Eine Absenz verbessert die Planung, hebt bestehende Regeln aber nicht automatisch auf. Im Feld `teilnahme` wird ausdrücklich festgehalten, welche gemeinsamen Aktivitäten trotz Absenz gesichert sind. Wenn sich die Situation ändert, sollte der Eintrag mit `/edit_absenz` angepasst werden. Bei dringenden oder ungewöhnlichen Situationen ist zusätzlich eine kurze Information an die zuständige Leitung sinnvoll. # Absenz bearbeiten oder löschen ```text /edit_absenz id: /del_absenz id: ``` Bei `/edit_absenz` werden nur die angegebenen Felder geändert. Eigene laufende oder zukünftige Absenzen können selbst bearbeitet oder gelöscht werden. Vergangene Einträge dürfen nur Offiziere verändern. Die Absenz-ID findest du in `/konto` beziehungsweise in den Absenzübersichten. # Für einzelne TB-Phasen abmelden ```text /tb_abmeldung phasen:2,3,4 ``` Erlaubt sind die Phasen 1 bis 6. Mehrere Phasen werden mit Komma angegeben. Mit `keine` wird die Phasenabmeldung der aktuellen TB-Woche gelöscht. | Phase | Zeitraum | | --- | --- | | P1 | Montag/Dienstag | | P2 | Dienstag/Mittwoch | | P3 | Mittwoch/Donnerstag | | P4 | Donnerstag/Freitag | | P5 | Freitag/Samstag | | P6 | Samstag/Sonntag | Der Befehl funktioniert nur in einer als TB erkannten Woche. Offiziere können die Phasen für ein anderes Mitglied erfassen. # Punkte und Challenges # Das Punktesystem Punkte sind keine Strafe. Sie machen sichtbar, wenn eine vereinbarte Aufgabe für die Gemeinschaft nicht erfüllt werden konnte. > Eine Zusage an die Gemeinschaft konnte nicht eingehalten werden. Mit einer Challenge kann dafür später ein Ausgleich geschaffen werden. Jeder erfasste Vorgang ergibt genau einen Punkt. Punkte gehören zum jeweiligen Ally-Code, nicht pauschal zum Discord-Mitglied. Mehrere Spielerkonten besitzen daher getrennte Punktestände. Entscheidungen werden nie allein aufgrund einer Zahl getroffen. Punkte dienen als Trend- und Gesprächsgrundlage. # Challenges Challenges – auch Reparationen genannt – ermöglichen einen positiven Ausgleich. Eine Challenge ist eine konkrete, erreichbare und für die Gemeinschaft nützliche Aufgabe. Der Ablauf: 1. Mitglied beantragt eine Challenge. 2. Ein Offizier genehmigt sie und legt den verbindlichen Punktwert fest. 3. Das Mitglied erfüllt die Aufgabe. 4. Ein Offizier bestätigt den Abschluss. 5. Der Bot erledigt die ältesten offenen Punkte des betroffenen Ally-Codes. Punkte können nicht unter null sinken. # Challenge beantragen und verwalten ```text /add_challenge beschreibung: punkte_vorschlag:<1–5> ``` Bei mehreren Ally-Codes fragt der Bot nach dem betroffenen Account. Der Vorschlag darf den aktuellen offenen Punktestand dieses Accounts nicht überschreiten. Solange der Antrag noch nicht genehmigt ist: ```text /edit_challenge id: beschreibung: punkte_vorschlag: ``` Eine offene eigene Challenge kann mit `/cancel_challenge id:` zurückgezogen werden. Mit `/challenge_list` werden die eigenen Challenges angezeigt und können nach Status gefiltert werden. # Empfang für Neuankömmlinge # So funktioniert der Empfang 1. Discord verlangt die Zustimmung zu den Serverregeln. 2. Der GuildBot weist beim Beitritt genau eine automatische Rolle zu: `Willkommen`. 3. Erst nach bestätigten Serverregeln kann in der Rezeption **Privaten Empfang öffnen** gewählt werden. 4. Der Bot erstellt einen privaten Thread und fügt Neuankömmling sowie Empfangsteam hinzu. 5. Der Neuankömmling teilt mit, ob er Gast, Bewerber oder bereits Mitglied einer Gilde ist. 6. Das Empfangsteam vergibt eine passende Zugangsrolle. 7. **Empfang abschliessen** entfernt `Willkommen`, sperrt und archiviert den Thread. Ohne reguläre Zugangsrolle verweigert der Bot den Abschluss. Pro Person kann nur ein Empfangsgespräch gleichzeitig geöffnet sein. # Hilfe und häufige Fragen # Der Bot antwortet nicht Prüfe zuerst: 1. Wurde der richtige Slash-Befehl ausgewählt? 2. Sind alle Pflichtfelder ausgefüllt? 3. Wird das verlangte Datumsformat verwendet? 4. Besitzt du die erforderliche Discord-Rolle? 5. Ist ein benötigter Ally-Code registriert? 6. Ist der Bot in Discord online? Bei Problemen sende einem Administrator Befehl, ungefähren Zeitpunkt, Fehlermeldung und einen Screenshot ohne sensible Daten. # Datenschutz Der GuildBot verarbeitet nur Daten, die für die Gildenorganisation erforderlich sind. Dazu gehören insbesondere Discord-Benutzer-ID, Anzeigename, Ally-Codes, organisatorische Absenzen, Punkte, Challenges, Probezeiten sowie technische Audit-Einträge. Nicht in Bot-Felder, BookStack oder öffentliche Discord-Kanäle gehören: - Passwörter und Tokens - Adressen und Telefonnummern - medizinische Diagnosen - private Familien- oder Arbeitsdetails - Inhalte vertraulicher Gespräche ausserhalb des vorgesehenen Sitzungsthreads Für Absenzen genügt ein allgemeiner Grund. Für vertrauliche Sitzungen gilt: Nur der notwendige Personenkreis erhält Zugriff. # Kommunikation # Auf einen Kommunikationscheck reagieren Kommunikationschecks prüfen, ob wichtige Gildeninformationen zuverlässig ankommen. Ein Check erscheint entweder in einem ausgewählten Discord-Kanal oder als Direktnachricht. Zum Bestätigen wird der Button in der Nachricht verwendet. Jede Person kann einen Check nur einmal bestätigen. - bis 24 Stunden: rechtzeitig - nach 24 bis 72 Stunden: verspätet - danach: keine Reaktion Entschuldigte Abwesenheiten und nicht zustellbare Direktnachrichten werden gesondert behandelt. # Wahlbüro # Kandidieren Während der Ausschreibungsphase können aktive Mitglieder im Wahlkanal **Kandidieren** wählen. Danach wird ein Amt ausgewählt und optional eine kurze Vorstellung eingetragen. Zur Wahl stehen standardmässig 1 Anführer, 6 Offiziere und 2 Spielervertreter für den Ältestenrat. Pro Wahljahr kann jede Person nur für ein Amt kandidieren. Eine Kandidatur kann während der Ausschreibungsphase zurückgezogen werden. # Geheim abstimmen Eine Abstimmung findet nur statt, wenn es für ein Amt mehr Kandidaturen als Plätze gibt. Der Kreis der Wahlberechtigten wird beim Ende der Ausschreibungsphase festgeschrieben. Im persönlichen Stimmzettel können höchstens so viele Personen gewählt werden, wie Plätze verfügbar sind. Weniger Stimmen sind zulässig. Die Stimmabgabe kann bis zum Ende der Frist geändert werden. Das öffentliche Dashboard zeigt nur die Beteiligung, keine Zwischenstände einzelner Kandidaten. Bei Gleichstand am letzten zu vergebenden Platz folgt eine Stichwahl. Das Ergebnis wird erst nach Kontrolle durch die Wahlleitung bestätigt.