Intégration du compendium

Désignation de la compatibilité de votre feuille

Pour indiquer la compatibilité avec un recueil, il suffit d'inclure le nom abrégé du recueil dans le champ "compendium" de votre fichiersheet.json

Si vous utilisez une feuille personnalisée, un paramètre de la page Paramètres du jeu vous permet de sélectionner manuellement un compendium à utiliser pour votre jeu.


Activation de la fonctionnalité "glisser-déposer" pour votre feuille

En plus de la compatibilité de base, vous avez la possibilité d'indiquer à Roll20 comment les informations du Compendium peuvent être incluses directement dans votre feuille. Cela permet aux joueurs de glisser-déposer une entrée du compendium directement dans votre feuille, et Roll20 remplit les valeurs que vous spécifiez. Pour ce faire, vous devez ajouter la classecompendium-drop-targetà la balisediventourant la section que vous souhaitez compléter. Pour les sections qui se répètent, placez-la à l'intérieur de la balisefieldset. Ensuite, ajoutez l'attributaccept="Attribute Name"à une ou plusieurs balisesinput, select, textarea. Voici un exemple simple qui serait compatible avec l'entréeFireballdu Compendium SRD de la 5e édition.

<fieldset class="repeating_spells">
  <div class="compendium-drop-target">
    <input type="text" name="attr_SpellName" accept="Name" />
    <input type="text" name="attr_SpellDamage" accept="Damage" />
    <select name="attr_SpellSchool accepter="School">
      <valeur de l'option="Abjuration">Abjuration</option>
      <valeur de l'option="Conjuration">Conjuration</option>
      <valeur de l'option="Divination">Divination</option>
      <valeur de l'option="Enchantement">Enchantement</option>
      <valeur de l'option="Evocation">Evocation</option>
      <valeur de l'option="Illusion">Illusion</option>
      <valeur de l'option="Nécromancie">Nécromancie</option>
      <valeur de l'option="Transmutation">Transmutation</option>
    </select>
    <type d'entrée="checkbox" name="attr_SpellRitual" value="Yes" accept="Ritual">
  </div>
</fieldset>

  • Le<Attribute Name>dansaccept="<Attribute Name>"doit correspondre au nom d'un attribut de la section inférieure de l'entrée du compendium. Consultez chaque Compendium pour obtenir la liste des attributs disponibles.
  • Pour les balisesinputettextarea, la valeur du Compendium sera directement insérée.
  • Pour les balisesinput[type=checkbox]etinput[type=radio], la case sera cochée/radio sélectionnée si la valeur du recueil correspond exactement à l'attribut value de la balise.
  • Pour les balisesselect, l'optionqui correspond à la valeur du Compendium dans l'attribut value OU dans le texte à l'intérieur de la balise option sera sélectionnée.
  • Vous pouvez utiliseraccept="Content"si vous souhaitez recevoir le contenu en clair de l'entrée (le contenu situé au-dessus de l'en-tête "Attributes").
  • Vous pouvez utiliseraccept="data"si vous souhaitez recevoir tous les attributs d'une page de recueil au format json.

Notez que le processus de modification de ces valeurs déclenchera des événements locaux (Sheet Worker) et distants (API) exactement comme si l'utilisateur avait lui-même saisi les données à la main. Vous pouvez donc également créer des entrées cachées pour accepter les données du Compendium, puis traiter ces données à l'aide de Sheet Workers si vous souhaitez mieux contrôler la manière dont les données sont présentées.


Boutons du compendium

Le bouton du compendium peut être utilisé pour ouvrir une entrée du compendium directement à partir d'une feuille de personnage, de la même manière que si vous cliquiez sur une entrée du compendium in-app. Il peut s'agir d'un moyen plus pratique d'accéder aux règles et aux descriptions. Par exemple, pour un sort, le bouton "Compendium" peut être utilisé pour afficher facilement la description complète de ce sort.

La syntaxe est la suivante :<button type="compendium" value="<entryname>">. Voici quelques exemples valables :

<type de bouton="compendium" valeur="Bard"></bouton>

Il s'agit d'une syntaxe valide, mais comme il existe à la fois une classe et un monstre dans le compendium intitulé "Barde", la fenêtre résultante vous présentera un choix d'entrées au lieu d'aller directement à l'une d'entre elles.

<type de bouton="compendium" valeur="Classes:Bard"></button>

C'est la syntaxe préférée. Le fait de spécifier la catégorie garantit qu'il n'y aura qu'une seule correspondance.

<type de bouton="compendium" valeur="Classes:Bard#Spellcasting"></button>

L'ajout d'un "#" suivi d'un titre de sous-titre entraîne l'ouverture de la fenêtre directement dans cette section. Cet exemple ouvrira l'entrée pour la classe Barde, en faisant défiler la section Lancer des sorts. Si aucune section portant ce nom n'est trouvée, la fenêtre s'ouvrira en défilant vers le haut.

Le fait de glisser une entrée depuis le recueil contient un attribut spécifique à ce bouton,uniqueName, une chaîne contenant à la fois le nom de la catégorie et celui de l'entrée, ce qui garantit qu'il n'y aura qu'une seule correspondance dans le recueil. Ainsi, la syntaxe de ce bouton dans une section de dépôt du recueil est la suivante :

<type de bouton="compendium" name="attr_infoButton" accept="uniqueName"></button>

Vous pouvez également ajouter une sous-section à cet attribut via sheetworker, donc si l'objet déposé du compendium était un monstre, et que vous voulez que le bouton s'ouvre directement à la section "Actions", vous pouvez définir la valeur du bouton àuniqueName + "#Actions".

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 11 sur 70