Que veut dire @forca ?
Une variable est un surnom pour une valeur de la fiche. @forca lit la Force ; @forca + 2 prend cette valeur et ajoute 2. Si la Force vaut 3, le résultat est 5. Le @ indique à l'éditeur que c'est une variable.
Utilisez les noms que l'éditeur propose. Pour les noms qui contiennent des espaces, mettez-les entre accolades : @{Força Bruta}. Les modificateurs et les maximums ont en général leur propre nom, comme @forca_mod et @vida_max.
Un nom de variable qui n'existe pas compte comme 0. C'est la cause la plus fréquente de résultats faux. Conseils d'écriture : utilisez un point pour les décimales (1.5), * pour multiplier (@forca * 2) et des guillemets autour du texte ("feu").
@nivel + 2
floor((@forca - 10) / 2)
clamp(@vida + 5, 0, @vida_max)
@{Força Bruta} * 2
Comment écrire une question à réponse oui ou non
Une condition est une question. @vida > 0 demande si la Vie est au-dessus de zéro. @forca >= 3 demande si la Force vaut 3 ou plus. > veut dire supérieur ; >= supérieur ou égal ; < inférieur ; <= inférieur ou égal.
== demande si deux valeurs sont égales (deux signes égal) et != demande si elles sont différentes. and veut dire que les deux questions doivent valoir oui. or veut dire qu'une seule suffit. not inverse la réponse. Les parenthèses regroupent, comme en calcul.
L'étape If choisit tout un chemin. Si vous voulez seulement choisir entre deux valeurs dans un calcul, utilisez if(question, valeur si oui, valeur si non). Le texte doit correspondre lettre pour lettre : Combat et combat sont différents.
@forca >= 3 and @vida > 0
$event.attribute == "agilidade"
if(@nivel >= 5, 2, 1)
if(@vida <= 0, "À terre", "Debout")
Avancé : $event, $sheet et le résultat d'une autre étape
Vous n'en avez besoin que dans les règles qui utilisent les données d'un jet ou le résultat d'une étape précédente. $event lit ce qui a lancé la règle (par exemple, le jet). $sheet lit toute la fiche. $("Step name") lit le résultat d'une étape qui s'est déjà exécutée.
Dans une règle de jet, $event propose formula, total, dice, skillName et attribute. Ce qui existe dépend du déclencheur : avant que les dés soient lancés, total et dice n'existent pas encore.
$sheet contient les attributs, les compétences, la Vie, le Mana, les champs, les cartes et la mémoire de la fiche (memory). Quand quelque chose est une liste, [0] prend le premier élément, [1] le deuxième, et ainsi de suite. Quand une valeur n'existe pas, elle apparaît comme null, ce qui veut dire « vide ».
Pour utiliser $("Step name"), recopiez exactement le Step name et ne réutilisez pas ce nom sur une autre étape. L'étape que vous lisez doit s'être exécutée avant, sur le même chemin. Ask renvoie directement la réponse. Choose renvoie l'élément choisi, avec des informations comme name, total et targets (les champs de cet élément).
Quand une valeur peut être vide, coalesce(valeur, 0) utilise 0 à sa place. Seules les valeurs vides sont remplacées : un 0 ou un texte vide restent tels quels.
$("Roll dice").total
$("Ask")
$("Choose").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)
Comment mettre une valeur dans un texte ou un jet
Dans les champs de nombre ou de condition, écrivez le calcul directement. Dans les champs de texte ou de dés, en mode Expression, mettez seulement la partie calculée entre {{ et }}. Par exemple : Total : {{ @forca + 2 }} affiche Total : 5 quand la Force vaut 3.
Pour lancer 1d20, utilisez l'étape Roll dice : une expression seule ne lance pas de dés. Les formules de dés peuvent utiliser des variables de la fiche ; le guide des lancers explique des options comme garder le meilleur dé ou les dés explosifs.
Texte en mode Expression :
Total : {{ $("Roll dice").total }}
Dés en mode Expression :
1d20 + {{ @forca_mod }}
Condition en mode Expression :
@vida > 0
Calculs tout faits (fonctions)
Une fonction est un calcul tout fait que vous utilisez dans une formule. max(@dano - 2, 0) retire 2 aux dégâts sans jamais descendre sous 0. clamp(@vida + 5, 0, @vida_max) ajoute 5 à la Vie et garde le résultat entre 0 et le maximum.
min prend la plus petite valeur et max la plus grande. floor arrondit vers le bas, ceil vers le haut et round au plus proche.
Pour les listes : sum additionne, avg fait la moyenne, len compte les éléments, first et last prennent le premier et le dernier, et contains vérifie si quelque chose est dans la liste. Pour le texte : upper et lower passent en majuscules ou en minuscules.
Il existe d'autres fonctions mathématiques, comme la racine carrée, la puissance et la trigonométrie. Vous n'en avez pas besoin pour commencer ; le guide des expressions dans l'éditeur les liste toutes.
max(@dano - 2, 0)
ceil(@nivel / 4)
round(2.5)
contains(["forca", "agilidade"], $event.attribute)
join($event.dice, " + ")