Vai al contenuto principale

Variabili ed espressioni

Questa parte serve quando un numero deve cambiare insieme alla scheda. Per la maggior parte delle regole semplici bastano la modalità Fixed e il costruttore visuale.

Cosa significa @forca?

Una variabile è un soprannome per un valore della scheda. @forca legge la Forza; @forca + 2 prende quel valore e aggiunge 2. Se la Forza è 3, il risultato è 5. La @ dice all'editor che si tratta di una variabile.

Usa i nomi che l'editor suggerisce. Per i nomi con spazi, mettili tra parentesi graffe: @{Força Bruta}. Modificatori e massimi di solito hanno nomi propri, come @forca_mod e @vida_max.

Un nome di variabile che non esiste vale 0. È la causa più comune di risultati sbagliati. Consigli di scrittura: usa il punto per i decimali (1.5), * per moltiplicare (@forca * 2) e le virgolette intorno al testo ("fuoco").

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

Come scrivere una domanda sì o no

Una condizione è una domanda. @vida > 0 chiede se la Vita è sopra zero. @forca >= 3 chiede se la Forza è 3 o più. > è maggiore di; >= è maggiore o uguale; < è minore di; <= è minore o uguale.

== chiede se due valori sono uguali (due segni di uguale) e != chiede se sono diversi. and significa che entrambe le domande devono essere sì. or significa che ne basta una. not inverte la risposta. Le parentesi raggruppano, come in aritmetica.

Il passo If sceglie un intero percorso. Se vuoi solo scegliere tra due valori dentro un calcolo, usa if(domanda, valore se sì, valore se no). Il testo deve corrispondere lettera per lettera: Lotta e lotta sono diversi.

@forca >= 3 and @vida > 0
$event.attribute == "agilidade"
if(@nivel >= 5, 2, 1)
if(@vida <= 0, "A terra", "In piedi")

Avanzato: $event, $sheet e il risultato di un altro passo

Ti serve solo nelle regole che usano i dati del tiro o il risultato di un passo precedente. $event legge ciò che ha avviato la regola (per esempio, il tiro). $sheet legge tutta la scheda. $("Step name") legge il risultato di un passo che è già stato eseguito.

In una regola di tiro, $event offre formula, total, dice, skillName e attribute. Cosa esiste dipende dal trigger: prima che i dadi vengano tirati, total e dice non esistono ancora.

$sheet contiene attributi, abilità, Vita, Mana, campi, carte e la memoria della scheda (memory). Quando qualcosa è una lista, [0] prende il primo elemento, [1] il secondo e così via. Quando un valore non esiste, compare come null, che significa “vuoto”.

Per usare $("Step name"), copia lo Step name esattamente e non riusare quel nome in un altro passo. Il passo che leggi deve essere stato eseguito prima, sullo stesso percorso. Ask restituisce la risposta stessa. Choose restituisce l'elemento scelto, con informazioni come name, total e targets (i campi di quell'elemento).

Quando un valore può essere vuoto, coalesce(valore, 0) usa 0 al suo posto. Vengono sostituiti solo i valori vuoti: uno 0 o un testo vuoto restano come sono.

$("Tira dadi").total
$("Chiedi")
$("Scegli").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)

Come mettere un valore dentro un testo o un tiro

Nei campi numerici o di condizione, scrivi il calcolo direttamente. Nei campi di testo o di dadi, in modalità Expression, metti solo la parte calcolata tra {{ e }}. Per esempio: Totale: {{ @forca + 2 }} mostra Totale: 5 quando la Forza è 3.

Per tirare 1d20, usa il passo Roll dice: un'espressione da sola non tira i dadi. Le formule dei dadi possono usare le variabili della scheda; la guida al tiro dei dadi spiega opzioni come tenere il dado più alto e i dadi esplosivi.

Testo in modalità espressione:
Totale: {{ $("Roll dice").total }}

Dadi in modalità espressione:
1d20 + {{ @forca_mod }}

Condizione in modalità espressione:
@vida > 0

Calcoli già pronti (funzioni)

Una funzione è un calcolo già pronto che usi in una formula. max(@dano - 2, 0) toglie 2 al danno ma non scende mai sotto 0. clamp(@vida + 5, 0, @vida_max) aggiunge 5 alla Vita e tiene il risultato tra 0 e il massimo.

min prende il valore più basso e max il più alto. floor arrotonda per difetto, ceil per eccesso e round al più vicino.

Per le liste: sum somma, avg fa la media, len conta gli elementi, first e last prendono il primo e l'ultimo, e contains controlla se qualcosa è nella lista. Per il testo: upper e lower passano a maiuscolo o minuscolo.

Ci sono altre funzioni matematiche, come radice quadrata, potenza e trigonometria. Non ti servono per iniziare; la guida alle espressioni dentro l'editor le elenca tutte.

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