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 "Roll Templates"

From Roll20 Wiki

Jump to: navigation, search
m
m (D&D 5E by Roll20)
 
(3 intermediate revisions by one user not shown)
Line 36: Line 36:
  
 
===Default===
 
===Default===
The '''default''' rolltemplate is built-in to Roll20, and can be used in any game, regardless of. You don't have to even have a character sheet template selected for your game to use it.
+
{{main|Default Roll Template}}
 +
{{:Roll Templates/Default}}
  
To use the default template, you first call <code>&{template:default}</code>, then (optionally) define what will be shown in the header in a <code><nowiki>{{name= }}</nowiki></code>-section, after which you can create any number of "rows" by creating more <code><nowiki>{{ }}</nowiki></code>-sections.
+
===D&D 5E by Roll20===
 +
{{main|D&D 5e by Roll20 Roll Templates}}
  
{| class="wikitable"
+
The [[D&D 5E by Roll20]]-character sheet has 10 built in roll templates.
|-
+
! Property !! Expected Value
+
|-
+
| name || The name of the roll, shown in the header of the roll listing. (''If not used in a roll, the header will appear at the top of the roll template as a purple bar with no text.'')
+
|-
+
| (anything) || You can have any number of rows with any name you want, making the template somewhat flexible. The "property" name will be bold.
+
|-
+
|}
+
 
+
'''The default template is special''', and will list out whatever argument you give it in a table. It will put in the middle of the purple header anything you define in the <code><nowiki>{{name= }}</nowiki></code> section, and then with every subsequent <code><nowiki>{{ }}</nowiki></code> segment, it will alternate with white & gray background.
+
 
+
If a <code>=</code> is used in the <code><nowiki>{{ }}</nowiki></code> rows, the roll template will align the <code>=</code> in the middle, and all rows will have the <code>=</code> in the same spot. If any row have lots of more text/content on either side of the <code>=</code>, it will be pressed to the side of the template for all rolls.
+
  
 
{{ex}}
 
{{ex}}
 +
[[File:5e-rolltemplate-ex1-2021.png|200px|right|none]]
 +
Rolls stealth for selected npc token, using its stealth proficiency. Using the <code>&{template:npcatk}</code> template from it.
 +
<pre>/w gm &{template:npcatk} {{attack=1}} {{name=Shadow}} {{rname=Shadow Stealth}} {{rnamec=Hide}} {{r1=[[@{selected|d20}+@{selected|npc_stealth} + 6]]}} {{always=1}} {{r2=[[@{selected|d20}+@{selected|npc_stealth} + 6]]}} {{description=While in dim light or darkness, the shadow can take the Hide action as a bonus action. Its stealth bonus is **also** improved to +6 }}</pre>
  
<pre style="overflow:hidden;white-space:pre-wrap">
+
===Pathfinder by Roll20===
&{template:default} {{name=Test Attack}} {{attack=[[1d20+3]]}} {{note= This is some note content}} {{Saving Throw= vs Will}}
+
{{main|Pathfinder by Roll20/Roll Templates}}
</pre>
+
[[File:Roll template default example2.JPG]]
+
<br />
+
  
Notice that the content of the roll template is pressed to the left side, due the text segment on the '''Note'''-row. If that segment is removed, the content of the remaining rows will be closer to the center.
+
The [[Pathfinder by Roll20]] character sheet has two different templates, one for PC (<code>&{template:pc}</code>) and one for NPC (<code>&{template:npc}</code>), that individually handles every types of roll.
  
[https://jsfiddle.net/8w3qm3zL/41/ Here] is a fairly close example of the default template's HTML& CSS with it's dependent CSS classes. If you intend to make your own roll template, or want to start from the default template, the best idea is to start with the code from [[Building_Character_Sheets/Roll_Templates#Jakob.27s_Better_Default_Rolltemplate|Jakob's Better Default Template]].
+
They share mostly the same fields but are styled differently, and the NPC template handles attacks slightly differently. Otherwise, they generally can be used indifferently for macro purpose.
  
====Examples====
+
[[File:PF wiki Template.jpeg|framed|right]]
Some more examples using the default roll template. these should
+
Example with PC template:
 
+
<pre style="overflow:auto;white-space:pre-wrap;">&{template:pc} {{showchar=[[1]]}} {{charname=charname}} {{name=name}} {{type=ability}} {{roll=roll}} {{descflag=1}} {{desc=desc}} {{shownotes=[[1]]}} {{notes=notes}}</pre>
 
+
Roll template rolls that has [[Inline#Inline_Labels|inline labels]], which will make it easier to look at the roll breakdown(when you hover your mouse over the result).
+
<pre style="overflow:hidden;white-space:pre-wrap">
+
&{template:default} {{name=Mage Bolt}} {{attack=[[1d20+3[int]+2[proficiency] ]]}} {{Damage= [[3d6[base dmg]+3[int mod]+1d8[Elder Wand bonus] force dmg]]}} {{DC [[14]] Will Save= The enemy must make the save, or take an extra [[1d8]] fire dmg. }}
+
</pre>
+
 
+
You can have rolls on both sides of the <code>=</code>
+
<pre style="overflow:hidden;white-space:pre-wrap">
+
&{template:default} {{name=Greatsword of the Nomads}} {{attack= has advantage, pick higher result}} {{[[1d20+4]]=[[1d20+4]]}} {{Damage= [[2d6+2]]}} {{If critical= Apply only if attack is critical}} {{Crit damage= deals [[2d6]] more on crit}} {{Special Crit= The Greatsword of the Nomads deals on crit an extra [[1d8]] radiant damage, and the defender needs to make a DC [[14]] Con save or gain a level of exhaustion}}
+
</pre>
+
 
+
Can be useful to make several attacks at a time
+
<pre style="overflow:hidden;white-space:pre-wrap">
+
&{template:default} {{name=Fist of Fury}} {{Attack1= [[1d20+5]]}} {{Damage1= [[1d6+3]]}} {{Attack2= [[1d20+5]]}} {{Damage2= [[1d6+3]]}} {{Offhand= [[1d20+4]]}} {{Damage1= [[1d4+3]]}}
+
</pre>
+
 
+
A macro for short rest. It asks you how many to spend & what hit dice to use, and displays how much was recovered as well as how many where spent(using the [[Reusing Rolls]]-trick).
+
<pre style="overflow:hidden;white-space:pre-wrap">
+
&{template:default} {{name=Short Rest}} {{Recover= You heal [[ [[?{How many hit dice do you spend?|1}]]?{What's your Hit dice?|d4|d6|d8|d10|d12} ]] hit points, having spent $[[0]] of their hit dice.}}
+
</pre>
+
 
+
===D&D 5E by Roll20===
+
{{main|D&D 5e by Roll20 Roll Templates}}
+
 
+
The [[D&D 5E by Roll20]]-character sheet has 10 built in roll templates.
+
 
+
{{ex}}
+
[[File:5e-rolltemplate-ex1-2021.png|200px|right|none]]
+
Rolls stealth for selected npc token, using it's stealth proficiency. Using the <code>&{template:npcatk}</code> template from it.
+
<code><nowiki>/w gm &{template:npcatk} {{attack=1}} {{name=Shadow}} {{rname=Shadow Stealth}} {{rnamec=Hide}} {{r1=[[@{selected|d20}+@{selected|npc_stealth} + 6]]}} {{always=1}} {{r2=[[@{selected|d20}+@{selected|npc_stealth} + 6]]}} {{description=While in dim light or darkness, the shadow can take the Hide action as a bonus action. Its stealth bonus is **also** improved to +6 }}</nowiki></code>
+
  
 
=Creating a Roll Template=
 
=Creating a Roll Template=
Line 119: Line 79:
 
** [[Sheet Author Tips]] More advanced tips for creating/maintaining sheets, workflow, & useful tools
 
** [[Sheet Author Tips]] More advanced tips for creating/maintaining sheets, workflow, & useful tools
 
** [[Custom Sheet Sandbox|Sheet Sandbox]] – the better editor to use when you code your character sheets
 
** [[Custom Sheet Sandbox|Sheet Sandbox]] – the better editor to use when you code your character sheets
* {{zendesk|articles/360037257334-How-to-Make-Roll-Templates Official version of this page}} - Almost always outdated/lacking compared to any pages on sheet development on the wiki
+
* {{hc|articles/360037257334-How-to-Make-Roll-Templates Official version of this page}} - Often lacking compared to any pages on sheet development on the community wiki
 
<br>
 
<br>
 
<br>
 
<br>
Line 125: Line 85:
 
[[Category:Docs]]
 
[[Category:Docs]]
 
[[Category:Macros]]
 
[[Category:Macros]]
 +
[[Category:Roll Templates]]
 +
[[Category:Character Sheets]]

Latest revision as of 00:08, 11 January 2023

Roll Templates are a special facet of the Character Sheets system which provide additional layout and styling options for the display of roll results.

The output of a default template used in q Text Chat

Contents

[edit] Using Roll Templates

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. You don't have to do anything extra to do this, it's already set up for you in advance by the sheet author.

If you're interested in using Roll Templates in your own custom macros or creating your own custom templates, read on further.

Using a roll template is pretty easy. Just include a special flag in your chat message which tells Roll20 that you want to use a Roll Template, and then provide all of the data for the rolls and info that you want to include inside {{ }}-sections . Here's an example that uses the "default" template (which all games have access to, regardless of the game system or character sheet you are using):

&{template:default} {{name=Test Attack}} {{attack=[[1d20]]}} {{damage=[[2d6]]}}
Roll template default example.JPG

The &{template:<template_name>} is the part that tells the system to use a Roll Template, and specifies the name of the template you want to use. Then you just provide all the data for the template in the format {{<propertyname>= <value>}}. The propertyname that you should use depends on the template, and sometimes can be whatever you want -- the Character Sheet documentation should let you know what's available(or you can take a look at existing macros and see how they are structured), and we've provided documentation on all of the built-in templates below. Value can be either text or an inline roll, including macros, abilities, etc. Note that if you use a macro or ability, it must be an inline roll, and not a /roll command.


Here's an example that uses a %{Character|attack} ability:

&{template:default} {{name=Test With Ability}} {{attack= %{Character_Name|attack} }} {{damage= #damagemacro }}

[edit] When Can I Use Roll Templates?

Which rolltemplates that are available in your game, is dependent on what character sheet template is used in your game, as rolltemplates are coded into character sheets.

For example, to use the &{template:simple} template that is used on the D&D 5E by Roll20 sheet for Ability & Skill rolls, you need to have that sheet template in your game, or it won't work. See D&D 5E simple template for more.

You can use a Roll Template in general messages (without a command like /desc or /emote) and whispers. You can't use roll templates with the /roll command; instead, Roll Templates are meant to be used with inline rolls. As long as they use inline rolls, you can use Roll Templates with macros, Character Abilities, and sheet authors can use them inside of their Roll Buttons on character sheets.

[edit] Examples of Roll Templates

Here are some examples of roll different templates. Only the default template is available in any game, the others can be used if the corresponding sheet is used in your campaign.

[edit] Default

Main Page: Default Roll Template


The Default Roll Template is available in all Roll20. You don't have to even have a character sheet template selected for your game to use it.


Property Expected Value
name The name of the roll, shown in the header of the roll listing. (If not used in a roll, the header will appear at the top of the roll template as a purple bar with no text.)
(anything) You can have any number of rows with any name you want, making the template somewhat flexible. The "property" name will be bold.

The default template is special, and will list out whatever argument you give it in a table. It will put in the middle of the purple header anything you define in the {{name= }} section, and then with every subsequent {{ }} segment, it will alternate with white & gray background.

If a = is used in the {{ }} rows, the roll template will align the = in the middle, and all rows will have the = in the same spot. If any row have lots of more text/content on either side of the =, it will be pressed to the side of the template for all rolls.


Example:

&{template:default} {{name=Test Attack}} {{attack=[[1d20+3]]}} {{note= This is some note content}} {{Saving Throw= vs Will}}

Roll template default example2.JPG

Notice that the content of the roll template is pressed to the left side, due the text segment on the Note-row. If that segment is removed, the content of the remaining rows will be closer to the center.

Here is a fairly close example of the default template's HTML& CSS with it's dependent CSS classes. If you intend to make your own roll template, or want to start from the default template, the best idea is to start with the code from Jakob's Better Default Template.

[edit] Examples

Some more examples using the default roll template. These should give more examples on how they can be used.


Roll template rolls that has inline labels, which will make it easier to look at the roll breakdown(when you hover your mouse over the result).

&{template:default} {{name=Mage Bolt}} {{attack=[[1d20+3[int]+2[proficiency] ]]}} {{Damage= [[3d6[base dmg]+3[int mod]+1d8[Elder Wand bonus] force dmg]]}} {{DC [[14]] Will Save= The enemy must make the save, or take an extra [[1d8]] fire dmg. }}

You can have rolls on both sides of the =

&{template:default} {{name=Greatsword of the Nomads}} {{attack= has advantage, pick higher result}} {{[[1d20+4]]=[[1d20+4]]}} {{Damage= [[2d6+2]]}} {{If critical= Apply only if attack is critical}} {{Crit damage= deals [[2d6]] more on crit}} {{Special Crit= The Greatsword of the Nomads deals on crit an extra [[1d8]] radiant damage, and the defender needs to make a DC [[14]] Con save or gain a level of exhaustion}}

Several attacks at a time

&{template:default} {{name=Fist of Fury}} {{Attack1= [[1d20+5]]}} {{Damage1= [[1d6+3]]}} {{Attack2= [[1d20+5]]}} {{Damage2= [[1d6+3]]}} {{Offhand= [[1d20+4]]}} {{Damage1= [[1d4+3]]}}

Short Rest Macro

It asks you how many to spend & what hit dice to use, and displays how much was recovered as well as how many where spent(using the Reusing Rolls-trick).

&{template:default} {{name=Short Rest}} {{Recover=  You heal [[ [[?{How many hit dice do you spend?|1}]]?{What's your Hit dice?|d4|d6|d8|d10|d12} ]] hit points, having spent $[[0]] of their hit dice.}}

Show Token info

Select a token on the map, and call this macro to get info on the token. If the token represents a character, it will show it's character_id & character_name, otherwise just show "selected|character_id" & "selected|character_name" if they are missing.

&{template:default} {{name=Token Info }} {{TokenID=@{selected|token_id} }} {{CharacterID=@{selected|character_id} }} {{TokenName=@{selected|token_name} }} {{characterName=@{selected|character_name} }} {{Bar1=@{selected|bar1} / @{selected|bar1|max} }} {{Bar2=@{selected|bar2} / @{selected|bar2|max} }} {{Bar3=@{selected|bar3} / @{selected|bar3|max} }} &{error}


[edit] D&D 5E by Roll20

Main Page: D&D 5e by Roll20 Roll Templates

The D&D 5E by Roll20-character sheet has 10 built in roll templates.


Example:

5e-rolltemplate-ex1-2021.png

Rolls stealth for selected npc token, using its stealth proficiency. Using the &{template:npcatk} template from it.

/w gm &{template:npcatk} {{attack=1}} {{name=Shadow}} {{rname=Shadow Stealth}} {{rnamec=Hide}} {{r1=[[@{selected|d20}+@{selected|npc_stealth} + 6]]}} {{always=1}} {{r2=[[@{selected|d20}+@{selected|npc_stealth} + 6]]}} {{description=While in dim light or darkness, the shadow can take the Hide action as a bonus action. Its stealth bonus is **also** improved to +6 }}

[edit] Pathfinder by Roll20

Main Page: Pathfinder by Roll20/Roll Templates

The Pathfinder by Roll20 character sheet has two different templates, one for PC (&{template:pc}) and one for NPC (&{template:npc}), that individually handles every types of roll.

They share mostly the same fields but are styled differently, and the NPC template handles attacks slightly differently. Otherwise, they generally can be used indifferently for macro purpose.

PF wiki Template.jpeg

Example with PC template:

&{template:pc} {{showchar=[[1]]}} {{charname=charname}} {{name=name}} {{type=ability}} {{roll=roll}} {{descflag=1}} {{desc=desc}} {{shownotes=[[1]]}} {{notes=notes}}

[edit] Creating a Roll Template

Main Page: Building Character Sheets/Roll_Templates

You can create & use custom Roll Templates by Editing/Building Character Sheets, as they are a part of the Character Sheet's code.

The main page details what parts & features goes into creating a roll template, along with showing the code for a number of existing Roll Templates.

[edit] See Also