Saltar al contenido principal

Variables y expresiones

Esta parte es para cuando un número tiene que cambiar junto con la ficha. Para la mayoría de las reglas sencillas, basta con el modo Fixed y el constructor visual.

¿Qué significa @forca?

Una variable es un apodo para un valor de la ficha. @forca lee la Fuerza; @forca + 2 toma ese valor y le suma 2. Si la Fuerza es 3, el resultado es 5. La @ le dice al editor que es una variable.

Usa los nombres que sugiere el editor. Para nombres con espacios, ponlos entre llaves: @{Força Bruta}. Los modificadores y los máximos suelen tener su propio nombre, como @forca_mod y @vida_max.

Un nombre de variable que no existe cuenta como 0. Esta es la causa más común de resultados equivocados. Consejos para escribir: usa punto para los decimales (1.5), * para multiplicar (@forca * 2) y comillas alrededor del texto ("fuego").

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

Cómo escribir una pregunta de sí o no

Una condición es una pregunta. @vida > 0 pregunta si la Vida es mayor que cero. @forca >= 3 pregunta si la Fuerza es 3 o más. > es mayor que; >= es mayor o igual que; < es menor que; <= es menor o igual que.

== pregunta si dos valores son iguales (dos signos de igual) y != pregunta si son distintos. and significa que las dos preguntas tienen que ser sí. or significa que basta con una. not invierte la respuesta. Los paréntesis agrupan, como en aritmética.

El paso If elige un camino entero. Si solo quieres elegir entre dos valores dentro de un cálculo, usa if(pregunta, valor si sí, valor si no). El texto tiene que coincidir letra por letra: Lucha y lucha son distintos.

@forca >= 3 and @vida > 0
$event.attribute == "agilidade"
if(@nivel >= 5, 2, 1)
if(@vida <= 0, "Caído", "En pie")

Avanzado: $event, $sheet y el resultado de otro paso

Solo necesitas esto en reglas que usan datos de la tirada o el resultado de un paso anterior. $event lee lo que inició la regla (por ejemplo, la tirada). $sheet lee la ficha entera. $("Step name") lee el resultado de un paso que ya se ejecutó.

En una regla de tirada, $event ofrece formula, total, dice, skillName y attribute. Lo que existe depende del disparador: antes de tirar los dados, total y dice todavía no existen.

$sheet contiene atributos, habilidades, Vida, Maná, campos, cartas y la memoria de la ficha (memory). Cuando algo es una lista, [0] toma el primer elemento, [1] el segundo, y así sucesivamente. Cuando un valor no existe, aparece como null, que significa “vacío”.

Para usar $("Step name"), copia el Step name exactamente y no repitas ese nombre en otro paso. El paso que lees tiene que haberse ejecutado antes, en el mismo camino. Ask devuelve la respuesta tal cual. Choose devuelve el elemento elegido, con información como name, total y targets (los campos de ese elemento).

Cuando un valor puede estar vacío, coalesce(valor, 0) usa 0 en su lugar. Solo se reemplazan los valores vacíos: un 0 o un texto en blanco se quedan como están.

$("Tirar dados").total
$("Preguntar")
$("Elegir").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)

Cómo poner un valor dentro de un texto o una tirada

En campos de número o de condición, escribe el cálculo directamente. En campos de texto o de dados, en modo Expression, pon solo la parte calculada entre {{ y }}. Por ejemplo: Total: {{ @forca + 2 }} muestra Total: 5 cuando la Fuerza es 3.

Para tirar 1d20, usa el paso Roll dice: una expresión sola no tira dados. Las fórmulas de dados pueden usar variables de la ficha; la guía de tiradas explica opciones como quedarte con el dado más alto o los dados que explotan.

Texto en modo expresión:
Total: {{ $("Roll dice").total }}

Dados en modo expresión:
1d20 + {{ @forca_mod }}

Condición en modo expresión:
@vida > 0

Cálculos listos para usar (funciones)

Una función es un cálculo ya hecho que usas en una fórmula. max(@dano - 2, 0) resta 2 al daño, pero nunca baja de 0. clamp(@vida + 5, 0, @vida_max) suma 5 a la Vida y mantiene el resultado entre 0 y el máximo.

min toma el valor más bajo y max el más alto. floor redondea hacia abajo, ceil hacia arriba y round al más cercano.

Para listas: sum suma, avg saca el promedio, len cuenta los elementos, first y last toman el primero y el último, y contains comprueba si algo está en la lista. Para textos: upper y lower pasan a mayúsculas o minúsculas.

Hay otras funciones matemáticas, como raíz cuadrada, potencia y trigonometría. No las necesitas para empezar; la guía de expresiones dentro del editor las lista todas.

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