Pular para o conteúdo principal

Variáveis e expressões

Esta parte é para quando o número precisa mudar junto com a ficha. Para a maioria das regras simples, o modo Fixo e o construtor visual bastam.

O que significa @forca?

Uma variável é um apelido para um valor da ficha. @forca lê a Força; @forca + 2 pega esse valor e soma 2. Se a Força for 3, o resultado é 5. O @ avisa ao editor que aquilo é uma variável.

Use os nomes que o editor sugere. Para nomes com espaço, escreva entre chaves: @{Força Bruta}. Modificadores e máximos costumam ter nomes próprios, como @forca_mod e @vida_max.

Um nome de variável que não existe vale 0. Essa é a causa mais comum de resultado errado. Dicas de escrita: use ponto nos decimais (1.5), * para multiplicar (@forca * 2) e aspas em textos ("fogo").

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

Como escrever uma pergunta de sim ou não

Uma condição é uma pergunta. @vida > 0 pergunta se a Vida é maior que zero. @forca >= 3 pergunta se a Força é 3 ou mais. > é maior; >= é maior ou igual; < é menor; <= é menor ou igual.

== pergunta se dois valores são iguais (são dois sinais de igual) e != pergunta se são diferentes. and quer dizer “e”: as duas perguntas precisam dar sim. or quer dizer “ou”: basta uma. not inverte a resposta. Parênteses agrupam, como numa conta.

O passo Se escolhe um caminho inteiro. Se você só quer escolher entre dois valores dentro de uma conta, use if(pergunta, valor se sim, valor se não). Textos precisam ser iguais letra por letra: Luta e luta são diferentes.

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

Avançado: $event, $sheet e o resultado de outro passo

Você só precisa disto em regras que usam dados da rolagem ou o resultado de um passo anterior. $event lê o que fez a regra começar (por exemplo, a rolagem). $sheet lê a ficha inteira. $("Nome do passo") lê o resultado de um passo que já aconteceu.

Numa regra de rolagem, $event traz formula (a fórmula), total, dice (os dados), skillName (o nome da perícia) e attribute (o atributo). Esses nomes ficam em inglês. O que existe depende do gatilho: antes de os dados rolarem, total e dice ainda não existem.

$sheet reúne atributos, perícias, Vida, Mana, campos, cartas e a memória da ficha (memory). Quando algo é uma lista, [0] pega o primeiro item, [1] o segundo, e assim por diante. Quando um valor não existe, ele aparece como null, que quer dizer “vazio”.

Para usar $("Nome do passo"), copie o Nome do passo exatamente como está e não repita esse nome em outro passo. O passo lido precisa ter acontecido antes, no mesmo caminho. Perguntar entrega a própria resposta. Escolher entrega o item escolhido, com informações como name (nome), total e targets (os campos daquele item).

Quando um valor pode estar vazio, coalesce(valor, 0) usa 0 no lugar dele. Só o vazio é trocado: um 0 ou um texto em branco continuam como estão.

$("Rolar dados").total
$("Perguntar")
$("Escolher").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)

Como colocar um valor dentro de um texto ou de uma rolagem

Em campos de número ou de condição, escreva a conta direto. Em campos de texto ou de dados, no modo Expressão, coloque só a parte calculada entre {{ e }}. Por exemplo: Total: {{ @forca + 2 }} mostra Total: 5 se a Força for 3. Nas opções do passo Perguntar, {{ }} calcula valores nos dois modos. No modo Fixo, escreva uma opção por linha, sem aspas nem colchetes. No modo Expressão, escreva uma lista de textos entre aspas, como no exemplo abaixo: a lista é calculada primeiro e depois os trechos {{ }} de cada opção. Se @pm for 10, as opções mostram 1 dado - 10 PM e 2 dados - 20 PM. Opções que ficam vazias após o cálculo não aparecem.

Para rolar 1d20, use o passo Rolar dados: uma expressão sozinha não rola dados. Na fórmula dos dados você pode usar variáveis da ficha; o guia de rolagens explica opções como ficar com o maior dado e dados explosivos.

Texto em modo expressão:
Total: {{ $("Rolar dados").total }}

Dados em modo expressão:
1d20 + {{ @forca_mod }}

Opções de Perguntar no modo Fixo:
1 dado - {{ @pm }} PM
2 dados - {{ @pm * 2 }} PM

Opções de Perguntar no modo Expressão:
["1 dado - {{ @pm }} PM", "2 dados - {{ @pm * 2 }} PM"]

Condição em modo expressão:
@vida > 0

Continhas prontas (funções)

Uma função é uma conta pronta que você usa numa fórmula. max(@dano - 2, 0) tira 2 do dano, mas nunca deixa o resultado abaixo de 0. clamp(@vida + 5, 0, @vida_max) soma 5 à Vida e mantém o resultado entre 0 e o máximo.

min escolhe o menor valor e max, o maior. floor arredonda para baixo, ceil para cima e round para o mais próximo.

Para listas: sum soma, avg tira a média, len conta quantos itens há, first e last pegam o primeiro e o último, e contains confere se algo está na lista. Para textos: upper e lower passam para maiúsculas ou minúsculas.

Existem outras funções matemáticas, como raiz, potência e trigonometria. Você não precisa delas para começar; o guia de expressões dentro do editor lista todas.

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