Roll20 uses cookies to improve your experience on our site. Cookies enable you to enjoy certain features, social sharing functionality, and tailor message and display ads to your interests on our site and others. They also help us understand how our site is being used. By continuing to use our site, you consent to our use of cookies. Update your cookie preferences .
×
May your rolls be merry + bright! 🎄
Create a free account

Roll Templates and Sheet Rolls

I have so many questions regarding both Roll Templates and Sheet Rolls (and the wiki... and the forums...), but for now I'll just ask this one: The wiki page for Roll Templates ( <a href="https://wiki.roll20.net/Roll_Templates" rel="nofollow">https://wiki.roll20.net/Roll_Templates</a>) states: "If you're using a Character Sheet, there's a really good chance you'll use a Roll Template just by clicking the roll button on the sheet, or by calling a sheet roll in a macro or ability. " (Emphasis mine.) How do you call a sheet roll in a macro or ability? That wiki page only says that it can be done, but doesn't obviously describe the procedure or syntax. Thanks for the help.
1426916420
vÍnce
Pro
Sheet Author
Hi Typo. Nesting Macros (wiki) allows you call one macro from within another. One method to learn a sheet roll's macro name; execute a sheet roll button from the character sheet, after it's done, click into chat and use the UP arrow key to see the commands that were just sent to chat(you can cycle using Up/Down keys). You should see a name that starts with "%" That is the name of the sheet roll macro. You can use that name inside of other macros to trigger that macro. Nesting macros. Hope this helps. Cheers
1426932034
Finderski
Plus
Sheet Author
Compendium Curator
Quick clarification on what Vince said...you can call sheet roll macros for all the buttons on the character sheet EXCEPT for those that are part of a repeating section (ones that get added by the +Add button).
1426984220
vÍnce
Pro
Sheet Author
G V. said: Quick clarification on what Vince said...you can call sheet roll macros for all the buttons on the character sheet EXCEPT for those that are part of a repeating section (ones that get added by the +Add button). THAT, is a very good point. Can't drag and drop them either... Pesky repeatable items. Thanks GV
This is very useful information that wasn't available (or at least easily found) in the wiki. I, too, was frustrated by the inability to drag and drop buttons into macros/abilities. Knowing that the code is stored in the chat entries - and how to find it - is extremely helpful. Thanks, folks! Vince said: Hi Typo. Nesting Macros (wiki) allows you call one macro from within another. One method to learn a sheet roll's macro name; execute a sheet roll button from the character sheet, after it's done, click into chat and use the UP arrow key to see the commands that were just sent to chat(you can cycle using Up/Down keys). You should see a name that starts with "%" That is the name of the sheet roll macro. You can use that name inside of other macros to trigger that macro. Nesting macros. Hope this helps. Cheers Vince, when I do this with Abilities that I have created in my character sheet (in the Attributes & Abilities tab), I get the notation that you're talking about with the percent sign. But when I click a button generated by the character sheet - the Initiative button, for example - I get a macro's worth of code dumped into the chat and then executed. Is there any way to call those buttons with a simple name, or do I just have to copy and paste all the code? Also, my character sheet buttons seem to be calling templates (designated by the ampersand "&" signal, correct?). Is there a list somewhere of templates available in Roll20 and the parameters and arguments they use? The Roll Templates entry in the wiki (which I linked in my OP) as a few examples, but not a complete list, and some of the examples seem to be inaccurate. Beyond that, different templates seem to have different syntax in some cases. I'm looking for a resource where I can find all the different templates and how they work.
1427579587

Edited 1427580018
vÍnce
Pro
Sheet Author
TYPO said: This is very useful information that wasn't available (or at least easily found) in the wiki. I, too, was frustrated by the inability to drag and drop buttons into macros/abilities. Knowing that the code is stored in the chat entries - and how to find it - is extremely helpful. Thanks, folks! Vince said: Hi Typo. Nesting Macros (wiki) allows you call one macro from within another. One method to learn a sheet roll's macro name; execute a sheet roll button from the character sheet, after it's done, click into chat and use the UP arrow key to see the commands that were just sent to chat(you can cycle using Up/Down keys). You should see a name that starts with "%" That is the name of the sheet roll macro. You can use that name inside of other macros to trigger that macro. Nesting macros. Hope this helps. Cheers Vince, when I do this with Abilities that I have created in my character sheet (in the Attributes & Abilities tab), I get the notation that you're talking about with the percent sign. But when I click a button generated by the character sheet - the Initiative button, for example - I get a macro's worth of code dumped into the chat and then executed. Is there any way to call those buttons with a simple name, or do I just have to copy and paste all the code? Also, my character sheet buttons seem to be calling templates (designated by the ampersand "&" signal, correct?). Is there a list somewhere of templates available in Roll20 and the parameters and arguments they use? The Roll Templates entry in the wiki (which I linked in my OP) as a few examples, but not a complete list, and some of the examples seem to be inaccurate. Beyond that, different templates seem to have different syntax in some cases. I'm looking for a resource where I can find all the different templates and how they work. You can right-click any non-repeatable button and use Inspect Element(Chrome) to see the code(html) associated with the button/macro. The "title=" is the button/macro name and it starts with % as expected. The "value=" attribute listed is what is sent to chat. Same as if you manually typed it in chat and hit enter. The roll templates available depend on what sheet you are using. Best to look for info in the wiki or the character sheet forums. Given time, the character sheet templates page will proabbaly include information about roll templates. The roll20 &{template:default} is available to everyone regardless of the sheet used.
Pathfinder Character Sheet Roll Templates &lt;!-- Spell Roll Templates --&gt; pf_spell &{template:pf_spell} {{character_name}} {{character_id}} {{name}} {{name_link}} {{school}} {{level}} {{casting_time}} {{components}} {{range}} {{target}} {{duration}} {{saving_throw}} {{dc}} {{sr}} {{spell_description}} &lt;!-- Attack Roll Templates --&gt; pf_attack &{template:pf_attack} {{character_name}} {{character_id}} {{name}} {{name_link}} {{attack}} {{crit_confirm}} {{damage}} {{crit_damage}} {{attack2}} {{crit_confirm2}} {{damage2}} {{crit_damage2}} {{description}} &lt;!-- Generic Roll Templates --&gt; pf_generic &{template:pf_generic} {{character_name}} {{character_id}} {{name}} {{name_link}} {{check}} &lt;!-- Block Text Roll Templates --&gt; pf_block &{template:pf_generic} {{character_name}} {{character_id}} {{name}} {{name_link}} {{description}} 5e is a little more complicated: Available Header Colors/Fields: (grey header) &lt;blank&gt; (red header) {{save=1}} (brown header) {{deathsave=1}} (green header) {{weapon=1}} (will hide critdamage unless attack or attackadv is a crit) (teal header) {{ability=1}} (purple header) {{spell=1}} Example: &{template:5eDefault} {{weapon=1}} .... gives the template a green Header, where &{template:5eDefault} {{ability=1}} gives it a teal one. Samples : &{template:5eDefault} {{weapon=1}} {{title=Header title}} {{subheader=Left Side subheader}} {{subheaderright=Right Side subheader}} {{attack=}} {{attackadv=}} {{damage=}} {{critdamage=}} {{spellattack=}} {{spellshowattackadv=1}}{{spellattackadv=}}{{spellshowdamage=1}}{{spelldamage=}}{{spellcancrit=1}}{{spellcritdamage=}} Adding "@{classactioncustom1skill}" to the end of your Template call allows you to use custom properties like {{Blablah=YakkeyShmakety}}
1427598614

Edited 1427598724
Thanks, ya'll! Really helpful information! But I have some more questions. Vince said: You can right-click any non-repeatable button and use Inspect Element(Chrome) to see the code(html) associated with the button/macro. The "title=" is the button/macro name and it starts with % as expected. The "value=" attribute listed is what is sent to chat. Same as if you manually typed it in chat and hit enter. I don't really know what you mean by "non-repeatable button." What's the difference between a repeatable button and a non-repeatable button? How do I tell them apart? Can you give me some examples of both? I'm not certain which character sheets we're using, but I'm pretty sure they're 5e. At any rate they say Dungeons and Dragons at the top, and the sheet version is 22 Mar 2015. So I tried Inspect Element on the Initiative button and here's what I got (I couldn't put the entirety of the element in here because apparently this forum software automatically interprets HTML and kept pasting the actual button in; I left out a few characters so that it would paste correctly, so I hope I'm not missing anything important): button type="roll" name="roll_Initiative" value="&{template:5eDefault} {{title=Initiative}} {{subheader=@{character_name}}} {{rollname=Initiative}} {{roll=[[ 1d20 + @{selected|initiative_overall} [Initiative Mod] &{tracker} ]]}} @{classactioninitiative}"&gt;Initiative I see a "name=" parameter, but no "title=" parameter. The "name=" parameter doesn't include the percent marker (in fact, I don't see one in there at all), and when I try to call "%roll_Initiative" in the chat window, it sends that string of characters to the chat stream as though it were a message. The "value=" data is what is sent to the chat stream and executed. I'm certain I'm doing something wrong here, but I don't know what. Thoughts?
To see what the actual roll button is doing; click the button on the sheet to roll it, then in the chat window just hit the UP arrow on your keyboard. For example: The 5e Initiative button does: &{template:5eDefault} {{title=Initiative}} {{subheader=@{Verin|character_name}}} {{rollname=Initiative}} {{roll=[[ 1d20 + @{selected|initiative_overall} [Initiative Mod] &{tracker} ]]}} @{Verin|classactioninitiative} If I were to drag the initiative button from the sheet on to my macro bar, click the button, and then hit UP on my keyboard in chat, I see: %{Verin|Initiative} That shows me that I can call the initiative button within other macros by including "%{Verin|Initiative}" That same process would apply to any button. The reference to repeatable vs. non-repeatable is simple, though not exactly intuitive. "Non-Repeatable" buttons are those on the sheet that are always there... they're permanent. "Repeatable" buttons are those you have to add or create by clicking an "Add" button somewhere on the sheet... like the Spells section. Roll buttons in those sections cannot be dragged to the macro bar.