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 Öffne in Discord einen Kanal, in dem der GuildBot verwendet werden darf. Gib / ein. Wähle einen Befehl des GuildBots. Fülle die von Discord angezeigten Felder aus. 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. /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 /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 Befehl Zweck /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 /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 /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. /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 /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 /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: Mitglied beantragt eine Challenge. Ein Offizier genehmigt sie und legt den verbindlichen Punktwert fest. Das Mitglied erfüllt die Aufgabe. Ein Offizier bestätigt den Abschluss. Der Bot erledigt die ältesten offenen Punkte des betroffenen Ally-Codes. Punkte können nicht unter null sinken. Challenge beantragen und verwalten /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: /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 Discord verlangt die Zustimmung zu den Serverregeln. Der GuildBot weist beim Beitritt genau eine automatische Rolle zu: Willkommen. Erst nach bestätigten Serverregeln kann in der Rezeption Privaten Empfang öffnen gewählt werden. Der Bot erstellt einen privaten Thread und fügt Neuankömmling sowie Empfangsteam hinzu. Der Neuankömmling teilt mit, ob er Gast, Bewerber oder bereits Mitglied einer Gilde ist. Das Empfangsteam vergibt eine passende Zugangsrolle. 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: Wurde der richtige Slash-Befehl ausgewählt? Sind alle Pflichtfelder ausgefüllt? Wird das verlangte Datumsformat verwendet? Besitzt du die erforderliche Discord-Rolle? Ist ein benötigter Ally-Code registriert? 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.