Zum Hauptinhalt springen

Variablen und Ausdrücke

Dieser Teil ist für den Fall, dass sich eine Zahl mit dem Bogen ändern soll. Für die meisten einfachen Regeln reichen der Modus „Fest“ und der visuelle Baukasten.

Was bedeutet @forca?

Eine Variable ist ein Kurzname für einen Wert im Bogen. @forca liest Stärke; @forca + 2 nimmt diesen Wert und addiert 2. Ist Stärke 3, ist das Ergebnis 5. Das @ sagt dem Editor, dass es eine Variable ist.

Nutze die Namen, die der Editor vorschlägt. Namen mit Leerzeichen setzt du in geschweifte Klammern: @{Força Bruta}. Modifikatoren und Maximalwerte haben meist eigene Namen, etwa @forca_mod und @vida_max.

Ein Variablenname, den es nicht gibt, zählt als 0. Das ist die häufigste Ursache für falsche Ergebnisse. Schreibtipps: Nutze einen Punkt für Dezimalzahlen (1.5), * zum Multiplizieren (@forca * 2) und Anführungszeichen um Text ("fire").

@nivel + 2
floor((@forca - 10) / 2)
clamp(@vida + 5, 0, @vida_max)
@{Força Bruta} * 2

Wie du eine Ja-oder-Nein-Frage schreibst

Eine Bedingung ist eine Frage. @vida > 0 fragt, ob Leben größer als null ist. @forca >= 3 fragt, ob Stärke 3 oder mehr ist. > ist größer als; >= ist größer oder gleich; < ist kleiner als; <= ist kleiner oder gleich.

== fragt, ob zwei Werte gleich sind (zwei Gleichheitszeichen), und != fragt, ob sie verschieden sind. and bedeutet, dass beide Fragen Ja sein müssen. or bedeutet, dass eine reicht. not dreht die Antwort um. Klammern fassen zusammen, wie beim Rechnen.

Der Schritt Wenn wählt einen ganzen Weg. Wenn du nur innerhalb einer Rechnung zwischen zwei Werten wählen willst, nutze if(Frage, Wert bei Ja, Wert bei Nein). Text muss Buchstabe für Buchstabe passen: Fight und fight sind verschieden.

@forca >= 3 and @vida > 0
$event.attribute == "agilidade"
if(@nivel >= 5, 2, 1)
if(@vida <= 0, "Am Boden", "Steht")

Fortgeschritten: $event, $sheet und das Ergebnis eines anderen Schritts

Das brauchst du nur in Regeln, die Wurfdaten oder das Ergebnis eines früheren Schritts nutzen. $event liest, was die Regel gestartet hat (zum Beispiel den Wurf). $sheet liest den ganzen Bogen. $("Schrittname") liest das Ergebnis eines Schritts, der schon gelaufen ist.

In einer Wurfregel bietet $event formula, total, dice, skillName und attribute. Was es gibt, hängt vom Auslöser ab: Bevor gewürfelt wird, gibt es total und dice noch nicht.

$sheet enthält Attribute, Fertigkeiten, Leben, Mana, Felder, Karten und das Gedächtnis des Bogens (memory). Wenn etwas eine Liste ist, nimmt [0] das erste Element, [1] das zweite und so weiter. Wenn ein Wert nicht existiert, erscheint er als null, das heißt „leer“.

Um $("Schrittname") zu nutzen, kopiere den Schrittnamen genau und verwende diesen Namen bei keinem anderen Schritt. Der Schritt, den du liest, muss vorher auf demselben Weg gelaufen sein. Fragen liefert direkt die Antwort. Auswählen liefert das gewählte Element mit Angaben wie name, total und targets (die Felder dieses Elements).

Wenn ein Wert leer sein kann, setzt coalesce(Wert, 0) stattdessen 0 ein. Nur leere Werte werden ersetzt: Eine 0 oder ein leerer Text bleiben, wie sie sind.

$("Würfeln").total
$("Fragen")
$("Auswählen").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)

Wie du einen Wert in einen Text oder Wurf einsetzt

In Zahlen- oder Bedingungsfeldern schreibst du die Rechnung direkt. In Text- oder Würfelfeldern setzt du im Ausdrucksmodus nur den berechneten Teil zwischen {{ und }}. Zum Beispiel: Gesamt: {{ @forca + 2 }} zeigt Gesamt: 5, wenn Stärke 3 ist.

Um 1d20 zu würfeln, nutze den Schritt Würfeln: Ein Ausdruck allein würfelt nicht. Würfelformeln können Variablen des Bogens nutzen; die Würfelanleitung erklärt Optionen wie den höchsten Würfel behalten oder explodierende Würfel.

Text im Ausdrucksmodus:
Gesamt: {{ $("Würfeln").total }}

Würfel im Ausdrucksmodus:
1d20 + {{ @forca_mod }}

Bedingung im Ausdrucksmodus:
@vida > 0

Fertige Rechnungen (Funktionen)

Eine Funktion ist eine fertige Rechnung, die du in einer Formel nutzt. max(@dano - 2, 0) zieht 2 vom Schaden ab, geht aber nie unter 0. clamp(@vida + 5, 0, @vida_max) addiert 5 zu Leben und hält das Ergebnis zwischen 0 und dem Maximum.

min nimmt den kleinsten Wert und max den größten. floor rundet ab, ceil rundet auf und round rundet zum nächsten Wert.

Für Listen: sum addiert, avg bildet den Durchschnitt, len zählt die Elemente, first und last nehmen das erste und letzte, und contains prüft, ob etwas in der Liste ist. Für Text: upper und lower wandeln in Groß- oder Kleinbuchstaben um.

Es gibt weitere mathematische Funktionen, etwa Quadratwurzel, Potenz und Trigonometrie. Für den Anfang brauchst du sie nicht; die Ausdrucksanleitung im Editor listet alle auf.

max(@dano - 2, 0)
ceil(@nivel / 4)
round(2.5)
contains(["forca", "agilidade"], $event.attribute)
join($event.dice, " + ")