メインコンテンツへ移動

変数と式

ここは、数値をシートに合わせて変えたいときのための部分です。ほとんどの簡単なルールは、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 は、HPが0より大きいかを尋ねます。@forca >= 3 は、筋力が3以上かを尋ねます。> は「より大きい」、>= は「以上」、< は「より小さい」、<= は「以下」です。

== は2つの値が等しいか(等号を2つ)を尋ね、!= は違うかを尋ねます。and は両方の質問が「はい」でなければならないという意味です。or はどちらか1つで十分という意味です。not は答えを反対にします。かっこは算数と同じように、ひとまとまりにします。

Ifステップは道全体を選びます。計算の中で2つの値のどちらかを選びたいだけなら、if(質問, はいのときの値, いいえのときの値) を使います。文字列は1文字ずつ一致する必要があります。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 には、能力値、技能、HP、マナ、欄、カード、シートのメモリ(memory)が入っています。リストの場合、[0] で1つ目、[1] で2つ目、というように取り出します。値が存在しないときは null と表示されます。これは「空」という意味です。

$("Step name") を使うときは、Step nameを正確に写し、その名前をほかのステップで使い回さないでください。読み取るステップは、同じ道の上で先に動いている必要があります。Askは答えそのものを返します。Chooseは選ばれた項目を返し、name、total、targets(その項目の欄)などの情報を持っています。

値が空かもしれないときは、coalesce(値, 0) を使うと代わりに0が使われます。置き換わるのは空の値だけです。0や空白の文字列はそのままです。

$("Roll dice").total
$("Ask")
$("Choose").targets.misc
$sheet.skills[0].name
coalesce($sheet.memory.usos, 0)

文字列やロールの中に値を入れる方法

数値や条件の欄には、計算をそのまま書きます。文字列やダイスの欄では、Expressionモードで、計算する部分だけを {{ と }} の間に入れます。例:合計: {{ @forca + 2 }} は、筋力が3のとき「合計: 5」と表示します。

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) はHPに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, " + ")