Перейти к основному содержимому

Переменные и выражения

Эта часть нужна, когда число должно меняться вместе с листом. Для большинства простых правил хватает режима Fixed и визуального конструктора.

Что означает @forca?

Переменная — это короткое имя для значения из листа. @forca читает Силу; @forca + 2 берёт это значение и прибавляет 2. Если Сила 3, результат будет 5. Знак @ сообщает редактору, что это переменная.

Используйте имена, которые подсказывает редактор. Если в имени есть пробелы, заключите его в фигурные скобки: @{Força Bruta}. У модификаторов и максимумов обычно свои имена, например @forca_mod и @vida_max.

Несуществующее имя переменной считается равным 0. Это самая частая причина неверных результатов. Советы по записи: для дробей используйте точку (1.5), для умножения — * (@forca * 2), текст берите в кавычки ("fire").

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

Как записать вопрос с ответом «да» или «нет»

Условие — это вопрос. @vida > 0 спрашивает, больше ли Здоровье нуля. @forca >= 3 спрашивает, равна ли Сила 3 или больше. > — больше; >= — больше или равно; < — меньше; <= — меньше или равно.

== спрашивает, равны ли два значения (два знака равенства), а != — различаются ли они. and означает, что оба вопроса должны дать «да». or означает, что достаточно одного. not меняет ответ на противоположный. Скобки группируют части, как в арифметике.

Шаг If выбирает целый путь. Если нужно только выбрать одно из двух значений внутри расчёта, используйте if(вопрос, значение при «да», значение при «нет»). Текст должен совпадать буква в букву: Fight и fight — разные слова.

@forca >= 3 and @vida > 0
$event.attribute == "agilidade"
if(@nivel >= 5, 2, 1)
if(@vida <= 0, "Без сознания", "На ногах")

Для опытных: $event, $sheet и результат другого шага

Это нужно только в правилах, которые используют данные броска или результат предыдущего шага. $event читает то, что запустило правило (например, бросок). $sheet читает весь лист. $("Step name") читает результат шага, который уже выполнился.

В правиле броска $event предлагает formula, total, dice, skillName и attribute. Что именно доступно, зависит от триггера: до броска кубиков total и dice ещё не существуют.

В $sheet есть характеристики, навыки, Здоровье, Мана, поля, карточки и память листа (memory). Если что-то является списком, [0] берёт первый элемент, [1] — второй и так далее. Если значения нет, оно выглядит как null, то есть «пусто».

Чтобы использовать $("Step name"), скопируйте Step name точно и не давайте это имя другому шагу. Шаг, который вы читаете, должен выполниться раньше, на том же пути. Ask возвращает сам ответ. Choose возвращает выбранный элемент с такими данными, как name, total и targets (поля этого элемента).

Если значение может быть пустым, coalesce(значение, 0) подставит вместо него 0. Заменяются только пустые значения: 0 или пустой текст остаются как есть.

$("Бросить кости").total
$("Спросить")
$("Выбрать").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)

Как вставить значение в текст или бросок

В числовых полях и полях условий пишите расчёт напрямую. В текстовых полях и полях кубиков, в режиме Expression, помещайте между {{ и }} только вычисляемую часть. Например: Итого: {{ @forca + 2 }} показывает «Итого: 5», когда Сила равна 3.

Чтобы бросить 1d20, используйте шаг Roll dice: само по себе выражение кубики не бросает. В формулах кубиков можно использовать переменные листа; руководство по броскам объясняет такие варианты, как оставить наибольший кубик или взрывающиеся кубики.

Текст в режиме Expression:
Итого: {{ $("Roll dice").total }}

Кубики в режиме Expression:
1d20 + {{ @forca_mod }}

Условие в режиме Expression:
@vida > 0

Готовые расчёты (функции)

Функция — это готовый расчёт, который используется в формуле. max(@dano - 2, 0) вычитает 2 из урона, но никогда не опускается ниже 0. clamp(@vida + 5, 0, @vida_max) прибавляет 5 к Здоровью и держит результат между 0 и максимумом.

min выбирает наименьшее значение, а max — наибольшее. floor округляет вниз, ceil — вверх, а round — до ближайшего.

Для списков: sum складывает, avg считает среднее, len считает элементы, first и last берут первый и последний, а contains проверяет, есть ли что-то в списке. Для текста: upper и lower переводят в верхний или нижний регистр.

Есть и другие математические функции, например квадратный корень, степень и тригонометрия. Для начала они не нужны; руководство по выражениям внутри редактора перечисляет их все.

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