1. Roll20 ヘルプセンター
  2. マクロ
  3. 一般

マクロ

マクロは、頻繁に繰り返されるコマンドのカスタムショートカットです。 例えば、キャラクターが戦いの雄叫びを上げ、よく使われる攻撃を自動的に行うマクロを作成できます。 ゲームプレイ中にタイピングを繰り返す代わりに、1つの短いコマンドを使うことができます。

素早くアクセスするために、これらのコマンドをクイックバーや トークンアクションに追加することができます。

マクロの作成と編集

サイドバーの小さな点線リスト画像の下にある"コレクション"タブを開く。 マクロを入力するには、まずコマンドの呼び名を入力する。 例"test"。 そして右側に、コマンドを入れる。 これはタイプされたテキストであったり、ロールであったり、エモートであったりする。 この情報の後に "Enter "を押してコマンドを保存する。

マクロを呼び出すには、#とコマンド（例：#test）を入力し、Enterを押す。

オートコンプリート

一部のテキストエリアでは、マクロ呼び出しの自動補完をサポートしています（"#"を使用）、 属性呼び出し(および 能力呼び出し(を使用）。

マクロ」（「マクロの編集」ウィンドウ）と「アビリティー」（「アビリティー」タブ）の両方の「アクション」テキストエリア。 属性 & アビリティタブ)は、マクロと属性呼び出しのオートコンプリートに対応しています。 テキストチャット テキストチャットは、マクロおよびアビリティ呼び出しの自動補完をサポートしています。

オートコンプリートリストを表示するには、記号（#、@、%）の後に文字または数字を続けて入力します。 オートコンプリート リストには、そのシーケンスを含む名前のマクロ、属性、またはアビリティが表示されます。

オートコンプリートリストに表示されるのは、[コレクション]タブで確認できるマクロのみです。 同様に、属性（またはアビリティ）のうち キャラクターのみがオートコンプリートリストに表示されます。

チップ

キーボードの上下方向キーとEnterキーを使って、オートコンプリートリストの項目を移動したり選択したりできます。

例えば、「Intelligence（知性）」というアトリビュートを持つキャラクターをコントロールする権限を持っている場合、Edit Macroウィンドウの「Action」テキストエリアに「@int」と入力することができます。 これにより、その属性を含むオートコンプリートリストが表示されます。

チップ

キャラクターシートでロールをクリックし、チャットウィンドウで上矢印を押すと、使用されたコードが表示されます。 これにより、複数のロールを便利なボタンにまとめることができる。

複数のコマンド

マクロシステムの強みのひとつは、ひとつのコマンドで複数のアクションを実行できることだ。 これを行うには、各項目をそれぞれの行に書くだけで、マクロを実行するときにアクションが順番に実行される。

例

エモートと、攻撃とダメージのロールを含むマクロを作りたい場合、マクロは次のようになる：

マクロ名:
dagger

マクロボディ：

/
/roll 1d20+10 vs AC
/roll 1d4+9 ダメージを与える。
そして、"#dagger "と入力するだけで、スクリプト全体が実行され、次のようになります：

マクロは、例えば、コマンドラインと非コマンドラインを混在させることもできる：

#lof
/meはモラディンの力を呼び起こす！
私はあなたを打ちのめす！

/ロール 1d20+4 vs 反射 /ロール 1d8+4 ダメージ

 

これはまずエモートし、それからチャットに"I smite you!"と送信し、その後に2つのロールを行う。

マクロの入れ子

マクロは互いに入れ子にすることができるので、マクロを組み合わせたり、1つのアクションで複数のマクロを呼び出したりすることができる。 マクロをネストするには、呼び出したいマクロの名前を、マクロの中のその行に含めるだけでよい。

例

この例では、3つのマクロを用意する：#Damage #attackと#both

マクロ #ダメージ = /roll 1d4+11
マクロ #攻撃 = /roll 1d20+9
マクロ #両方 =
#攻撃
#ダメージ

ダイスロールクエリーの入れ子

ロールクエリでマクロをネストする場合は、マクロ名が正しく認識されるように、マクロ名の後にスペースがあることを確認してください。

?{どのマクロ?|攻撃、#使用剣｜防御、#使用盾 }?

トラブルシューティング

そのため 操作の順序ダイスロールクエリ内のマクロ呼び出しは、クエリ全体が実行される前に完全に展開されます。 つまり、ダイスロールクエリに入れ子になっているマクロに、クエリの構文と矛盾する「問題のある文字」（"}" "," や "|" など）が含まれていると、そのマクロによってクエリ全体が壊れてしまう可能性があるということです。 その理由は、クエリーが参照されたマクロ内の問題のある文字を、元の構文の一部として扱うからである。

この場合、（呼び出されたマクロ自体で）問題のある文字を削除するか、HTMLエンティティに置き換える必要があるかもしれない。

HTML エンティティの置換を含むマクロは、ロールクエリ以外では機能しなくなりました。 として保存する必要がある。 アビリティ.

コレクションマクロを再度開くと、HTMLエンティティが元に戻ります。 この動作は アビリティ.

ネスティング能力

アビリティとは、特定のキャラクターに固有のマクロの別名で、ジャーナル・タブにあるキャラクター・シートに作成されます。 マクロのように、アビリティは互いに入れ子にすることができ、アビリティを連鎖させたり、1つのアクションで複数のアビリティを呼び出したりすることができる。

アビリティのネストはマクロのネストと似ているが、少しひねりがある。 マクロのように、呼び出したいアビリティの名前を、呼び出したアビリティの行に含めるだけです。 しかしそれに加えて、数字記号（#）をパーセント記号（%）に変え、縦パイプ（|）で区切って能力名の前に文字名を入れなければならない。

縦パイプキーは、ほとんどのキーボードでバックスラッシュキー（ \）の上にある。 このキーは通常、USキーボードではエンターキーの近くにあり、ヨーロッパのキーボードでは数字列の中にある。

注

現在、能力参照記号（%）は、属性参照記号（@）やマクロ参照記号（#）のようにオートコンプリートされません。 コマンドをすべて手入力する必要がある。

例

この例では、%damage %attackと%both の3つのアビリティと、Bugbearという名前のキャラクターを用意します。

能力%damage = /roll 1d4+11
能力%atack = /roll 1d20+9
能力%both =
%{Bugbear|attack}
%{Bugbear|damage}

その他の例

以下はシステム別の例である：

DnD 5e/Nextマクロ

パスファインダーのマクロ

能力コマンドボタン

アビリティ・コマンド・ボタンを使って、以下のアビリティを呼び出すことができる。 アビリティ(またはシートボタンロール)を呼び出すために使用できます。 これらは以下と密接に関係している。 MOD（API）コマンドボタン. 

構文は以下の通り：

[ラベル](~<キーワード>|<能力名>)

と同様に 属性および 能力の呼び出しと同様に、キーワードは selected、target、またはcharacter_nameから選択する。 character_idをキーワードとして使うこともできる。 

アビリティ・コマンド・ボタンが、キャラクター・ウィンドウのタブのどこかに保存されている場合。 キャラクターウィンドウキーワードを省略することができます：

[ラベル](~<能力名>)

の例を続ける。 アビリティの例を続けると、「殺し屋ボブ」は[Swing Axe!!!](～巨大な斧)を他のアビリティに挿入して、よりアクセスしやすく敵を切り刻むことができるようにするかもしれない。

属性マクロ

属性マクロは、上記の例を組み合わせたものである。 キャラクタに割り当てられたアトリビュートを変数モディファイアとして利用することで、キャラクタに基づいた複雑なマクロを作成することができます。 マクロの変数はキャラクタ属性にリンクされているため、キャラクタエディタで行われた変更は自動的に値を更新します。

選択されたトークンをマクロで使用する

selectedキーワードは、ロール／マクロの実行時に、画面上で現在選択されている要素から情報を引き出すことを可能にする。 例えば、ロール中に選択されたトークンからバー1の値を引き出したい場合は、次のように書くことができる：

/ロール 1d20 + @{selected|bar1}

bar1"、"bar2"、または "bar3 "を使うことができる。 さらに、そのトークンにリンクされているキャラクターから属性を引き出すこともできます：

/ロール 1d20 + @{selected|Intelligence}

token_name "変数を使って、現在選択されているトークンの名前を引き出すことができる：

/{selected|token_name} 銃を撃つ！

選択したトークンにキャラクター・ジャーナルがリンクされている場合、"character_name "変数を使用する代わりに、キャラクター・ジャーナルからNameを引き出すことができます：

/{selected|character_name} シールドでブロックする！

アビリティ名を変数として使用することで、リンク先のキャラクター・ジャーナルからアビリティを発動させることができる：

>{selected|Attack}

最後に、変数に3つ目の引数を導入し、バーや属性の「最大値」を引き出せるようにしました：

/roll 1d20 + @{Guard|Intelligence|max}
/roll 1d20 + @{selected|bar2|max}

キャラクター、アトリビュート、アビリティを含むすべての名前は、大文字と小文字が区別されません。 つまり、"GUARD "と "guard "は、どちらも "Guard "というキャラクターにマッチする。

注

キャラクターの属性の完全なリストを見つけるには、そのキャラクターのシートに入り、タブ「属性 & アビリティ」をクリックします。 マクロで使用されるft hの属性は、"+ Add "をクリックすることで簡単に追加することができます。

属性とキャラクターシート

キャラクター・シートには、カスタム・マクロで参照したい多数の属性があります。 自動計算式属性（Auto-Calc Formula Attribute）について一つ注意してほしいことがある。文字シートはしばしば、他の属性を含む数式に基づいて計算された属性を持ちます。 その属性を参照すると、値の代わりに数式が表示されます。

{selected|character_name} は残り@{selected|action_points} ポイント。
ロルフの残り得点は((ceil(((13+0)+(14+0))/12)+0)+0。

これを回避するには、属性参照をインライン・ロールで囲む必要がある：

{selected|character_name} には [[@{selected|action_points}]] ポイントが残っている。
ロルフは残り3点。

マクロでターゲット・トークンを使用する

selected "キーワードを使用して選択されたトークンから情報を取得するのと同様に、"target "キーワードを使用すると、ターゲット・トークンの変数や能力にアクセスできます。 このコマンドは、プレイヤーが通常選択できないトークンを選択できるようにするもので、敵とのローリングに有効である。 例えば、"知能 "属性の対象に対して1d20を1回振るように指示した場合、出目は以下のようになる：

/ロール 1d20 - @{target|intelligence}

これにより、プレイヤーはどのトークンに対してローリングするのかを選択するプロンプト画面が表示される：

ターゲット選択.png

ターゲット・キーワードは、前述のセレクテッド・キーワードと同様に使用されるが、主に2つの違いがある。 次に、属性の "max "部分を参照する構文が若干異なります。 完全な構文の詳細については、以下の高度な使用法のサブセクションを参照してください。

ターゲット属性コールの高度な使用法

ターゲット変数の完全な構文は以下の通り：

@{target|<target_name>|<attribute_name>|<optional_flags>}.

(target_name'は好きなものを指定でき、スペースを含むことができることに注意)。

だから、マクロに複数のターゲットを入れたい場合は、そうすればいい：

{target|Target1|HP} vs{target|Target2|AC}

また、ある属性の最大値を使いたい場合：

{target|Target1|HP|max}

属性の "max "を使いたい場合は、上記のように "target1 "と書いたとしても、属性名を指定しなければならないことに注意。

さらに、複数の属性クエリで同じtarget_nameを使用する場合、プロンプトが表示されるのは一度だけで、同じトークンがすべての属性クエリに使用されます。 これは、複数行のマクロやコマンドがある場合にも適用される：

/{target|foe|character_name}！
**命中**する：[1d20+3]] vs @{target|foe|npc_AC} AC

繰り返し属性の参照

行インデックス

リピーティング行の属性は、RowIndexで参照できます。 属性の RowIndexは0から始まる（indexは先頭からのオフセットを意味する）ので、最初の行は$0、2番目は$1、3番目は$2などを使用する。

Itemsという名前のリピーティング・セクションでは、次の構文で2番目の項目のItemBonus属性にアクセスできます：

{selected|repeating_items_$1_itembonus}

注： 

RowIDによる

RowIDを使用して属性を参照することもできます。 RowIDを使用する利点は、（行の削除や並べ替えによる）順序の変更に影響されないことである。 RowIDを取得するには（キャラクターシートの作者が何らかの方法で提供していない場合）、シートのソースを参照する必要があります。 data-reprowidというプロパティを持つタグを見つけるまで、HTMLの上の方をたどってください。 このプロパティの値はRowID である：

<div class="repitem" data-reprowid="-KC0zCLum1Rq3V5wssyE">

RowIDが RowIndexの代わりに使われる：

{selected|repeating_items_-KC0zCLum1Rq3V5wssyE_itembonus}

ダイスロールオプション

ダイスロール・オプションとは、ダイスロールの結果に対して実行される特別なアクションを示すために、ダイスロールの中で使用されるフラグである。

ローリング・フォー・イニシアティブ

ロールの結果を直接ターン・トラッカーに送信するには、トークンまたはイニシアチブを選択し、以下のロール・オプションをマクロに含めます：

/ロール 1d20 + 5 &{tracker}

Roll20の「追跡」ダイス・オプションは、ダイスの結果を表示し、その結果をターン・トラッカーの値として使用します。 選択されたトークンがターンオーダーにない場合、新しいトークンが追加される。 すでにターンがある場合は、新しい値で更新される。

さらに、以下のフラグを使用することで、選択したトークンの現在のターン値から、ダイスの結果を加算したり、ダイスの結果を減算したりすることができる：

/roll 1d20 + 5 &{tracker:+}
/roll 1d20 + 5 &{tracker:-}

シャドウランのように、毎ターン後に現在のイニシアチブから10を引くようなゲームでは、次のようなグローバルマクロが使える：

/me @{selected|token_name} 彼らのターンを終了する。 [[10 &{tracker:-}]]

trackerフラグは通常のロールでもインラインロールでも機能することに注意。

これらの値は、属性と同じように構文を使って参照することもできる：{tracker|Item Name}

エラーメッセージの抑制

noerror」ロールオプションは、ロール中のエラー（変数が見つからないエラーなど）を抑制する。

/ロール 1d20 + @{selected|nonexistent_attribute} &{noerror}

マクロで変数を使う

実行時に指定するマクロに変数を含める最も簡単な方法は、ロールクエリを使用することです。 例えば、ロールに可変修正を加えたい場合、次のようなマクロを作ることができる：

/ロール 2d20 + ?{Modifier|0}

マクロが実行されると、含める修飾子を尋ねるプロンプトが表示される。 修飾子が指定されていない場合、クエリの"|0 "の部分は、デフォルト値として0を使用するように指示する。

ロール・クエリーの詳細については、「ダイス・リファレンス」を参照してください。

チャットで変数を指定する

マクロロールで変数修飾子を使いたい場合は、マクロコマンドの最後に修飾子をつけ、マクロを呼び出すときに指定するだけです。

例えばもし1d20+x（xは私の変数値）のマクロが必要なら、次のようなマクロを作ることができる：

#d20 /ロール 1d20+
マクロを実行するときは、こうタイプする：
#d204
このマクロは、/roll 1d20+4 という結果を生成する。

ロールクエリーのドロップダウンプロンプト

自由形式のテキストフィールドだけでなく、プレーヤーに提示できるオプションのリストを指定できます。

構文はこうだ：

?{Name of Query|Option1|Option2|Option3|Option4|Option5}

また、次のようにラベル以外の結果を別の値で指定することもできる：

?{Name of Query|Label 1, value1|Label 2, value2}

例

スペシャルアタック：

...+ [[ ?{スニークアタック?］+ パワー・アタック?

D&D 5e 攻撃ロール：

[[ ?{攻撃タイプ|標準, 1d20| アドバンテージ, 2d20kh1| デメリット, 2d20kl1} ]]。

呪文を治す：

?{Spell|
   Cure Light Wounds, **Cure Light Wounds** 対象は[[1d8+5]]のHPを回復する。HPを回復する。 | 
   Cure Moderate Wounds, **Cure Moderate Wounds** 対象は[[2d8+8]]のHPを回復する。HPを回復する。 | 
   Cure Serious Wounds, **Cure Serious Wounds** 対象は[[3d8+8]]のHPを回復する。HPを回復する。
}
 

 

例（ロールクエリーのネスト）

?{Name of Query|
   Label 1, ?{value1|
      Label 1A, value1A |
      Label 1B, value1B 
   }.|
   
   ラベル2, ?{value2|value2} 
}

HTMLエンティティを "積み重ねる "ことで、さらなるレベルの入れ子にすることができる：

キャラクター 交換
& &amp;

例

?{Name of Query|
   Label 1, ?{value1|
      Label 1A, ?{value1A&#124;
         Label 1Ai&#44; value1Ai &#124;
         Label 1Aii&#44; value1Aii
      &#125; |
      
      Label 1B, ?{value1B&#124;
         Label 1Bi&#44; value1Bi &#124;
         Label 1Bii&#44; value1Bii
      &#125;
   }.|

   ラベル2, ?{value2|value2} 
}

マクロバー

画面下のバーに表示されるマクロのクイックアクセスボタンを作成できます。 まず、いつものようにマクロを作成する。 マクロクイックバーを有効にするには、設定メニューの「マクロクイックバーを表示する」をオフにします。

クイックバーを表示.png

マクロをバーに追加するには、マクロ名の横にある "In bar "オプションをチェックするだけです。 マクロクイックバーをオンにするのを忘れた場合、マクロをオンにするとクイックバーが自動的に表示されます。

マクロインバー.png


クイックバーと選択したマクロは、画面下部のキャラクターポートレートの下に表示されます。 ボタンを並べ替えるには、ボタンにカーソルを合わせ、その右側に表示されるハンドルを使ってドラッグする。 ハンドルをクリックするとボタンが再編成され、ドラッグするとボタンが削除されます。

マクロバー.png

Shift+マクロクイックバーのマクロをクリックすると、そのマクロのエディターが開きます。

マクロメニュー

プレイヤーやGMは、マクロクイックバーの マクロボタンを右クリックして設定メニューを表示することができます。

マクロ右クリックメニュー.png

名前変更

Renameエントリを選択すると、マクロに表示する新しい名前を入力するダイアログが表示されます。 これは、キャラクターシートからボタンをドラッグして作成したマクロに特に便利です。

カラー

カラー・エントリーを選択し、カラー・ピッカーを表示します。 これにより、マクロボタンの背景色を変更し、異なるボタンを視覚的に選びやすくすることができます。 ボタンのテキストの色は、選択した背景色とのコントラストを維持するために変更されます。

ロール式テーブル

マクロではローラブルテーブルを使用することができます。 プレイヤーがマクロでそれらを使用できるようにするには、GMがそれらを作成し、プレイヤーに見えるようにしなければなりません。

ダイスロールテンプレートの使用

キャラクター・シートを使用する場合、ダイス・ロール・テンプレートを使用し、ロール・ボタンをクリックするか、マクロやアビリティでシート・ロールを呼び出します。 シートの作者があなたのためにあらかじめ設定してくれているので、あなたが余計な操作をする必要はありません。

独自のカスタムマクロでロールテンプレートを使用したり、独自のカスタムテンプレートを作成することに興味がある場合は、さらに読み進めてください。

ロール・テンプレートを使うのは簡単だ。 チャットメッセージにロールテンプレートを使用していることを示すフラグを入れ、必要なデータを入力してください。 ここでは、システムやキャラクターシートに関係なく、すべてのゲームで利用可能なデフォルトのテンプレートを使用した例を示します：

&{template:default} {name=テスト攻撃}}{{attack=[[1d20]]}}攻撃。{ダメージ=[[2d6]]}}}。

&{template:<template_name>} は、指定された名前で使用するロールテンプレートを指定する。 そして、テンプレートのすべてのデータを{{<propertyname>= <value>}}の形式で提供するだけです。 使用すべき "propertyname "はテンプレートに依存します--キャラクターシートのドキュメントを読めば、何が使用可能かわかるはずです。 "Value "は、マクロやアビリティなどを含め、テキストでもインラインロールでもよい。 マクロやアビリティを使う場合は、"/roll "コマンドではなく、インライン・ロールでなければならないことに注意してください。

以下は"%{Character|attack}" 能力を使った例である：

&{template:default} {{name=能力でテスト}}。{{attack= %{Character_Name|attack} }}{{damage= #ダメージマクロ }}

 

ロール・テンプレートはいつ使用できますか？

ロールテンプレートは、一般的なメッセージ（"/desc "や"/emote "のようなコマンドなし）やささやき声で使うことができます。 代わりに、ロール・テンプレートはインライン・ロールで使用するものです。 インライン・ロールを使用する限り、ロール・テンプレートをマクロやキャラクター・アビリティで使用することができます。

 
この記事は役に立ちましたか？
487人中376人がこの記事が役に立ったと言っています