Hilfe für Norn

Norn ist ein Bot auf Discord und IRC. Alle Kanäle mit dem gleichen Namen, egal auf welchem Discord Server oder IRC Server teilen sich die Daten (Notizen, Termine, Links und Antworten). In der Umkehrung heisst das auch, dass all diese Dinge zwischen unterschiedlich benannten Kanälen nicht geteilt werden.

Norn muss direkt angesprochen werden.

Auf IRC, mit den Namen gefolgt von einem Doppelpunkt oder einem Komma:

**alex** norn: 1d6

**norn** alex: 2

Auf Discord, mit einem Affenschwanz gefolgt vom Namen:

**Alex** 🌈 🦄 🧞 @Norn 1d6

**Norn** kensanata: 6

Würfeln:

• Würfelnotation: W20 W20+1 1W4x10 1W6x2+3
• mehrere Würfe: 3W6 6x (wobei das x optional ist und auch vor der Zahl stehen kann: 3W6 x6, oder 3W6 6)
• die besten Würfel zählen: 4W6kh3 (kh = keep highest = behalte die höchsten, dh. 2W20kh1 ist mit Vorteil würfeln)
• die schlechtesten Würfel zählen: 2W20kl1 (kl = keep lowest = behalte die tiefsten, dh. 2W20kl1 ist mit Nachteil würfeln)

Notizen in einem Kalender:

• **notiz von `<zeitangabe>` bis `<zeitangabe>` `<text>`** legt eine Notiz für diesen Zeitraum an (per Default für heute)
• **status `<zeitangabe>`** zeigt die Ereignisse für diesen Tag (per Default für heute)
• **übersicht von `<zeitangabe>` bis `<zeitangabe>` `<text>`** zeigt die Ereignisse für diesen Zeitraum (per Default für die letzten und für die nächsten zwei Wochen)
• **vergiss die notiz vom `<zeitangabe>` von `<autor>` mit `<text>`** vergisst die Notiz (wobei alle Zusatzangaben optional sind)

`<zeitangabe>` ist entweder ein Datum wie 2022-06-20, 20.6.2022, 20.6., 20. Juni, oder ±n (Tage), ±nw (Wochen) oder ±nm (Monate), oder n. (der Tag des Monats), oder das Wort "gestern", "heute" oder "morgen", oder ein Wochentag: "Mo", "Montag", "Di", "Dienstag", "Mi", "Mittwoch", "Do", "Donnerstag", "Fr", "Freitag", "Sa", "Samstag", "So", "Sonntag", auch in Kombination mit dem Wort "nächsten", z.B. "nächsten Montag" oder sogar "nächste Woche".

`<alle paar wochen>` ist eine Formulierung wie "jede Woche", "jede zweite Woche", "alle drei Wochen", "alle vier Wochen".

Spiele verwalten. Es kann pro Tag und Kanal nur ein Spiel geben.

• **spiele von `<zeitangabe>` bis `<zeitangabe>` mit `<text oder person>`** zeigt die Spiele zwischen diesen beiden Tagen, für alle Kanäle, optional mit einem bestimmten Text in der Beschreibung oder mit einer bestimmten Person (per Default alle Spiele ab heute für die nächsten zwei Wochen)
• **spiele am `<zeitangabe>`** oder **anmeldungen am `<zeitangabe>`** zeigt die Spiele an diesem Tag, für alle Kanäle
• **anmeldung von `<name>` am `<zeitangabe>`** meldet jemanden an diesem Tag, in diesem Kanal zum Spiel an (per Default die Absenderin oder den Absender, beim nächsten Spiel)
• **abmeldung von `<name>` am `<zeitangabe>`** meldet jemanden an diesem Tag, in diesem Kanal vom Spiel ab (per Default die Absenderin oder den Absender, beim nächsten Spiel)
• **spiel am `<zeitangabe>` mit `<n>` Plätzen: `<text>`** legt ein Spiel an diesem Tag an, oder passt das bestehende Spiel an, in diesem Kanal, mit der folgenden Beschreibung (die ist obligatorisch, einzeilig); falls es im Text ein oder zwei Uhrzeiten im 24h Format gibt, werden diese als Start- und Endzeit verwendet (per Default 20:15–22:00)
• **wiederhole das spiel vom `<zeitangabe>` `<alle paar wochen>` bis `<zeitangabe>`** legt eine Kopie des Spiels von diesem Tag an, in diesem Kanal, im angegebenen Wochenabstand, bis zum angegebenen Enddatum
• **vergiss das spiel am `<zeitangabe>` mit `<text>`** löscht das Spiel an diesem Tag, in diesem Kanal, mit diesem Text (per Default das heutige Spiel)
• **report `<jahr>` `<namen>`** zeigt eine Tabelle der geleiteten Spiele und der Anmeldungen, für das angegebene Jahr, für die angegebenen Namen (per Default das aktuelle Jahr und die Absenderin oder den Absender)

Neue Spiele und Änderungen an Spielen können in anderen Kanälen angekündigt werden.

• **ankündigungen in `<kanal>`** kündigt neue Spiele und Änderungen an Spielen im angegebenen Kanal
• **keine ankündigungen in `<channel>`** stopt die Ankündigungen im angegebenen Kanal
• **ankündigungen** listet alle Ankündigungskanäle auf

Fragen und Antworten:

• **antworte auf `<frage>` mit `<antwort>`** bringt dem Bot neue Antworten bei; dies sind lokale Antworten und gelten nur für den aktuellen Kanal
• **antworte auf `<frage>` immer mit `<antwort>`** macht dies zu einer globalen Antwort die für alle Kanäle gilt
• **debug `<frage>`** zeigt an, was der Bot antworten würde, ohne die doppelten eckigen Klammern auszuführen; globale Antworten kriegen einen Globus
• **vergiss die antwort auf `<frage>`** lässt den Bot eine Antwort vergessen; falls eine lokale Antwort existiert, wird diese zuerst vergessen
• **`<frage>`** lässt den Bot die entsprechende Antwort geben; lokale Antworten werden bevorzugt

Bei diesen Antworten wird Würfelnotation in doppelten eckigen Klammern ausgeführt, z.B. `[[3W6]]`. So kann man pro Kanal Makros erstellen. Diese gelten allerdings für alle Personen im Kanal.

Beispiel:

**Alex** @Norn antworte auf feuerball mit Riesenexplosion! `[[8W6]]` Schaden!!

**Alex** @Norn feuerball

Zudem werden Antworten rekursiv ersetzt, und mehrere Antworten können mit dem vertikalen Strich voneinander getrennt werden.

Beispiel für eine Wahl zwischen zwei Antworten:

**Alex** @Norn antworte auf donnerkeil mit Fetter Blitzschlag! `[[8W6]]` Schaden!!

**Alex** @Norn antworte auf zauber mit `[[feuerball|donnerkeil]]`

**Alex** @Norn zauber

Linkblog:

• **`<url>` `<beschreibung>`** fügt URL und Beschreibung dem Linkblog hinzu

Linkblog

IRC und Discord, als eine Art manueller Brückenschlag:

• **sag `<discord oder irc>` `<text>`**
• **serverliste**

Auf IRC kann man von Norn auch ein Log der letzten Beiträge erhalten. Diese Einträge bestehen nur im Speicher. Wird der Bot neu gestartet, ist der Log leer.

• **/msg norn log ​#welcome**

Update von Dateien und Wiki forcieren:

• **update wiki** – update der Wiki Seite
• **write files for ** – schreibt die HTML Dateien für den angebenen Kanal und für alle Kanäle ("all")
• **write calendar for ** – schreibt die ICS Kalender-Dateien für den angebenen Kanal und für alle Kanäle ("all")

Die obenstehenden Befehle sind nur für Administratoren gedacht und beispielsweise nach Code-Änderungen nützlich.