Zählbot

Der Zählbot automatisiert das Auszählen von Stimmen während Forenspielen und bietet weitere Funktionen, wie das Posten von Lynchständen.

Der Zählbot wurde Anfang 2024 komplett überarbeitet und bietet nun eine Benutzoberfläche, damit nicht mehr alles per BBCodes geregelt werden muss.

Für Spieler

Abstimmen

Damit deine Stimme bei einer Wahl zählt, muss sie mittels des Zählbots abgegeben werden. Dazu gibt es drei Möglichkeiten:

1. Im Editor ! eingeben, gefolgt von mindestens den ersten zwei Buchstaben der Person, auf die man stimmen will. Es wird eine Liste mit Namensvorschlägen angezeigt, äquivalent dazu, wenn man mit @ eine Person erwähnen will. Diese Liste kann am PC mit den Pfeiltasten und Enter navigiert werden.
2. In der Editor-Leiste ganz rechts auf den Wahlen-Button klicken und dann auf den ersten Button links, der erscheint (eine Person, die in eine Wahlkabine geht). Hier kann dann ein Name eingegeben werden.
3. Manuell via den BBCode [v]Name[/v].

Falls der Spielleiter eine Spielerliste mit dem Zählbot erstellt hat, erscheinen bei den Vorschlägen zuerst diese Spieler, wobei eine gewisse Anzahl an Tippfehlern erlaubt ist. Danach erst erscheinen Vorschläge für sonstige Benutzer (keine Tippfehler erlaubt).

Falls es mehrere Wahlen gleichzeitig gibt (siehe Unruhestifterin), kann mittels 2. für eine beliebige Wahl abgestimmt werden. Alternativ kann ? und [v2][/v2] äquivalent zu ! und [v][/v] für eine zweite Wahl benutzt werden.

Weitere Hinweise:

• Abstimmen funktioniert natürlich nur in Spielen. Anderswo im Forum kann man zwar [v]Name[/v] benutzen, aber es erscheint dann immer nur "ungültiger Vote".
• Stimmen, die sich in Zitaten oder Spoiler befinden, werden nicht gezählt und sind ungültig.
• Sollte es nur eine aktive Wahl geben, stimmt ? und [v2][/v2] für diese ab.

Unvote

Im Fall, wo man seine Stimme zurückziehen will, kann man dies mittels der Eingabe eines leeren Vote-Codes tun. Also exakt [v][/v] (bzw. [v2][/v2]) ohne Namen. Diesen leeren Code kann man auch mittels 2. (siehe Liste oben) einfügen.

Stände und Verläufe

Über den Wahlen-Button in der Editor-Leiste können ganz einfach Stände und Verläufe für Wahlen in den Editor eingefügt werden. Standardmäßig ist immer der aktuelle Tag vorausgewählt. Es gibt Optionen, um die Namen farblich wie in der Spielerliste zu markieren, und um mehrere Stände oder Verläufe gleichzeitig einzufügen.

Für Spieleiter

Alle hier beschriebenen Optionen hat man nur, wenn man Spielleiter ist!

Kurzfassung für ein Standardspiel

Hier die wichtigsten Punkte, um ein normales Standardspiel zu leiten:

• Spiel erstellen: Die meisten Felder sind bereits korrekt ausgefüllt. Nur die Deadline für die HD-Wahl muss eingestellt und die Spielerliste in das große Textfeld kopiert werden.
• Tag beenden: Dies tut der Bot automatisch bei Ablauf der Deadline.
• Nacht beenden: Im Editor den Tab "Wahlen" (ganz rechts, am Handy sieht man nur ein Symbol) auswählen und dort dann den ersten Punkt "HD-Wahl/Lynchung". Ein Häkchen bei "Nächsten Tag mit Deadline starten" setzten (die Deadline wird automatisch um 24 Stunden verlängert und muss nicht angepasst werden). Eine neue Wahl unter "Wahl erstellen" zu erstellen, ist nicht notwendig! Jetzt den Post absenden, um die Änderung zu speichern.

Alles Weitere, wie z.B. Spielerliste verwalten und Stimmwerte ändern ist nachfolgend ausführlich erklärt. Bitte bei Bedarf aufmerksam lesen.

Wahl erstellen

Beim Erstellen eines Themas im Unterforum für die Spiele gibt es den Bereich Wahl erstellen. Für Standardspiele sollten die meisten Dinge bereits korrekt voreingestellt sein. Es muss nur die Deadline und die Spielerliste eingegeben werden.

• Classic und Spiele ohne HD-Wahl: "Starte mit Tag Nummer" muss auf "1" gesetzt werden.
• Monarchie: "Name der Wahl für Tag 0" auf "Monarchen-Wahl" ändern.
• Sonderspiel: Abhängig vom Spiel, im Zweifelsfalls Xaver fragen.

Das Textfeld für die Spielerliste ist so konzipiert, dass einfach die Spielerliste aus dem Termin kopiert werden kann. Leerzeilen und Leerzeichen (und Tabs und sonstiges Whitespace) vor und hinter Namen werden ignoriert. Falls die entsprechende Option nicht desaktiviert wird, werden die eingegebenen Namen mit Benutzername abgeglichen, und es wird eine Fehlermeldung beim Absenden geworfen, falls ein Name falsch geschrieben wurde.

Standardmäßig wird automatisch ein Post vom Bot mit der angegebenen Spielerliste erstellt (auch wenn sie leer ist). Dies kann desaktiviert werden, allerdings ist es dann nicht mehr nachträglich möglich, eine automatisch verwaltete Spielerliste zu erstellen!

Das Feld "Verlängerung der Deadline" gibt an, um wie viele Minuten die Voreinstellung für die nächste Deadline gegenüber der vorherigen Deadline erhöht werden soll, wenn ein neuer Tag gestartet wird. Der Wert von 1440 Minuten (= 1 Tag) muss nur geändert werden, wenn man ein Spiel mit z.B. 48 Stunden Tagen leitet.

Es ist aus Gründen des Aufwands der Implementierung nicht möglich, mehrere Wahlen direkt mit der Erstellung des Spiels zu erstellen. Sollten mehrere Wahlen zu Spielbeginn notwendig, müssen diese mit weiteren Posts erstellt werden.

Spielerliste

Wenn das Spiel erstellt wurde, kann die Spielerliste über den Tab "Wahlen" unter dem Editor verwaltet werden. Jede Änderung an der Spielerliste erfolgt sofort und der Post mit der Liste wird automatisch bearbeitet. Die Bearbeitung erscheint unter dem Namen der Person, die die Liste bearbeitet hat im Bearbeitungsverlauf (für den Fall, dass jemand auf dumme Ideen kommt ;) ). Der gesamte Inhalt des Posts wird dabei überschrieben, es hat also (außer nach Spielende) keinen Sinn, den Post mit der Spielerliste manuell zu bearbeiten.

Bei der Bearbeitung eines Spielers erscheinen folgende Optionen:

• Name
• Farbliche Markierung: Dies sind dieselben Markierungsoptionen wie im Editor. Es ist angedacht, dass diese benutzt werden, um Gesinnungen anzugeben (grün = Dorf, rot = Wolf, gelb = Drittpartei). Spielleiter haben aber die Wahl, ob und wie genau sie das machen.
• Zusätzlicher Text: Dieser Text erscheint in der Liste hinter dem Namen (getrennt durch ein "-"), und kann benutzt werden, um die Rolle, Todesart und Sonstiges anzugeben.
• Aktiver Spieler: Falls desaktiviert, wird der Name des Spielers in der Liste durchgestrichen. Sollte im Todesfall desaktiviert werden. Hat in Zukunft vielleicht weitere Auswirkungen.
• Löschen: Löscht den Spieler aus Liste, sollte in der Regel nicht notwendig sein.

Wahlen verwalten

Im Tab "Wahlen" unter dem Editor befindet sich eine Liste aller Wahlen (in der Regel nur eine). Hier kann eine Wahl vorzeitig beendet, oder nach der Nacht erneut gestartet werden. Außerdem kann die Deadline bearbeitet werden. Es ist aktuell nicht vorgesehen, dass eine Wahl weiter bearbeitet werden kann (z.B. der Name). Bitte alles direkt korrekt einstellen.

Normalerweise sollte es nicht notwendig sein, dass eine Wahl vorzeitig beendet wird, da der Bot eine Wahl nach Ende der Deadline automatisch beendet und den Stand und Verlauf postet.

Zudem können zusätzliche Stimmen (z.B. Rabenstimmen) hinzugefügt werden und der Stimmwert von Personen verändert werden (z.B. für einen HD mit 2 Stimmen). Die Stimmwertänderung ist dauerhaft und muss manuell wieder zurückgesetzt werden, wenn sie nur für eine begrenzte Dauer gelten soll!

All diese Änderungen treten erst mit dem Absenden des Posts in Kraft (im Gegensatz zu Änderungen an der Spielerliste). Im Falle, wo man einen neuen Tag startet und gleichzeitig zusätzliche Stimmen hinzufügt, gelten diese Stimmen für den neuen Tag.

Mehrere Wahlen

Wie bereits erwähnt, ist es nicht möglich, mehrere Wahlen zu Spielbeginn zu starten. Dafür kann man beim Verfassen eines Posts im Tab "Wahlen" eine neue Wahl konfigurieren. Es gelten hier dieselben Optionen wie beim Erstellen eines Themas.

Unter "Starte mit Tag Nummer" ist immer der aktuelle Tag der bereits bestehenden Wahl eingetragen. Dies sollte nicht geändert werden, da es sonst zu der verwirrenden Situation kommt, dass es mehrere Wahlen gibt, die sich an unterschiedlichen Tagen befinden.

Wahlen sind komplett unabhängig voneinander. Sie können unterschiedliche Deadlines haben und Stimmwertänderungen gelten immer nur für die Wahl, bei der sie vorgenommen werden. Nur die Spielerliste teilen sich sämtliche Wahlen eines Spiels.

Automatische Aktualisierung des Titels

Falls der Titel des Spiels auf [Leerzeichen][X]/[Y] endet (wobei X und Y Zahlen sind), wird der Titel automatisch angepasst, wenn in der Spielerliste jemand als tot markiert wird. Sollte dies nicht gewünscht sein, muss der Titel so geändert werden, dass er nicht der obigen Anforderung genügt (z.B. durch Anhängen eines zusätzlichen Zeichens).

Beim Erstellen eines Spiels ist eine Option vorausgewählt, die automatisch [Leerzeichen][X]/[X] (X = Spieleranzahl) an den Titel anhängt.

Partnerspiele

Der Zählbot unterstützt mitlerweile Partnerspiele. Hierzu können in der Spielerliste die Spieler als Gruppenname, Name1, Name2(, ..., NameN) angegeben werden. Es kann können auch andere Trennzeichen benutzt werden: ,|: und / (bei Bedarf können mehr hinzugefügt werden).

Dann werden Stimmen auf ein Mitglied dieser Gruppe als Stimme auf die Gruppe gewertet und Stimmen eines Mitglied dieser Gruppe als Stimme der Gruppe.

Zum Bot

Der Bot erstellt zu Spielbeginn einen Post mit der Spielerliste, falls dies nicht vom Spielleiter desaktiviert wurde. Außerdem postet er automatisch bei Ablauf einer Deadline den finalen Stand der Wahl und den Verlauf. Damit dies getriggert wird, muss allerdings jemand zur betreffenden Zeit WWO aufrufen (technische Limitierung der Forensoftware). Wenn also um 20:00 Deadline ist, aber erst um 20:14 als Nächstes jemand das Forum aufruft, postet der Bot erst um 20:14. Die Person, die den Bot getriggert hat, muss dann nochmal die Seite aktualisieren, um den Post zu sehen.

Eine weitere Limitierung ist, dass höchstens alle 5 Minuten überprüft wird, ob eine Deadline abgelaufen ist. Wenn also eine Deadline für 20:01 eingestellt ist, postet der Bot frühestens um 20:05. Stimmen zählen allerdings natürlich nur bis zum Ende der Deadline, egal ob der Bot die Wahl schon beendet hat oder nicht. Heißt: Keine krummen Deadlines verwenden.

Changelog

• 2. April 2024: Abstimmen per ? und [v2].