Zählbot: Unterschied zwischen den Versionen

Aus Werwolf Online
(WIP)
 
(vorerst fertig)
Zeile 1: Zeile 1:
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 automatisiert das Auszählen von Stimmen während Forenspielen und bietet weitere Funktionen, wie das Posten von Lynchständen.
Der Zählbot wurde im März 2024 komplett überarbeitet und bietet nun eine Benutzoberfläche, damit nicht mehr alles per [[BBCodes]] geregelt werden muss.


== Für Spieler ==
== Für Spieler ==
Alle hier beschriebenen Optionen hat man nur, wenn man [[Spielleiter]] ist!


=== Abstimmen ===
=== Abstimmen ===


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


# Im Editor <code>!</code> eingeben, gefolgt von mindestens den ersten Buchstaben der Person, auf die man stimmen will. Es erfolgt eine Liste von Namensvorschlägen, äquivalent dazu, wenn man mit <code>@</code> eine Person erwähnen will. (Diese Liste kann am PC mit den Pfeiltasten und Enter navigiert werden.)
# Im Editor <code>!</code> 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 <code>@</code> eine Person erwähnen will. Diese Liste kann am PC mit den Pfeiltasten und Enter navigiert werden.
# 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.
# 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.
# Manuell via den BBCode <code>[v]Name[/v]</code>.
# Manuell via den BBCode <code>[v]Name[/v]</code>.
Zeile 23: Zeile 23:
=== Stände und Verläufe ===
=== 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. Es wird immer der Stand bzw. Verlauf eingefügt.
Ü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 ==
== Für Spieleiter ==
Alle hier beschriebenen Optionen hat man nur, wenn man [[Spielleiter]] ist!


=== Wahl erstellen ===
=== Wahl erstellen ===


Beim Erstellen eines Threads 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.
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.
* 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.
* Monarchie: "Name der Wahl für Tag 0" auf "Monarchen-Wahl" ändern.
* Sonderspiel: Spiel abhängig, im Zweifelsfalls Xaver fragen.
* Sonderspiel: Abhängig vom Spiel, im Zweifelsfalls Xaver fragen.


Das Textfeld für die Spielerliste ist so konzipiert, dass einfach die Spielerliste aus dem Term 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.
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!
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!


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 weiter Posts erstellt werden.
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 ===
=== Spielerliste ===


Wenn das Spiel bis erstellt wurde, kann die Spielerliste über den Tab "Wahlen" unter dem Editor verwaltet werden. Jede Änderung an der Spielerliste erfolgt sofort am automatisch erstellten Post. Der Post automatisch bearbeitet, allerdings erscheint die Bearbeitung unter dem Namen der Person, die die Spielerliste bearbeitet (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.
Wenn das Spiel erstellt wurde, kann die Spielerliste über den Tab "Wahlen" unter dem Editor verwaltet werden. Jede Änderung an der Spielerliste erfolgt sofort. Der Post mit der Liste wird automatisch bearbeitet, allerdings erscheint die Bearbeitung unter dem Namen der Person, die die Liste bearbeitet hat (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:
Bei der Bearbeitung eines Spielers erscheinen folgende Optionen:
* Name: Der Name des Spielers.
* Name
* Farbliche Markierung: Dies sind dieselben Markierungsoptionen, wie auch im Editor. Es ist angedacht, dass diese benutzt werden, um Gesinnungen anzugeben (grün = Dorf, rot = Wolf, gelb = Drittpartei). Spielleiter aber die Wahl, dies machen oder nicht.
* Farbliche Markierung: Dies sind dieselben Markierungsoptionen, wie auch im Editor. Es ist angedacht, dass diese benutzt werden, um Gesinnungen anzugeben (grün = Dorf, rot = Wolf, gelb = Drittpartei). Spielleiter aber die Wahl, dies machen oder nicht.
* 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.
* 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 durch gestrichen. Sollte im Todesfall desaktiviert werden. Hat in Zukunft vielleicht weitere Auswirkungen.
* 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: Selbsterklärend.
* Löschen: Löscht den Spieler aus Liste, sollte in der Regel nicht notwendig sein.


=== Wahlen verwalten ===
=== Wahlen verwalten ===
Zeile 57: Zeile 59:


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.
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. [[Rabe|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.

Version vom 2. März 2024, 13:33 Uhr

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 im März 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).

Wichtig: Falls es mehrere Wahlen gleichzeitig gibt (siehe Unruhestifterin), ist 2. aktuell die einzige Möglichkeit, für die zweite Wahl abzustimmen (es erscheint eine Auswahl, für welche Wahl man abstimmen will). 1. und 3. stimmen immer für die erste aktive Wahl ab.

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.

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!

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!

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. Der Post mit der Liste wird automatisch bearbeitet, allerdings erscheint die Bearbeitung unter dem Namen der Person, die die Liste bearbeitet hat (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 auch im Editor. Es ist angedacht, dass diese benutzt werden, um Gesinnungen anzugeben (grün = Dorf, rot = Wolf, gelb = Drittpartei). Spielleiter aber die Wahl, dies machen oder nicht.
  • 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.