GuildBot – Benutzerhandbuch

Öffentliches Benutzerhandbuch zum Nebelreich-GuildBot für Mitglieder, Bewerber, Gäste und Interessierte.

Willkommen beim GuildBot

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:

Der Bot ersetzt keine persönliche Beurteilung und kein Gespräch. Er schafft eine verlässliche organisatorische Grundlage und reduziert manuelle Listen.

Willkommen beim GuildBot

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

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.

Erste Schritte

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.

Erste Schritte

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.

Erste Schritte

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.

Erste Schritte

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.

Erste Schritte

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

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:<Auswahl> grund:<Auswahl>

Pflichtfelder:

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.

Absenzen

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.

Absenzen

Absenz bearbeiten oder löschen

/edit_absenz id:<Absenz-ID>
/del_absenz id:<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.

Absenzen

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

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.

Punkte und Challenges

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.

Punkte und Challenges

Challenge beantragen und verwalten

/add_challenge beschreibung:<Aufgabe> 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:<ID> beschreibung:<optional> punkte_vorschlag:<optional>

Eine offene eigene Challenge kann mit /cancel_challenge id:<ID> zurückgezogen werden. Mit /challenge_list werden die eigenen Challenges angezeigt und können nach Status gefiltert werden.

Empfang für Neuankömmlinge

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

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.

Hilfe und häufige Fragen

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:

Für Absenzen genügt ein allgemeiner Grund. Für vertrauliche Sitzungen gilt: Nur der notwendige Personenkreis erhält Zugriff.

Kommunikation

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.

Entschuldigte Abwesenheiten und nicht zustellbare Direktnachrichten werden gesondert behandelt.

Wahlbüro

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.

Wahlbüro

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.