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 "D&D 5E by Roll20/Roll Templates"

From Roll20 Wiki

Jump to: navigation, search
m
m (Attack: fix ammo)
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<div style="background:#f0e2a1; border: 3px solid #dbc870; padding: 10px;">
+
{{revdate}}{{HCbox| {{hc|articles/360037257834-D-D-5e-OGL-Roll-Templates Here}} }}
<big>'''''Attention:'''''
+
''Roll20 is no longer maintaining this document on the community wiki. For the Official Documentation please visit Roll20's Help Center: [https://roll20.zendesk.com/hc/en-us/articles/360037257834-D-D-5e-OGL-Roll-Templates Here].''</big>
+
</div>
+
  
 
[[File:5e-rollsexamples.png|right|thumbnail|350px| Example of a PC "Attack & Damage" roll, and a Spell outputted as a "spellcard"]]
 
[[File:5e-rollsexamples.png|right|thumbnail|350px| Example of a PC "Attack & Damage" roll, and a Spell outputted as a "spellcard"]]
Line 13: Line 10:
 
==General Notes==
 
==General Notes==
 
*Anything that says it toggles something off/on means that if you put anything after the "=", including a space, that feature is turned on, if there is nothing after the "=", then it is off.
 
*Anything that says it toggles something off/on means that if you put anything after the "=", including a space, that feature is turned on, if there is nothing after the "=", then it is off.
*The macros using <code>atk</code>, <code>simple</code>, <code>npcatk</code>, and <code>atkdmg</code> generated by the sheet utilize <code>@{rtype}</code> in place of <code><nowiki>{{always/normal/advantage/disadvantage=1}} {{r2=[[1d20]]}}</nowiki></code>. This attribute would allow you to link whether a second d20 is rolled or not to what the settings of your sheet are. Since <code><nowiki>@{rtype}</nowiki></code> translates to <code><nowiki>{{query=1}} {{<advantage|disadvantage|always|normal>=1}} {{r2=[[1d20]]}}</nowiki></code> you will need to add the closing brackets and any attack modifiers you want directly afterwards in order to match the first attack roll.
+
*The macros using <code>atk</code>, <code>simple</code>, <code>npcatk</code>, and <code>atkdmg</code> generated by the sheet utilize <code>@{rtype}</code> in place of <code><nowiki>{{always/normal/advantage/disadvantage=1}} {{r2=[[1d20]]}}</nowiki></code>. This attribute would allow you to link whether a second d20 is rolled or not to what the settings of your sheet are. Since <code><nowiki>@{rtype}</nowiki></code> translates to <code><nowiki>{{query=1}} {{<advantage|disadvantage|always|normal>=1}} {{r2=[[1d20</nowiki></code> you will need to add the closing brackets and any attack modifiers you want directly afterwards in order to match the first attack roll.
  
 
An example of such a macro would look like this: <code><nowiki>&{template:atkdmg} {{rname=rname}} {{attack=1}} {{r1=[[1d20+7 ]]}} @{rtype}+7]]}} {{damage=1}} {{dmg1flag=1}} {{dmg1=[[1d6+5]]}} {{dmg1type=dmg1type}} </nowiki></code> Note how  <code>@{rtype}</code> is followed by <code>+7]]}}</code> in order to match the original attack roll of 1d20+7.
 
An example of such a macro would look like this: <code><nowiki>&{template:atkdmg} {{rname=rname}} {{attack=1}} {{r1=[[1d20+7 ]]}} @{rtype}+7]]}} {{damage=1}} {{dmg1flag=1}} {{dmg1=[[1d6+5]]}} {{dmg1type=dmg1type}} </nowiki></code> Note how  <code>@{rtype}</code> is followed by <code>+7]]}}</code> in order to match the original attack roll of 1d20+7.
Line 32: Line 29:
 
normal
 
normal
 
| Toggle
 
| Toggle
| One of these four toggles can be set to determine whether one attack or check die is rolled (normal), both (always), both with the higher number grayed out (disadvantage), or both with the lower number grayed out (advantage).
+
| One of these four toggles can be set to determine whether one attack or check die is rolled ({{code|normal}}), both ({{code|always}}), both with the higher number grayed out ({{code|disadvantage}}), or both with the lower number grayed out ({{code|advantage}}). See[[#Simple]] for examples
 
|-
 
|-
 
| ammo
 
| ammo
Line 98: Line 95:
 
r2
 
r2
 
| Roll
 
| Roll
| The die to roll in order to determine if an attack or check succeeds.
+
| The two dice rolls determine if an attack or check succeeds.
 
|-
 
|-
 
| range
 
| range
Line 143: Line 140:
  
 
=== Simple ===
 
=== Simple ===
[[File:D&D_5E_OGL_Simple_Template.jpg|191px|right|none]]
+
[[File:5e-rolltemplate-simple2021.png|250px|right|none]]
<span style="font-weight:bold">Template</span>
+
'''Template'''
 
+
 
<code><nowiki>&{template:simple} {{rname=rname}} {{mod=mod}} {{r1=r1}} {{always=1}} {{r2=r2}} {{charname=charname}}</nowiki></code>
 
<code><nowiki>&{template:simple} {{rname=rname}} {{mod=mod}} {{r1=r1}} {{always=1}} {{r2=r2}} {{charname=charname}}</nowiki></code>
  
<span style="font-weight:bold">Character Sheet Examples</span>
+
'''Use'''
 +
* {{code|rname}}, {{code|mod}}, {{code|charname}} are all optional
 +
* In order for either of {{code|r1}} or {{code|r2}} sections to be shown, template must contain one of:
 +
** <code><nowiki>{{normal=1}}</nowiki></code>(shows only r1)
 +
** <code><nowiki>{{always=1}}</nowiki></code>(shows both)
 +
** <code><nowiki>{{advantage=1}}</nowiki></code>(highlights the better roll)
 +
** <code><nowiki>{{disadvantage=1}}</nowiki></code>(highlights the worse roll)
 +
 
 +
'''Character Sheet Uses'''
 
* Attribute Checks
 
* Attribute Checks
 
* Saving Throws
 
* Saving Throws
 
* Skill Checks
 
* Skill Checks
  
 
+
{{ex}}
<span style="font-weight:bold">Caveats</span>
+
<code><nowiki>&{template:simple} {{rname=Grapple}} {{mod=Dex}} {{advantage=1}} {{r1=[[d20+3[DEX]+2[WIS] ]]}} {{r2=[[d20+3[DEX]+2[WIS] ]]}} {{charname=Alice}}</nowiki></code>
* In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.
+
{{clear}}
<div style="clear: both"></div>
+
  
 
=== Attack ===
 
=== Attack ===
[[File:D&D_5E_OGL_Atk_Template.jpg|191px|right|none]]
+
[[File:5e-rolltemplate-atk2021.png|250px|right|none]]
 
<span style="font-weight:bold">Template</span>
 
<span style="font-weight:bold">Template</span>
  
<code><nowiki>&{template:atk} {{mod=mod}} {{rname=rname}} {{rnamec=rnamec}} {{r1=r1}} {{always=1}} {{r2=r2}} {{range=range}} {{desc=desc}} {{spelllevel=spelllevel}} ammo=ammo {{charname=charname}}</nowiki></code>
+
<code><nowiki>&{template:atk} {{mod=mod}} {{rname=rname}} {{rnamec=rnamec}} {{r1=r1}} {{always=1}} {{r2=r2}} {{range=range}} {{desc=desc}} {{spelllevel=spelllevel}} {{ammo=ammo}} {{charname=charname}}</nowiki></code>
  
 
<span style="font-weight:bold">Character Sheet Examples</span>
 
<span style="font-weight:bold">Character Sheet Examples</span>
Line 175: Line 178:
  
 
=== Damage ===
 
=== Damage ===
[[File:D&D_5E_OGL_Dmg_Template.jpg|191px|right|none]]
+
[[File:5e-rolltemplate-damage2021.png|250px|right|none]]
 
<span style="font-weight:bold">Template</span>
 
<span style="font-weight:bold">Template</span>
  
<code><nowiki>&{template:dmg} {{rname=rname}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit=1}} {{crit1=crit1}} {{crit2=crit2}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{hldmg=hldmg}} {{spelllevel=spelllevel}} ammo=ammo {{charname=charname}}</nowiki></code>
+
<code><nowiki>&{template:dmg} {{rname=rname}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit=1}} {{crit1=crit1}} {{crit2=crit2}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{hldmg=hldmg}} {{spelllevel=spelllevel}} {{ammo=ammo}} {{charname=charname}}</nowiki></code>
  
 
<span style="font-weight:bold">Character Sheet Examples</span>
 
<span style="font-weight:bold">Character Sheet Examples</span>
Line 191: Line 194:
  
 
=== Attack & Damage ===
 
=== Attack & Damage ===
[[File:D&D_5E_OGL_AtkDmg_Template.jpg|191px|right|none]]
+
[[File:5e-rolltemplate-atkdmg2021.png|250px|right|none]]
 
<span style="font-weight:bold">Template</span>
 
<span style="font-weight:bold">Template</span>
  
<code><nowiki>&{template:atkdmg} {{mod=mod}} {{rname=rname}} {{r1=r1}} {{always=1}} {{r2=r2}} {{attack=1}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit1=crit1}} {{crit2=crit2}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{hldmg=hldmg}} {{spelllevel=spelllevel}} ammo=ammo {{charname=charname}}</nowiki></code>
+
<code><nowiki>&{template:atkdmg} {{mod=mod}} {{rname=rname}} {{r1=r1}} {{always=1}} {{r2=r2}} {{attack=1}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit1=crit1}} {{crit2=crit2}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{hldmg=hldmg}} {{spelllevel=spelllevel}} {{ammo=ammo}} {{charname=charname}}</nowiki></code>
  
 
<span style="font-weight:bold">Character Sheet Examples</span>
 
<span style="font-weight:bold">Character Sheet Examples</span>
Line 208: Line 211:
  
 
=== Spell ===
 
=== Spell ===
[[File:D&D_5E_OGL_Spell_Template.jpg|210px|right|none]]
+
[[File:5e-rolltemplate-spell2021.png|250px|right|none]]
 
<span style="font-weight:bold">Template</span>
 
<span style="font-weight:bold">Template</span>
  
Line 272: Line 275:
 
|}<div style="clear: both"></div>
 
|}<div style="clear: both"></div>
  
 +
[[File:5e-rolltemplate-traits.png|225px|right|none]]
 +
<br>
 +
<br>
 
=== Traits ===
 
=== Traits ===
[[File:5e-rolltemplate-traits.png|200px|right|none]]
 
 
<code><nowiki>&{template:traits} {{name=Traits Name}} {{source=Source:Source type}} {{description=Trait description}}</nowiki></code>
 
<code><nowiki>&{template:traits} {{name=Traits Name}} {{source=Source:Source type}} {{description=Trait description}}</nowiki></code>
  
Line 284: Line 289:
 
<br>
 
<br>
 
<br>
 
<br>
 
+
<br>
 
=== NPC Action ===
 
=== NPC Action ===
[[File:D&D_5E_OGL_NpcAction_Template.jpg|200px|right|none]]
+
[[File:5e-rolltemplate-npcaction2021.png|250px|right|none]]
 
<span style="font-weight:bold">Template</span>
 
<span style="font-weight:bold">Template</span>
  
Line 300: Line 305:
  
 
=== NPC Attack ===
 
=== NPC Attack ===
[[File:D&D_5E_OGL_NpcAtk_Template.jpg|200px|right|none]]
+
[[File:5e-rolltemplate-npcatk2021.png|250px|right|none]]
 
<span style="font-weight:bold">Template</span>
 
<span style="font-weight:bold">Template</span>
  
Line 323: Line 328:
 
* NPC Actions that cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')
 
* NPC Actions that cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
 +
<br>
 +
=== MancerRoll ===
 +
[[File:Mancer-roll-template-ex1.png|200px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 +
<code><nowiki>&{template:mancerroll} {{title=title}} {{c1=[[1d20]]}} {{r1=r1}} {{r2=r2}} {{r3=r3}} {{r4=r4}} {{r5=r5}} {{r6=r6}} {{option1=option1}} {{option2=option2}} {{option3=option3}} {{option4=option4}} {{option5=option5}} {{option6=option6}} {{option7=option7}} {{option8=option8}} {{option9=option9}} {{option10=option10}} {{option11=option11}} {{option12=option12}} {{option13=option13}} {{option14=option14}} {{option15=option15}} {{option16=option16}} {{option17=option17}} {{option18=option18}} {{option19=option19}} {{option20=option20}}</nowiki></code>
 +
 +
<span style="font-weight:bold">Notes</span>
 +
* This template allows conditional display with up to 20 entries.
 +
* <nowiki>{{c1}} must be a dice roll. The result will determine which {{optionX}} field is displayed, from 1 to 20.</nowiki>
 +
* <nowiki>{{r1}} to {{r6}} are not conditional, and will always display if declared.</nowiki>
 +
* <nowiki>As with any roll template, all rolls will be executed even if not displayed. If {{option1}} to {{option20}} all contain sub-rolls, be prepared for many 3d dice to fly across your screen, even though only one result will display in the template.</nowiki>
 +
 +
<span style="font-weight:bold">Example</span><br>
 +
Display one result from four options:<br>
 +
<code><nowiki>&{template:mancerroll} {{title=DM wins!}} {{c1=[[1d4]]}} {{option1=The ceiling collapses and you all die.}} {{option2=The floor collapses and you all die.}} {{option3=The universe collapses and you all die.}} {{option4=You wake up and realise it was all a dream. Pay me for the session and get out of my Campaign.}}</nowiki></code>
 +
<div style="clear: both"></div>
 +
 +
=Examples=
 +
[[File:5e-rolltemplate-ex1-2021.png|200px|right|none]]
 +
Rolls stealth for selected npc token, using it's stealth proficiency.
 +
<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>
 +
 +
Health Potion:
 +
<code><nowiki>
 +
&{template:npcaction} {{rname=Healing Potion}} {{description=@{selected|character_name} takes a healing poition and regains [[2d4+ @{selected|level} [Level] + @{selected|constitution_mod} [Constitution Mod]]] hp!}}</nowiki></code>
  
 
=See Also=
 
=See Also=
* {{repo|Roll20/roll20-character-sheets/tree/master/DD5thEditionLegacy Sheet sourecode}} - The HTML file contains to code for how the roll templates are defined.
+
* {{repo|Roll20/roll20-character-sheets/tree/master/DD5thEditionLegacy Sheet sourecode (from 2019)}} - The HTML file contains to code for how the roll templates are defined. Even if the code is older and doesn't represent the current sheet, this should still mostly be accurate on how roll templates are defined.
 
* [[Roll Templates]] - general info on how roll templates work
 
* [[Roll Templates]] - general info on how roll templates work
 
* [[5E]] info on the other D&D 5E character sheets, that have their own roll templates that work differently
 
* [[5E]] info on the other D&D 5E character sheets, that have their own roll templates that work differently
Line 332: Line 363:
 
[[Category:DnD5E]]
 
[[Category:DnD5E]]
 
[[Category:Character Sheet Documentation]]
 
[[Category:Character Sheet Documentation]]
 +
[[Category:Roll Templates]]

Revision as of 11:09, 8 September 2022

Attention: This page is community-maintained. For the official Roll20 version of this article, see the Help Center for assistance: Here .

Example of a PC "Attack & Damage" roll, and a Spell outputted as a "spellcard"

Main Page: D&D 5E by Roll20

There are 10 roll templates provided by the D&D 5E by Roll20-character sheet.

See also the D&D5E by Roll20 NPC Attributes-page.

Contents

General Notes

  • Anything that says it toggles something off/on means that if you put anything after the "=", including a space, that feature is turned on, if there is nothing after the "=", then it is off.
  • The macros using atk, simple, npcatk, and atkdmg generated by the sheet utilize @{rtype} in place of {{always/normal/advantage/disadvantage=1}} {{r2=[[1d20]]}}. This attribute would allow you to link whether a second d20 is rolled or not to what the settings of your sheet are. Since @{rtype} translates to {{query=1}} {{<advantage|disadvantage|always|normal>=1}} {{r2=[[1d20 you will need to add the closing brackets and any attack modifiers you want directly afterwards in order to match the first attack roll.

An example of such a macro would look like this: &{template:atkdmg} {{rname=rname}} {{attack=1}} {{r1=[[1d20+7 ]]}} @{rtype}+7]]}} {{damage=1}} {{dmg1flag=1}} {{dmg1=[[1d6+5]]}} {{dmg1type=dmg1type}} Note how @{rtype} is followed by +7]]}} in order to match the original attack roll of 1d20+7.

  • The roll templates have a hard-coded size and will not scale if the chat pane is resized or (with the exception of the description fields and fields in the NPC templates) if a field's contents are larger than the field's space in the template output.

Common Fields

Many of the fields used by the roll templates are common to all or most of the roll templates. See the example templates below to see which of the following fields a given template uses.

Field Value Type Expected Value
advantage

always disadvantage normal

Toggle One of these four toggles can be set to determine whether one attack or check die is rolled (normal), both (always), both with the higher number grayed out (disadvantage), or both with the lower number grayed out (advantage). See#Simple for examples
ammo Text The name of the ammunition that the attack should spend. (See ammunition tracking.)
attack Toggle Whether or not the attack section of the template is shown.
charname Text The name of the character that generated this template.
crit Toggle Whether or not the critical damage result is shown.
crit1

crit2

Roll The damage die and modifiers to use on a critical success.
damage Toggle Whether or not the damage section of the template is shown.
desc

description

Text A description of the attack, spell or NPC ability.
dmg1

dmg2

Roll The damage die and modifiers to use.
dmg1flag

dmg2flag

Toggle Whether or not the damage result is shown.
dmg1type

dmg2type

Text The type of damage caused, such as "Bludgeoning" or "Poison".
hldmg Roll The additional damage die and modifiers to use when casting a spell at a higher level.
hldmgcrit Roll The damage die and modifiers to use on a critical success when casting a spell at a higher level.
mod Number The total of all modifiers to be added to an attack or check roll.
name Text The name of a spell or, in an NPC template, the name of the NPC that generated this template.
r1

r2

Roll The two dice rolls determine if an attack or check succeeds.
range Text The range of the attack, spell or NPC ability.
rname Text The name of the attack or NPC ability.
rnamec Text The name of the attack or NPC ability if it critically succeeds.
save Toggle Whether or not the save section of the template is shown.
saveattr Text The attribute that the target must roll a saving throw for.
savedc Text The DC that the target must beat with their saving throw.
savedesc Text The effect that occurs if the target succeeds their saving throw, such as "Half Damage".
spelllevel Number What level spell slot to expend when casting this spell. (See spell slot tracking.)

Roll Templates

Description

D&D 5E OGL Description Template.jpg

Template

&{template:desc} {{desc=desc}}

Simple

5e-rolltemplate-simple2021.png

Template &{template:simple} {{rname=rname}} {{mod=mod}} {{r1=r1}} {{always=1}} {{r2=r2}} {{charname=charname}}

Use

  • rname, mod, charname are all optional
  • In order for either of r1 or r2 sections to be shown, template must contain one of:
    • {{normal=1}}(shows only r1)
    • {{always=1}}(shows both)
    • {{advantage=1}}(highlights the better roll)
    • {{disadvantage=1}}(highlights the worse roll)

Character Sheet Uses

  • Attribute Checks
  • Saving Throws
  • Skill Checks


Example:

&{template:simple} {{rname=Grapple}} {{mod=Dex}} {{advantage=1}} {{r1=[[d20+3[DEX]+2[WIS] ]]}} {{r2=[[d20+3[DEX]+2[WIS] ]]}} {{charname=Alice}}

Attack

5e-rolltemplate-atk2021.png

Template

&{template:atk} {{mod=mod}} {{rname=rname}} {{rnamec=rnamec}} {{r1=r1}} {{always=1}} {{r2=r2}} {{range=range}} {{desc=desc}} {{spelllevel=spelllevel}} {{ammo=ammo}} {{charname=charname}}

Character Sheet Examples

  • Spells and Attacks that require to hit rolls (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')


Caveats

  • In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.
  • In order for the rname, rnamec and mod fields to be output, r1 and, if included, r2 must be a calculable roll value.
  • In order for ammo to be correctly expended, rname must exactly match the name of a weapon that uses the correct ammunition field, r1 must be a calculable roll value and charname must resolve to the exact name of a character sheet.

Damage

5e-rolltemplate-damage2021.png

Template

&{template:dmg} {{rname=rname}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit=1}} {{crit1=crit1}} {{crit2=crit2}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{hldmg=hldmg}} {{spelllevel=spelllevel}} {{ammo=ammo}} {{charname=charname}}

Character Sheet Examples

  • Spells and Attacks that cause damage, but do not require a to hit roll.


Caveats

  • In order for the hldmg section to be output, the hldmg field must be a calculable roll value.
  • In order for the spelllevel field to properly expend the correct spell slot, the dmg1 field must be a calculable roll value and charname must resolve to match the exact name of a character sheet.
  • In order for ammo to be correctly expended, rname must exactly match the name of a weapon that uses the correct ammunition field, r1 must be a calculable roll value and charname must resolve to the exact name of a character sheet.

Attack & Damage

5e-rolltemplate-atkdmg2021.png

Template

&{template:atkdmg} {{mod=mod}} {{rname=rname}} {{r1=r1}} {{always=1}} {{r2=r2}} {{attack=1}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit1=crit1}} {{crit2=crit2}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{hldmg=hldmg}} {{spelllevel=spelllevel}} {{ammo=ammo}} {{charname=charname}}

Character Sheet Examples

  • Spells and Attacks that require a to hit roll and cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Auto Roll Damage & Crit')


Caveats

  • In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.
  • In order for the hldmg section to be output, the hldmg field must be a calculable roll value.
  • In order for the spelllevel field to properly expend the correct spell slot, the dmg1 field must be a calculable roll value and charname must resolve to match the exact name of a character sheet.
  • In order for ammo to be correctly expended, rname must exactly match the name of a weapon that uses the correct ammunition field, r1 must be a calculable roll value and charname must resolve to the exact name of a character sheet.

Spell

5e-rolltemplate-spell2021.png

Template

&{template:spell} {{level=school level}} {{name=name}} {{castingtime=castingtime}} {{range=range}} {{target=target}} {{v=1}} {{s=1}} {{m=1}} {{material=material}} {{duration=duration}} {{description=description}} {{athigherlevels=athigherlevels}} {{ritual=1}} {{concentration=1}} {{charname=charname}}

Character Sheet Examples

  • Spells with 'Output' set to 'Spellcard'.


Caveats

  • In order for the level field to properly expend the correct spell slot, the charname must resolve to match the exact name of a character sheet. (See spell slot tracking.)


Unique Fields

Field Value Type Expected Value
athigherlevels Text A description of the spell's effects when cast using higher level spell slots.
castingtime Text How many and what type of action casting this spell takes, such as '1 Action' or '1 Reaction'.
concentration Toggle Whether or not concentration is shown in the duration section.
duration Text How long the spell's effects lasts.
level Text The name of the spell's school followed by its spell level, such as "Divination 3".
m Toggle Whether or not the "M" for materials is shown in components section.
material Text The materials required to cast the spell.
ritual Toggle Whether or not the ritual cast option is shown.
s Toggle Whether or not the "S" for somatic is shown in components section.
target Text What the spells targets, such as "1 Friendly Creature".
v Toggle Whether or not the "V" for verbal is shown in components section.
5e-rolltemplate-traits.png



Traits

&{template:traits} {{name=Traits Name}} {{source=Source:Source type}} {{description=Trait description}}

  • Rolls from the Features&Traits section use this rolltemplate.
  • If Features & Traits are used, {{source=}}-section gets filled with the Source + Source Type, of the trait, which in the example is "Class" and "Rogue"








NPC Action

5e-rolltemplate-npcaction2021.png

Template

&{template:npcaction} {{attack=1}} {{damage=1}} {{dmg1flag=1}} {{dmg2flag=1}} {{name=name}} {{rname=rname}} {{r1=r1}} {{always=1}} {{r2=r2}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{crit1=crit1}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit2=crit2}} {{description=description}}

Character Sheet Examples

  • NPC Actions that require a to hit roll and cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Auto Roll Damage & Crit')


Caveats

  • In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.

NPC Attack

5e-rolltemplate-npcatk2021.png

Template

&{template:npcatk} {{attack=1}} {{name=name}} {{rname=rname}} {{rnamec=rnamec}} {{r1=r1}} {{always=1}} {{r2=r2}} {{description=description}}

Character Sheet Examples

  • NPC Actions that require a to hit roll. (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')


Caveats

  • In order for the rname field to be output, r1 and, if included, r2 must be a calculable roll value.
  • In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.

NPC Damage

D&D 5E OGL NpcDmg Template.jpg

Template

&{template:npcdmg} {{damage=1}} {{dmg1flag=1}} {{dmg2flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit=1}} {{crit1=crit1}} {{crit2=crit2}}

Character Sheet Examples

  • NPC Actions that cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')


MancerRoll

Mancer-roll-template-ex1.png

Template

&{template:mancerroll} {{title=title}} {{c1=[[1d20]]}} {{r1=r1}} {{r2=r2}} {{r3=r3}} {{r4=r4}} {{r5=r5}} {{r6=r6}} {{option1=option1}} {{option2=option2}} {{option3=option3}} {{option4=option4}} {{option5=option5}} {{option6=option6}} {{option7=option7}} {{option8=option8}} {{option9=option9}} {{option10=option10}} {{option11=option11}} {{option12=option12}} {{option13=option13}} {{option14=option14}} {{option15=option15}} {{option16=option16}} {{option17=option17}} {{option18=option18}} {{option19=option19}} {{option20=option20}}

Notes

  • This template allows conditional display with up to 20 entries.
  • {{c1}} must be a dice roll. The result will determine which {{optionX}} field is displayed, from 1 to 20.
  • {{r1}} to {{r6}} are not conditional, and will always display if declared.
  • As with any roll template, all rolls will be executed even if not displayed. If {{option1}} to {{option20}} all contain sub-rolls, be prepared for many 3d dice to fly across your screen, even though only one result will display in the template.

Example
Display one result from four options:
&{template:mancerroll} {{title=DM wins!}} {{c1=[[1d4]]}} {{option1=The ceiling collapses and you all die.}} {{option2=The floor collapses and you all die.}} {{option3=The universe collapses and you all die.}} {{option4=You wake up and realise it was all a dream. Pay me for the session and get out of my Campaign.}}

Examples

5e-rolltemplate-ex1-2021.png

Rolls stealth for selected npc token, using it's stealth proficiency. /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 }}

Health Potion: &{template:npcaction} {{rname=Healing Potion}} {{description=@{selected|character_name} takes a healing poition and regains [[2d4+ @{selected|level} [Level] + @{selected|constitution_mod} [Constitution Mod]]] hp!}}

See Also

  • Sheet sourecode (from 2019) - The HTML file contains to code for how the roll templates are defined. Even if the code is older and doesn't represent the current sheet, this should still mostly be accurate on how roll templates are defined.
  • Roll Templates - general info on how roll templates work
  • 5E info on the other D&D 5E character sheets, that have their own roll templates that work differently