Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Macros (Français)"

From Roll20 Wiki

Jump to: navigation, search
(Created page with "'''Macros''' are user-defined shortcuts to commands you regularly want to repeat. For example, you can create a macro that shouts a battlecry then performs an attack that you ...")
 
(Jet d'initiative)
 
(11 intermediate revisions by 8 users not shown)
Line 1: Line 1:
'''Macros''' are user-defined shortcuts to commands you regularly want to repeat. For example, you can create a macro that shouts a battlecry then performs an attack that you frequently use. Instead of needing to type all of the commands over and over again as you play, you can just type one short command instead.
+
Les '''macros''' sont des raccourcis créés par l'utilisateur pour les commandes que vous utilisez régulièrement. Vous pouvez par exemple créer une macro qui fait pousser un cri de guerre puis lance une attaque que vous utilisez souvent. Au lieu d'avoir besoin de taper et retaper les commandes fréquentes, il vous suffit de créer une macro et de la taper une seule fois.
  
== Creating and Editing Macros ==
+
== Créer et modifier des macros ==
  
Go to the My Settings tab (housed under the small gear image) in the Sidebar. To enter a macro, first type what you want to call the command. Example: "''test''". Then to the right, put in the command. This could be typed text, a roll, or emote. Press "Enter" after this information to save the command.
+
Allez dans l'onglet '''Collection''' (En cliquant sur l'icône avec 3 points et 3 traits) dans la barre latérale. Pour créer une macro, cliquez tout d'abord sur le bouton '''Ajouter''' (Add) de la section '''Macros'''. Entrez ensuite le nom que vous souhaitez donner à la macro (par exemple : '''test'''). Entrez ensuite la commande que doit effectuer cette macro : cela peut être du texte, un jet de dés ou une action. Appuyez ensuite sur le bouton '''Sauvegarder''' (Save changes)pour enregistrer la macro.
  
To use the macro, type ''#'' and the command (e.g. ''#test'') and press enter. There is also a tab auto-complete function for macros.
+
Pour utiliser la macro, entrez ''#'' puis le nom de la macro (par exemple : ''#test'') puis appuyez sur entrer. Il existe une fonction d'auto-complétion pour les macros.
  
== Multiple commands ==
+
== Commandes multiples ==
  
One of the strengths of the macro system is its ability to execute multiple actions with a single command. To do this, simply put each item on its own line, and they will be executed in order when you run the macro.
+
L'une des forces des macros est leur capacité à exécuter plusieurs actions à l'aide d'une seule commande. Pour ce faire, séparez simplement les différentes commandes par un retour à la ligne, elles seront alors exécutées dans l'ordre lorsque vous utiliserez la macro.
  
=== Example ===
+
=== Exemple ===
  
If I want to create a macro that will include an emote, plus my attack and damage rolls it would look like this:
+
Si vous voulez créer une macro qui inscrive une action puis lance un jet d'attaque et de dommages, votre macro pourrait ressembler à ceci :
  
Macro Name: <br> <code>dagger</code><br><br> Macro Body: <br> <code>/me rams his dagger home</code><br> <code>/roll 1d20+10 vs AC</code><br> <code>/roll 1d4+9 Damage</code><br>
+
'''Nom de la macro :''' <code>Coup-de-dague</code>
  
Then, simply by typing <code>#dagger</code> it would run the entire script and look like this:
+
'''Corps de la macro :'''
 +
 
 +
<code>/me enfonce sa dague.<br>
 +
/roll 1d20+10 Test d'attaque<br>
 +
/roll 1d4+9 Dommages</code>
 +
 
 +
Tapez ensuite simplement <code>#Coup-de-dague</code> pour exécuter ces trois actions d'un coup.
 +
 
 +
Cela ressemblera à ceci :
  
 
[[File:AttackMacro.JPG]]
 
[[File:AttackMacro.JPG]]
  
Macros can also include a mix of command and non-command lines, for example:
+
Les macros peuvent également inclure des textes qui ne sont pas des commandes, par exemple :
  
<code>#lof</code><br> <code>/me calls upon the power of Moradin!</code><br> <code>I smite you!</code><br> <code>/roll 1d20+4 vs reflex</code><br> <code>/roll 1d8+4 damage</code>
+
<code>/me en appelle au pouvoir de Moradin !
 +
Je te châtie !
 +
/roll 1d20+4 Test d'adresse
 +
/roll 1d8+4 Dommages</code>
  
This would first emote, then send &quot;<i>I smite you!</i>&quot; to the chat, and then make the two rolls afterwards.
+
Cela inscrira tout d'abord une action, puis le dialogue "''Je te châtie !''" et lancera enfin deux jets de dés.
  
== Nesting Macros ==
+
== Macros imbriquées ==
  
Macros can be nested inside each other, which gives the ability to combine macros, and call multiple macros with a single action. To nest a macro, simply include the name of the macro you wish to call on its own line inside your macro.
+
Les macros peuvent s'imbriquer les unes dans les autres, ce qui donne la possibilité de combiner des macros en appelant plusieurs macros d'un seul coup. Pour imbriquer des macros, entrez simplement le nom de la macro que vous souhaitez appeler dans le corps de la nouvelle macro.
  
=== Example ===
+
=== Exemple ===
  
In this example, we'll have three macros: <code>#damage</code> <code>#attack</code> and <code>#both</code>
+
Dans cet exemple, nous avons trois macros : <code>#attaque</code>, <code>#dommages</code> et <code>#tout</code>.
  
Macro <code>#damage</code> = <code>/roll 1d4+11</code><br> Macro <code>#attack</code> = <code>/roll 1d20+9</code><br> Macro <code>#both</code> = <br> <code>#attack</code><br> <code>#damage</code>
+
'''Macro <code>#attaque </code>''' : <code>/roll 1d20+9</code>
  
== Nesting Abilities ==
+
'''Macro <code>#dommages </code>''' : <code>/roll 1d4+11</code>
  
An ability is another name for a macro which is specific to a certain character and is created in a character sheet found on the journal tab. Like macros, abilities can be nested inside each other, which gives the ability to chain abilities together, and call multiple abilities with a single action.
+
'''Macro <code>#tout </code>''' :
  
Nesting an ability is similar to nesting a macro but with a slight twist. Like a macro, simply include the name of the ability you wish to call on its own line inside your calling ability. But in addition you have to change the number symbol (#) into a percent symbol (%) and then include the name of the character in front of the ability name using a vertical pipe (|) to separate them.
+
<code>#attaque
  
The vertical pipe key can be found above the backslash key (\) on most keyboards. This key will usually be near the enter key. To type a vertical pipe once you've found the key hold shift as if you were to uppercase a letter and then press the it.
+
&#35;dommages</code>
  
<big>'''Note:'''</big>
+
== Imbriquer des compétences ==
Currently the ability reference symbol (%) does not auto complete at this time like the attribute reference symbol (@) or macro reference symbol (#) do. You must type the entire thing yourself.
+
  
=== Example ===
+
Une compétence est un autre nom pour les macros spécifiques à certains personnages et qui est créée dans la feuille de personnage située dans l'onglet journal. Tout comme les macros, les compétences peuvent s'imbriquer les unes dans les autres, ce qui donne la possibilité de les enchaîner et d'appeler plusieurs compétences d'un seul coup.
  
In this example, we'll have three abilities: <code>%damage</code> <code>%attack</code> and <code>%both</code> and our character who will be named <code>Bugbear</code>
+
Pour utiliser la compétence, entrez ''%'' puis insérez entre accolades le nom du personnage puis le nom de la compétence séparés par une barre verticale (|, faîtes '''Alt Gr + -"''' pour l'obtenir). Il existe un système d'auto-complétion pour les compétences utilisable uniquement depuis le chat.
  
Ability <code>%damage</code> = <code>/roll 1d4+11</code><br> Ability <code>%attack</code> = <code>/roll 1d20+9</code><br> Ability <code>%both</code> = <br> <code>%{Bugbear|attack}</code><br> <code>%{Bugbear|damage}</code>
+
=== Exemple ===
  
== Attribute Macros ==
+
Dans cet exemple, notre personnage nommé <code>L'épouvantail</code> possède trois compétences : <code>%attaque</code>, <code>%dommages</code> et <code>%tout</code>.
  
A culmination of the above examples can be used in what we call Attribute Macros. By using an Attribute, that is assigned to a [[Journal|Character]], as a variable modifier you can create complex Character based macros. Since the variable used in the Macro is linked to a Character Attribute, the value will sync when changed in the [[Journal|Character]] editor. The Macro editor supports auto-complete of both nested macros (by pressing “#) and Attributes from Characters (by pressing “@).  
+
'''Compétence <code>%attaque</code>''' : <code>/roll 1d20+9</code>
 +
 
 +
'''Compétence <code>%dommages</code>''' : <code>/roll 1d4+11</code>
 +
 
 +
'''Compétence <code>%tout</code>''' :
 +
 
 +
<code>%{L'épouvantail|attaque }
 +
 
 +
%{L'épouvantail|dommages }</code>
 +
 
 +
== Macros d'attributs ==
 +
 
 +
La puissance des exemples ci-dessus peut-être améliorée parce ce que l'on appelle des macros d'attributs. En utilisant un attribut appartenant à un [[Journal (Français)|personnage]] comme un modificateur, vous pouvez créer des macros complexes construites sur les personnages. Tant que la variable utilisée dans la macro est liée à un attribut de personnage, la valeur sera synchronisée lors des changements dans la fenêtre d'édition du [[Journal (Français)|personnage]]. L'éditeur de macros supporte l'auto-complétion des macros (en appuyant sur "#") et des attributs des personnages (en appuyant sur "@").
  
 
[[File:CharMacroSS1.jpg|border]]
 
[[File:CharMacroSS1.jpg|border]]
  
Tip: When using &quot;@&quot; in the Macro editor use the directional Up and Down key to select the appropriate Attribute.
+
Astuce : en utilisant "@" dans l'éditeur de macros, utilisez les flèches directionnelles haut et bas pour sélectionner l'attribut voulu.
  
=== Video tutorial on using Abilities ===
+
=== Tutoriel vidéo sur l'utilisation des compétences ===
<br>A very basic look at using abilities for more simple rolls. (ex. Will Save, Skill Checks, etc.)
+
<br>[http://youtu.be/gIOsFeCsY0k Attributes & Abilities]
+
  
== Using a Selected Token with a Macro ==
+
Voici une vidéo expliquant sommairement l'utilisation des capacités pour des jets plus simples (comme des tests de compétences, des jets de sauvegarde de concentration, etc.)
The &quot;selected&quot; keyword will allow you to pull information from the element that is currently selected on the screen when the roll/macro is executed. So for example, if you want to pull the value of Bar 1 from the selected token during a roll, you can do:
+
 
 +
[http://youtu.be/gIOsFeCsY0k Attributes & Abilities]
 +
 
 +
== Utiliser un jeton sélectionné dans une macro ==
 +
 
 +
Le mot-clé "selected" vous permettra de récupérer des informations de l'élément actuellement sélectionné sur la table de jeu lorsqu'un jet ou une macro est exécuté. Par exemple, si vous souhaitez récupérer la valeur de la barre 1 du jeton sélectionné dans un jet, vous pouvez faire :
  
 
<pre data-language="javascript">/roll 1d20 + @{selected|bar1}</pre>
 
<pre data-language="javascript">/roll 1d20 + @{selected|bar1}</pre>
  
You can use "bar1", "bar2", or "bar3". In addition, you can also pull an attribute from the Character linked to that token, if there is one:
+
Vous pouvez utiliser "bar1", "bar2" ou "bar3". De plus, vous pouvez également récupérer les attributs du personnage lié au jeton, s'il en existe un :
  
 
<pre data-language="javascript">/roll 1d20 + @{selected|Intelligence}</pre>
 
<pre data-language="javascript">/roll 1d20 + @{selected|Intelligence}</pre>
  
You can pull the Name of the currently selected token's by using the &quot;token_name&quot; variable.
+
Vous pouvez récupérer le nom du jeton actuellement sélectionné en utilisant la variable "token_name".
  
<pre data-language="javascript">/em @{selected|token_name} fires his gun!</pre>
+
<pre data-language="javascript">/em @{selected|token_name} tire un coup de feu !</pre>
  
If the selected token has a character journal linked to it you can pull the Name from the character journal instead using the &quot;character_name&quot; variable.
+
Si le jeton sélectionné est lié à un personnage du journal, il est possible de récupérer le nom du personnage en utilisant la variable "character_name".
  
<pre data-language="javascript">/em @{selected|character_name} blocks with his shield!</pre>
+
<pre data-language="javascript">/em @{selected|character_name} bloque le coup avec son bouclier !</pre>
  
You can also trigger abilities from the linked character journal by using the ability name as a variable.
+
Vous pouvez également activer des compétences du personnage en utilisant le nom de la compétence comme une variable.
  
<pre data-language="javascript">%{selected|Attack}</pre>
+
<pre data-language="javascript">%{selected|Attaque}</pre>
  
Finally, we've introduced a 3rd argument for variables, allowing you to pull the "max" of a bar or attribute:
+
Enfin, nous avons ajouté un troisième argument pour les variables vous permettant de récupérer la valeur maximale des barres ou attributs :
  
 
<pre data-language="javascript">
 
<pre data-language="javascript">
/roll 1d20 + @{Guard|Intelligence|max}
+
/roll 1d20 + @{Garde|Intelligence|max}
 
/roll 1d20 + @{selected|bar2|max}</pre>
 
/roll 1d20 + @{selected|bar2|max}</pre>
  
Also, all names (for Characters, attributes, and abilities) are now case-insensitive when you use them, so &quot;GUARD&quot; and &quot;guard&quot; will now both match the Character &quot;Guard&quot;.
+
De plus, tous les noms (pour les personnages, attributs et compétences) sont désormais insensibles à la casse lorsque vous les utilisez, donc "GARDE" et "garde" sont désormais liés au même personnage "Garde".
  
 +
== Sélectionner un jeton depuis une macro ==
  
== Using a Targeted Token with a Macro ==
+
De la même manière que s'utilise le mot-clé "selected" pour récupérer les informations du jeton sélectionné (voir plus haut), vous pouvez également utiliser le mot-clé "target" pour accéder aux informations d'un jeton à sélectionner telles que des variables ou ses attributs. Cette commande permet au joueur de choisir parmi les jetons qu'il ne peut habituellement pas sélectionner, ce qui est excellent lorsqu'ils doivent attaquer un ennemi. Par exemple, si vous avez demandé à un joueur de lancer un d20 contre une cible dont vous avez indiquer l'attribut "force", le jet pourrait ressembler à ceci :
  
Very similar to using the "selected" keyword to pull information from a selected token (as illustrated above), you can also use the "target" keyword to access information such as variables and/or abilities of a "target" token.  This command lets players choose from tokens that they cannot normally select, which is excellent when they have to roll against enemies.  For example, if you told a player to roll a single 1d20 roll against a target you've advised has a "strength" attribute to overcome.  The roll would look like:
+
<pre data-language="javascript">/roll 1d20 - @{target|force}</pre>
  
<pre data-language="javascript">/roll 1d20 - @{target|strength}</pre>
+
Cela ouvrira une fenêtre demandant au joueur de sélectionner quel jeton sera sa cible.
This will bring up a prompt screen for the player to select which token target they are rolling against:
+
  
 
[[File:Choosetarget.png]]
 
[[File:Choosetarget.png]]
  
Again, the "target" keyword is almost identical in usage to the "selected" keyword as outlined above in the ways it can be employed-- the primary difference being that it allows players to utilize values from tokens they are not controlling.
+
Encore une fois, le mot-clé "target" est assez ressemblant dans son utilisation au mot-clé "selected" expliqué ci-dessus dans leurs emplois, la différence principale réside dans le fait d'autoriser le joueur à utiliser les valeurs d'un jeton qu'il ne contrôle pas.
  
'''Advanced Usage'''
+
'''Utilisation avancée'''
  
The full syntax for the target variable is:
+
La syntaxe complète d'utilisation des variables d'une cible est :
  
<pre data-language="javascript">@{target|<target_name>|<attribute_name>|<optional_flags>}</pre>
+
<pre data-language="javascript">@{target|<nom_de_la_cible>|<nom_de_l_attribut>|<drapeau_optionnel>}</pre>
  
So if you want to have multiple targets in your macro you can do:
+
Donc si vous avez plusieurs cibles dans votre macro, vous pouvez faire :
  
<pre data-language="javascript">@{target|Target1|HP} vs @{target|Target2|AC}</pre>
+
<pre data-language="javascript">@{target|Cible 1|PV} vs @{target|Cible 2|Armure}</pre>
  
And if you want to use the max of an attribute:
+
Et si vous souhaitez utiliser la valeur maximum d'une caractéristique :
  
<pre data-language="javascript">@{target|Target1|HP|max}</pre>
+
<pre data-language="javascript">@{target|Cible 1|PV|max}</pre>
  
Note that if you want to use the "max" flag you must specify the name of the target yourself, even if you just put "target1" as above.
+
Notez que si vous voulez utiliser le drapeau "max", vous devez spécifier le nom de la cible vous-même, même si vous indiquez uniquement "cible 1" comme ci-dessus.
  
== Roll Options ==
+
== Options de jet ==
&quot;Roll options&quot; are &quot;flags&quot; that you can set anywhere in a roll to tell the roll system you'd like to do special things with the roll result.
+
  
=== Rolling For Initiative ===
+
Les &quot;options de jet&quot; sont des drapeaux qui peuvent être appliqués n'importe où dans un jet pour indiquer au système que vous souhaitez faire quelque chose de particulier avec le résultat du jet.
To send a roll result directly to the turn tracker, first, select the Token you wish to roll for initiative and then use the below roll option in your macro:
+
 
 +
=== Jet d'initiative ===
 +
 
 +
Pour ajouter un jet directement dans le système de Turn Order de Roll20 (définissant l'initiative), sélectionnez d'abord le jeton dont vous voulez tirer l'initiative puis utilisez l'option de jet suivante dans votre macro :
  
 
<code>/roll 1d20 + 5 &{tracker}</code>
 
<code>/roll 1d20 + 5 &{tracker}</code>
  
The &quot;tracker&quot; roll option tells Roll20's roll system, &quot;Show the results of this roll, but also use the result as the value in the turn tracker.&quot; If the token that you have selected doesn't already have a turn in the turn order, one will be added. If it already has at least one turn, all current turns will be updated with the new value.
+
L'option de jet "tracker" demande au système de jet de Roll20 d'afficher le résultat du jet mais également de l'utiliser comme valeur dans le turn order. Si le jeton sélectionné n'a pas déjà une place dans le turn order, il sera ajouté. Si le jeton sélectionné a déjà au moins une place dans le turn order, alors toutes les valeurs correspondant à ce jeton seront modifiées.
  
In addition, you can add the result of the roll, or subtract the result of the roll, from the current turn value for the selected token by using the following flags:
+
De plus, vous pouvez ajouter ou déduire le résultat du jet à la valeur actuelle du turn order pour le jeton sélectionné en utilisant les drapeaux suivants :
  
 
<code>/roll 1d20 + 5 &{tracker:+}<br />
 
<code>/roll 1d20 + 5 &{tracker:+}<br />
 
/roll 1d20 + 5 &{tracker:-}</code>
 
/roll 1d20 + 5 &{tracker:-}</code>
  
For a game such as Shadowrun where you want to subtract 10 from the current initiative after every turn, you could have a global macro like so:
+
Pour un jeu tel que Shadowrun où l'initiative baisse de 10 à chaque tour, vous pourriez avoir une macro globale du type :
  
<code>/em @{selected|token_name} ends their turn. [[10 &{tracker:-}]]</code>
+
<code>/em @{selected|token_name} finit son tour. [[10 &{tracker:-}]]</code>
  
Note that the tracker flag works both in regular rolls and inline rolls.
+
Notez que le drapeau "tracker" fonctionne pour les jets normaux et les jets de dés dans le texte.
  
== Using a variable with a Macro ==
+
== Utiliser une variable dans une macro ==
  
'''Using Roll Queries'''
+
'''Utiliser les requêtes de jet'''
  
The easiest way to include a variable with a macro that you specify when it is executed is to use a Roll Query. For example, if you want to add a variable modifier onto a roll, you can make a macro like so:
+
Le moyen le plus simple d'inclure une variable dans une macro à son exécution est d'utiliser les requêtes de jet. Par exemple, si vous souhaitez ajouter un modificateur sur un jet, vous pouvez créer une macro telle que :
  
 
<pre data-language="javascript">
 
<pre data-language="javascript">
/roll 2d20 + ?{Modifier|0}
+
/roll 2d20 + ?{Modificateur|0}
 
</pre>
 
</pre>
  
When the macro is executed, a prompt will appear asking for the modifier to include. If no modifier is specified, the "|0" part of the query tells it to use 0 as the default value.
+
Lorsque la macro sera exécutée, une fenêtre d'invite s'ouvrira demandant le modificateur à ajouter. Si aucun modificateur n'est spécifié, la partie "|0" de la requête indiquera que 0 est la valeur par défaut.
  
More information on Roll Queries is available in the [[Dice Reference]].
+
Plus d'informations sur les requêtes de jet sont disponibles sur le [[Manuel complet des dés]].
  
'''Specifying a variable in chat'''
+
'''Indiquer une variable dans le chat'''
  
If you'd like to use a variable modifier with your macro roll, simply end the macro command with the modifier, and then specify it when calling your macro
+
Si vous voulez utiliser un modificateur lors de votre macro, terminez simplement le corps de votre macro avant le modificateur puis spécifiez le lors de l'appel de la macro.
  
=== Example ===
+
=== Exemple ===
  
If I want a macro for 1d20+x (<i>where x is my variable value</i>) I could create the following macro:<br> <code>#d20</code> <code>/roll 1d20+</code><br> then, when running the macro, type <code>#d20</code><code>4</code> to get <code>/roll 1d20+4</code><br>
+
Si vous créez une macro permettant de lancer 1d20+x (x est la valeur de votre variable), vous pourriez créer la macro suivante :
  
== Macro Bar ==
+
'''Nom de la macro''' : <code>#d20</code>
  
You can also create quick access buttons for any of your macros that will appear in a bar at the bottom of the screen. First, create your macro like normal. Then, to enable the macro quick bar, check off &quot;Show macro quick bar&quot; in the settings menu<br>
+
'''Corps de la macro''': <code>/roll 1d20+</code>
  
[[File:showquickbar.png|border]]
+
Puis, lors de l'appel de la macro, entrez <code>#d20 4</code> pour obtenir <code>/roll 1d20+4</code>.
  
Then, to add a macro to the bar, simply check the &quot;In bar&quot; option next to the macro's name. If you have forgotten to turn the macro quickbar on, toggling on a macro will auto-enable the quickbar to display.
+
== Barre de macros ==
  
 +
Vous pouvez créer des boutons d'accès rapide pour chacune de vos macros qui apparaîtront dans une barre en bas de l'écran. Créez tout d'abord votre macro comme à votre habitude. Puis, pour activer la barre d'accès rapide aux macros, cochez la case "Afficher la barre d'accès rapide aux macros" (Show macro quick bar) dans l'onglet "Mes préférences" (My Settings).
  
[[File:macroinbar.png|border]]
+
[[File:showquickbar.png|border]]
  
 +
Pour ensuite ajouter une macro à la barre, cochez simplement la case "Dans la barre" (In bar) à côté du nom de votre macro. Si vous avez oublié d'activer votre barre d'accès rapide aux macros, y ajouter une macro l'affichera automatiquement.
 +
 +
[[File:macroinbar.png|border]]
  
The quickbar, and any macros that you have selected should now appear on the bottom of your screen, underneath the character portraits. If you'd like to re-arrange the buttons on the bar, hover your mouse over the button that you'd like to move. A handle will appear on the right side of the button. You can drag the button around the bar by using this handle.
+
La barre d'accès rapide et toutes les macros que vous avez sélectionnées doivent désormais apparaître en bas de votre écran sous les avatars des personnages. Si vous voulez modifier l'ordre des boutons dans la barre, survolez le bouton que vous voudriez déplacer, vous pourrez alors déplacer le bouton dans la barre en utilisant sa poignée située à sa droite.
  
 
[[File:macrobar.png|border]]
 
[[File:macrobar.png|border]]
  
Shift+Clicking on a Macro in the macro quickbar will open the editor for that specific macro.
+
Appuyer sur Shift (Maj) en cliquant sur une macro située dans la barre d'accès rapide ouvrira la fenêtre d'édition de cette macro.
  
 
[[Category:Docs]]
 
[[Category:Docs]]
 +
[[Category:Language-FR]]
 +
[[Category:Macros]]

Latest revision as of 16:23, 13 May 2018

Les macros sont des raccourcis créés par l'utilisateur pour les commandes que vous utilisez régulièrement. Vous pouvez par exemple créer une macro qui fait pousser un cri de guerre puis lance une attaque que vous utilisez souvent. Au lieu d'avoir besoin de taper et retaper les commandes fréquentes, il vous suffit de créer une macro et de la taper une seule fois.

Contents

[edit] Créer et modifier des macros

Allez dans l'onglet Collection (En cliquant sur l'icône avec 3 points et 3 traits) dans la barre latérale. Pour créer une macro, cliquez tout d'abord sur le bouton Ajouter (Add) de la section Macros. Entrez ensuite le nom que vous souhaitez donner à la macro (par exemple : test). Entrez ensuite la commande que doit effectuer cette macro : cela peut être du texte, un jet de dés ou une action. Appuyez ensuite sur le bouton Sauvegarder (Save changes)pour enregistrer la macro.

Pour utiliser la macro, entrez # puis le nom de la macro (par exemple : #test) puis appuyez sur entrer. Il existe une fonction d'auto-complétion pour les macros.

[edit] Commandes multiples

L'une des forces des macros est leur capacité à exécuter plusieurs actions à l'aide d'une seule commande. Pour ce faire, séparez simplement les différentes commandes par un retour à la ligne, elles seront alors exécutées dans l'ordre lorsque vous utiliserez la macro.

[edit] Exemple

Si vous voulez créer une macro qui inscrive une action puis lance un jet d'attaque et de dommages, votre macro pourrait ressembler à ceci :

Nom de la macro : Coup-de-dague

Corps de la macro :

/me enfonce sa dague.
/roll 1d20+10 Test d'attaque
/roll 1d4+9 Dommages

Tapez ensuite simplement #Coup-de-dague pour exécuter ces trois actions d'un coup.

Cela ressemblera à ceci :

AttackMacro.JPG

Les macros peuvent également inclure des textes qui ne sont pas des commandes, par exemple :

/me en appelle au pouvoir de Moradin ! Je te châtie ! /roll 1d20+4 Test d'adresse /roll 1d8+4 Dommages

Cela inscrira tout d'abord une action, puis le dialogue "Je te châtie !" et lancera enfin deux jets de dés.

[edit] Macros imbriquées

Les macros peuvent s'imbriquer les unes dans les autres, ce qui donne la possibilité de combiner des macros en appelant plusieurs macros d'un seul coup. Pour imbriquer des macros, entrez simplement le nom de la macro que vous souhaitez appeler dans le corps de la nouvelle macro.

[edit] Exemple

Dans cet exemple, nous avons trois macros : #attaque, #dommages et #tout.

Macro #attaque  : /roll 1d20+9

Macro #dommages  : /roll 1d4+11

Macro #tout  :

#attaque

#dommages

[edit] Imbriquer des compétences

Une compétence est un autre nom pour les macros spécifiques à certains personnages et qui est créée dans la feuille de personnage située dans l'onglet journal. Tout comme les macros, les compétences peuvent s'imbriquer les unes dans les autres, ce qui donne la possibilité de les enchaîner et d'appeler plusieurs compétences d'un seul coup.

Pour utiliser la compétence, entrez % puis insérez entre accolades le nom du personnage puis le nom de la compétence séparés par une barre verticale (|, faîtes Alt Gr + -" pour l'obtenir). Il existe un système d'auto-complétion pour les compétences utilisable uniquement depuis le chat.

[edit] Exemple

Dans cet exemple, notre personnage nommé L'épouvantail possède trois compétences : %attaque, %dommages et %tout.

Compétence %attaque : /roll 1d20+9

Compétence %dommages : /roll 1d4+11

Compétence %tout :

%{L'épouvantail|attaque }

%{L'épouvantail|dommages }

[edit] Macros d'attributs

La puissance des exemples ci-dessus peut-être améliorée parce ce que l'on appelle des macros d'attributs. En utilisant un attribut appartenant à un personnage comme un modificateur, vous pouvez créer des macros complexes construites sur les personnages. Tant que la variable utilisée dans la macro est liée à un attribut de personnage, la valeur sera synchronisée lors des changements dans la fenêtre d'édition du personnage. L'éditeur de macros supporte l'auto-complétion des macros (en appuyant sur "#") et des attributs des personnages (en appuyant sur "@").

CharMacroSS1.jpg

Astuce : en utilisant "@" dans l'éditeur de macros, utilisez les flèches directionnelles haut et bas pour sélectionner l'attribut voulu.

[edit] Tutoriel vidéo sur l'utilisation des compétences

Voici une vidéo expliquant sommairement l'utilisation des capacités pour des jets plus simples (comme des tests de compétences, des jets de sauvegarde de concentration, etc.)

Attributes & Abilities

[edit] Utiliser un jeton sélectionné dans une macro

Le mot-clé "selected" vous permettra de récupérer des informations de l'élément actuellement sélectionné sur la table de jeu lorsqu'un jet ou une macro est exécuté. Par exemple, si vous souhaitez récupérer la valeur de la barre 1 du jeton sélectionné dans un jet, vous pouvez faire :

/roll 1d20 + @{selected|bar1}

Vous pouvez utiliser "bar1", "bar2" ou "bar3". De plus, vous pouvez également récupérer les attributs du personnage lié au jeton, s'il en existe un :

/roll 1d20 + @{selected|Intelligence}

Vous pouvez récupérer le nom du jeton actuellement sélectionné en utilisant la variable "token_name".

/em @{selected|token_name} tire un coup de feu !

Si le jeton sélectionné est lié à un personnage du journal, il est possible de récupérer le nom du personnage en utilisant la variable "character_name".

/em @{selected|character_name} bloque le coup avec son bouclier !

Vous pouvez également activer des compétences du personnage en utilisant le nom de la compétence comme une variable.

%{selected|Attaque}

Enfin, nous avons ajouté un troisième argument pour les variables vous permettant de récupérer la valeur maximale des barres ou attributs :

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

De plus, tous les noms (pour les personnages, attributs et compétences) sont désormais insensibles à la casse lorsque vous les utilisez, donc "GARDE" et "garde" sont désormais liés au même personnage "Garde".

[edit] Sélectionner un jeton depuis une macro

De la même manière que s'utilise le mot-clé "selected" pour récupérer les informations du jeton sélectionné (voir plus haut), vous pouvez également utiliser le mot-clé "target" pour accéder aux informations d'un jeton à sélectionner telles que des variables ou ses attributs. Cette commande permet au joueur de choisir parmi les jetons qu'il ne peut habituellement pas sélectionner, ce qui est excellent lorsqu'ils doivent attaquer un ennemi. Par exemple, si vous avez demandé à un joueur de lancer un d20 contre une cible dont vous avez indiquer l'attribut "force", le jet pourrait ressembler à ceci :

/roll 1d20 - @{target|force}

Cela ouvrira une fenêtre demandant au joueur de sélectionner quel jeton sera sa cible.

Choosetarget.png

Encore une fois, le mot-clé "target" est assez ressemblant dans son utilisation au mot-clé "selected" expliqué ci-dessus dans leurs emplois, la différence principale réside dans le fait d'autoriser le joueur à utiliser les valeurs d'un jeton qu'il ne contrôle pas.

Utilisation avancée

La syntaxe complète d'utilisation des variables d'une cible est :

@{target|<nom_de_la_cible>|<nom_de_l_attribut>|<drapeau_optionnel>}

Donc si vous avez plusieurs cibles dans votre macro, vous pouvez faire :

@{target|Cible 1|PV} vs @{target|Cible 2|Armure}

Et si vous souhaitez utiliser la valeur maximum d'une caractéristique :

@{target|Cible 1|PV|max}

Notez que si vous voulez utiliser le drapeau "max", vous devez spécifier le nom de la cible vous-même, même si vous indiquez uniquement "cible 1" comme ci-dessus.

[edit] Options de jet

Les "options de jet" sont des drapeaux qui peuvent être appliqués n'importe où dans un jet pour indiquer au système que vous souhaitez faire quelque chose de particulier avec le résultat du jet.

[edit] Jet d'initiative

Pour ajouter un jet directement dans le système de Turn Order de Roll20 (définissant l'initiative), sélectionnez d'abord le jeton dont vous voulez tirer l'initiative puis utilisez l'option de jet suivante dans votre macro :

/roll 1d20 + 5 &{tracker}

L'option de jet "tracker" demande au système de jet de Roll20 d'afficher le résultat du jet mais également de l'utiliser comme valeur dans le turn order. Si le jeton sélectionné n'a pas déjà une place dans le turn order, il sera ajouté. Si le jeton sélectionné a déjà au moins une place dans le turn order, alors toutes les valeurs correspondant à ce jeton seront modifiées.

De plus, vous pouvez ajouter ou déduire le résultat du jet à la valeur actuelle du turn order pour le jeton sélectionné en utilisant les drapeaux suivants :

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

Pour un jeu tel que Shadowrun où l'initiative baisse de 10 à chaque tour, vous pourriez avoir une macro globale du type :

/em @{selected|token_name} finit son tour. [[10 &{tracker:-}]]

Notez que le drapeau "tracker" fonctionne pour les jets normaux et les jets de dés dans le texte.

[edit] Utiliser une variable dans une macro

Utiliser les requêtes de jet

Le moyen le plus simple d'inclure une variable dans une macro à son exécution est d'utiliser les requêtes de jet. Par exemple, si vous souhaitez ajouter un modificateur sur un jet, vous pouvez créer une macro telle que :

/roll 2d20 + ?{Modificateur|0}

Lorsque la macro sera exécutée, une fenêtre d'invite s'ouvrira demandant le modificateur à ajouter. Si aucun modificateur n'est spécifié, la partie "|0" de la requête indiquera que 0 est la valeur par défaut.

Plus d'informations sur les requêtes de jet sont disponibles sur le Manuel complet des dés.

Indiquer une variable dans le chat

Si vous voulez utiliser un modificateur lors de votre macro, terminez simplement le corps de votre macro avant le modificateur puis spécifiez le lors de l'appel de la macro.

[edit] Exemple

Si vous créez une macro permettant de lancer 1d20+x (où x est la valeur de votre variable), vous pourriez créer la macro suivante :

Nom de la macro : #d20

Corps de la macro: /roll 1d20+

Puis, lors de l'appel de la macro, entrez #d20 4 pour obtenir /roll 1d20+4.

[edit] Barre de macros

Vous pouvez créer des boutons d'accès rapide pour chacune de vos macros qui apparaîtront dans une barre en bas de l'écran. Créez tout d'abord votre macro comme à votre habitude. Puis, pour activer la barre d'accès rapide aux macros, cochez la case "Afficher la barre d'accès rapide aux macros" (Show macro quick bar) dans l'onglet "Mes préférences" (My Settings).

Showquickbar.png

Pour ensuite ajouter une macro à la barre, cochez simplement la case "Dans la barre" (In bar) à côté du nom de votre macro. Si vous avez oublié d'activer votre barre d'accès rapide aux macros, y ajouter une macro l'affichera automatiquement.

Macroinbar.png

La barre d'accès rapide et toutes les macros que vous avez sélectionnées doivent désormais apparaître en bas de votre écran sous les avatars des personnages. Si vous voulez modifier l'ordre des boutons dans la barre, survolez le bouton que vous voudriez déplacer, vous pourrez alors déplacer le bouton dans la barre en utilisant sa poignée située à sa droite.

Macrobar.png

Appuyer sur Shift (Maj) en cliquant sur une macro située dans la barre d'accès rapide ouvrira la fenêtre d'édition de cette macro.