コンペンディウムの統合

2024年11月06日 11:06

シートの互換性を指定する

コンペンディウムとの互換性を指定するには、sheet.jsonファイルの "compendium "フィールドにコンペンディウムのショートネームを含めるだけです。

カスタムシートを使用している場合、ゲーム設定ページに、あなたのゲームに使用する大要を手動で選択できる設定があります。

シートのドラッグ＆ドロップ機能を有効にする

基本的な互換性に加えて、Roll20 に Compendium の情報をどのようにあなたのシートに含めるかを直接指示するオプションもあります。これにより、プレイヤーは大要から項目を直接シートにドラッグ・アンド・ドロップすることができ、Roll20はあなたが指定した値を記入します。そのためには、埋めたいセクションを囲むdivタグにcompendium-drop-targetクラスを追加する必要があります。繰り返しセクションの場合は、fieldsetタグの中に記述する。次に、accept="属性名 "属性を1つ以上のinput、select、textareaタグに追加します。以下は、第5版SRD CompendiumのFireballの項目と互換性のある簡単な例です。

<fieldset class="repeating_spells">
  <div class="compendium-drop-target">
    <input type="text"  name="attr_SpellName"  accept="名前"/入力タイプ="テキスト>
    <input type="text"  name="attr_SpellDamage"  accept="Damage"/>
    <select name="attr_SpellSchool"accept="学校"/ input type="text" name="attr_SpellDamage"accept="ダメージ">
      <オプション値="Abjuration">アジュレーション</オプション>
      <オプション値="Conjuration">コンジュレーション</オプション>
      <オプション値="占い">占い</オプション>
      <オプション値="魅惑">エンチャントメント</オプション>
      <オプション値="喚起">喚起</オプション>
      <オプション値="イリュージョン">イリュージョン</オプション>
      <オプション値="ネクロマンシー">ネクロマンシー</オプション>
      <オプション値="変成">変身</オプション>
    </選択>
    <input type="checkbox"  name="attr_SpellRitual"  value="Yes"  accept="儀式">
  </div>
</フィールドセット>

accept="の<Attribute Name> <Attribute Name>"は、コンペンディウム・エントリーの一番下のセクションのアトリビュート名と一致しなければならない。利用可能な属性のリストについては、各コンペンディウムを参照のこと。
inputタグやtextareaタグでは、大要の値が直接挿入される。
input[type=checkbox]タグとinput[type=radio]タグの場合、compendiumの値がタグのvalue属性と完全に一致すれば、ボックスがチェックされ、ラジオが選択されます。
selectタグの場合、value属性かoptionタグ内のテキストのどちらかで、コンペンディウムの値と一致するオプションが選択されます。
エントリーのプレーンテキストコンテンツ（"Attributes "ヘッダーの上にあるコンテンツ）を受け取りたい場合は、accept="Content "を使用することができる。
compendiumページからすべての属性をjson形式で受け取りたい場合は、accept="data "を使用します。

これらの値を変更するプロセスでは、ユーザー自身がデータを手入力した場合とまったく同じように、ローカルSheet WorkerとリモートAPIイベントがトリガーされることに注意してください。そのため、データの表示方法をよりコントロールしたい場合は、コンペンディウムからデータを受け取るための隠し入力を作成し、そのデータをシートワーカーを使ってさらに処理することもできる。

大要ボタン

コンペンディウムボタンは、アプリ内のコンペンディウムのエントリーをクリックするのと同じように、キャラクターシートから直接コンペンディウムのエントリーを開くために使用できます。これは、ルールや説明文にアクセスするための、より便利な方法として使用することができます。例えば、呪文について、大要ボタンを使用すると、その呪文の完全な説明文を簡単に見ることができます。

構文は、<button type="compendium" value="<entryname>">. 以下はその例である：

<button type="compendium"value="吟遊詩人"></ボタン>

これは有効な構文だが、大要には「吟遊詩人」というタイトルのクラスとモンスターの項目があるため、結果として表示されるウィンドウには、どちらかの項目に直接移動するのではなく、どちらかの項目が表示される。

<button type="compendium"value="クラス：吟遊詩人"></ボタン>

これは好ましい構文である。カテゴリーを指定することで、マッチするのは1つだけになる。

<button type="compendium"value="クラス:吟遊詩人#呪文"></ボタン>

の後に小見出しのタイトルを付けると、ウィンドウがそのセクションに直接開きます。この例では、Bardクラスのエントリーを開き、あらかじめSpellcastingのセクションにスクロールしておきます。その名前のセクションが見つからない場合、ウィンドウは一番上にスクロールして開きます。

大要からエントリーをドラッグすると、このボタン専用の属性であるuniqueName（カテゴリー名とエントリー名の両方を含む文字列）が含まれる。つまり、大要のドロップ・セクションのこのボタンの構文は次のようになる：

<button type="compendium"  name="attr_infoButton"  accept="uniqueName"></ボタン>

シートワーカーを使ってこの属性にサブセクションを追加することもできるので、もし大要からドロップされたアイテムがモンスターで、ボタンを直接「Actions」セクションに開きたい場合は、ボタンの値をuniqueName + "#Actions "に設定すればいい。