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

From Roll20 Wiki

Jump to: navigation, search
 
(95 intermediate revisions by 4 users not shown)
Line 1: Line 1:
There are 9 [[Roll Templates|roll templates]] provided by the [[5th Edition OGL by Roll20|5e OGL character sheet by Roll20]]:
+
There are 9 [[Roll Templates|roll templates]] provided by the [[5th Edition OGL by Roll20|D&D 5e OGL character sheet by Roll20]].
 +
 
 +
==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 <nowiki>{{always/normal/advantage/disadvantage=1}} {{r2=[[1d20</nowiki>. This attribute would allow you to link whether a second d20 is rolled or not to what the settings of your sheet are.
 +
*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.
 +
 
 +
==Style Differences==
 +
The D&D 5e OGL sheet has different styling depending on if you are using it in a custom D&D 5e game or in a game started from a module (such as Lost Mines of Phandelver or Storm King's Thunder). These styling differences extend to the output of the roll templates, but do not change the syntax described below for using the roll template.
 +
 
 +
==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.
 +
 
 
{| class="wikitable"
 
{| class="wikitable"
 +
! style="font-weight: bold;" | Field
 +
! style="font-weight: bold;" | Value Type
 +
! style="font-weight: bold;" | Expected Value
 
|-
 
|-
! Template !! Sheet Roll Example !! Formatting Notes
+
| 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).
 
|-
 
|-
| &{template:desc} || None ||
+
| ammo
 +
| Text
 +
| The name of the ammunition that the attack should spend. (See [[5th_Edition_OGL_by_Roll20#Automatic_Ammunition_Tracking|ammunition tracking]].)
 
|-
 
|-
| &{template:simple} || PC Ability/Skill Checks ||
+
| attack
 +
| Toggle
 +
| Whether or not the attack section of the template is shown.
 
|-
 
|-
| &{template:atk} || PC attack when autoroll damage is off || Formats command buttons as hyperlink text
+
| charname
"rname"/"rnamec" fields do not show up if there is no inline roll in r1 or r2
+
| Text
Inline rolls in the description field are formatted to take up an entire line with a yellow bar.
+
| The name of the character that generated this template.
 
|-
 
|-
| &{template:dmg} || PC damage roll || Description, rname, and charname fields are shown based on toggles
+
| crit
 +
| Toggle
 +
| Whether or not the critical damage result is shown.
 
|-
 
|-
| &{template:atkdmg} || PC attack when autoroll damage is on ||
+
| crit1
 +
crit2
 +
| Roll
 +
| The damage die and modifiers to use on a critical success.
 
|-
 
|-
| &{template:spell} || PC spell not marked as an attack || Component label is displayed regardless of output options
+
| damage
 +
| Toggle
 +
| Whether or not the damage section of the template is shown.
 
|-
 
|-
| &{template:npcaction} || Generic NPC action ||
+
| desc
 +
description
 +
| Text
 +
| A description of the attack, spell or NPC ability.
 
|-
 
|-
| &{template:npcatk} || NPC attack || Formats command buttons as hyperlink text
+
| dmg1
 +
dmg2
 +
| Roll
 +
| The damage die and modifiers to use.
 
|-
 
|-
| &{template:npcdmg} || NPC dmg roll ||
+
| 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 die to roll in order to 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 [[5th_Edition_OGL_by_Roll20#Automatic_Spell_Slot_Tracking|spell slot tracking]].)
 
|}
 
|}
  
==Module Style Differences==
+
==Roll Templates==
The 5e OGL sheet has different styling depending on if you are using it in a custom 5e game or in a game started from a module (such as Lost Mines of Phandelver or Storm King's Thunder). These styling differences extend to the output of the roll templates, but do not change the syntax described below for using the roll template.
+
=== Description ===
 +
[[File:D&D_5E_OGL_Description_Template.jpg|191px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<nowiki>&{template:desc} {{desc=desc}}</nowiki><div style="clear: both"></div>
 +
 
 +
=== Simple ===
 +
[[File:D&D_5E_OGL_Simple_Template.jpg|191px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<nowiki>&{template:simple} {{rname=rname}} {{mod=mod}} {{r1=r1}} {{always=1}} {{r2=r2}} {{charname=charname}}</nowiki>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* Attribute Checks
 +
* Saving Throws
 +
* Skill Checks
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.
 +
<div style="clear: both"></div>
 +
 
 +
=== Attack ===
 +
[[File:D&D_5E_OGL_Atk_Template.jpg|191px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<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>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* Spells and Attacks that require to hit rolls (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* 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.
 +
<div style="clear: both"></div>
 +
 
 +
=== Damage ===
 +
[[File:D&D_5E_OGL_Dmg_Template.jpg|191px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<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>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* Spells and Attacks that cause damage, but do not require a to hit roll.
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* 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.
 +
<div style="clear: both"></div>
 +
 
 +
=== Attack & Damage ===
 +
[[File:D&D_5E_OGL_AtkDmg_Template.jpg|191px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<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>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* 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')
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* 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.
 +
<div style="clear: both"></div>
 +
 
 +
=== Spell ===
 +
[[File:D&D_5E_OGL_Spell_Template.jpg|210px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<nowiki>&{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}}</nowiki>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* Spells with 'Output' set to 'Spellcard'.
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* 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 [[5th_Edition_OGL_by_Roll20#Automatic_Spell_Slot_Tracking|spell slot tracking]].)
 +
 
 +
 
 +
<span style="font-weight:bold">Unique Fields</span>
 +
{| class="wikitable"
 +
! style="font-weight: bold;" | Field
 +
! style="font-weight: bold;" | Value Type
 +
! style="font-weight: bold;" | 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.
 +
|}<div style="clear: both"></div>
 +
 
 +
=== NPC Action ===
 +
[[File:D&D_5E_OGL_NpcAction_Template.jpg|200px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<nowiki>&{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}}</nowiki>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* NPC Actions that require a to hit roll and cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Auto Roll Damage & Crit')
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* In order for the r1 or r2 sections to be output, the normal | always | advantage | disadvantage field must be included.
 +
<div style="clear: both"></div>
 +
 
 +
=== NPC Attack ===
 +
[[File:D&D_5E_OGL_NpcAtk_Template.jpg|200px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<nowiki>&{template:npcatk} {{attack=1}} {{name=name}} {{rname=rname}} {{rnamec=rnamec}} {{r1=r1}} {{always=1}} {{r2=r2}} {{description=description}}</nowiki>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* NPC Actions that require a to hit roll. (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')
 +
 
 +
 
 +
<span style="font-weight:bold">Caveats</span>
 +
* 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.
 +
<div style="clear: both"></div>
 +
 
 +
=== NPC Damage ===
 +
[[File:D&D_5E_OGL_NpcDmg_Template.jpg|200px|right|none]]
 +
<span style="font-weight:bold">Template</span>
 +
 
 +
<nowiki>&{template:npcdmg} {{damage=1}} {{dmg1flag=1}} {{dmg2flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{dmg2=dmg2}} {{dmg2type=dmg2type}} {{crit=1}} {{crit1=crit1}} {{crit2=crit2}}</nowiki>
 +
 
 +
<span style="font-weight:bold">Character Sheet Examples</span>
 +
* NPC Actions that cause damage. (Sheet setting 'Auto Damage Roll' must be set to 'Don't Auto Roll Damage')
 +
<div style="clear: both"></div>
  
==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.
 
*mod: what goes in the mod field
 
*rname: what goes in the name field on a standard roll. Apparently does not work in custom atk template macros.
 
*rnamec: what goes in the name field on a critical roll. Apparently does not work in custom atk template macros.
 
*r1: the first roll
 
*always/advantage/disadvantage/normal*: formats for always rolling advantage/disadvantage, greying out the lower roll, greying out the higher roll, only rolling once respectively
 
*r2: the second roll. Not displayed if the normal toggle is on
 
*range: range of the action
 
*desc: attack description/text
 
*ammo: not an actual roll template field; see the [[5th Edition OGL by Roll20#Automatic Ammunition Tracking|ammunition tracking]] section of the 5e OGL wiki page.
 
*charname: adds the character’s name to the roll
 
*attack: toggles formatting for merging with an attack rolled without damage, has no effect in the atkdmg template
 
*damage: no apparent effect
 
*dmg1flag/dmg2flag: toggles appearance of the indicated damage field
 
*dmg1/dmg2: The damage roll
 
*dmg1type/dmg2type: The type of the corresponding damage
 
*save: Toggles the save DC area to be displayed/hidden.
 
*saveattr: What save the target needs to attempt
 
*savedesc: What happens on a save
 
*savedc: The DC of the save; the text “DC” is displayed regardless of what is entered
 
*description: description/text field in spell/NPC templates
 
==&{template:desc}==
 
[[File:OGL Description Template.png|200px|right|none]]<nowiki>&{template:desc} {{desc=DESCRIPTION}}</nowiki><div style="clear: both"></div>
 
==&{template:simple}==
 
[[File:OGL Simple Template.png|200px|right|none]]<nowiki>&{template:simple} {{rname=rname}} {{mod=mod}} {{r1=r1}} {{always=1}} {{r2=r2}} {{charname=charname}}</nowiki><div style="clear: both"></div>
 
==&{template:atk}==
 
[[File:OG atk template.png|200px|right|none]]<nowiki>&{template:atk} {{mod=mod}} {{rname=rname}} {{rnamec=rname}} {{r1=r1 [[1d20]]}} {{always=1}} {{r2=r2 [[1d20]]}} {{range=range}} {{desc=desc}} ammo=Fists {{charname=charname}}</nowiki><div style="clear: both"></div>
 
==&{template:dmg}==
 
[[File:OGL dmg template.png|200px|right|none]]<nowiki>&{template:dmg} {{rname=rname}} {{attack=0}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1 [[1d20]]}} {{dmg1type=dmg1type }} {{damage=1}} {{dmg2flag=1}} {{dmg2=dmg2 [[1d20]]}} {{dmg2type=dmg2type }} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} {{charname=charname}}</nowiki><div style="clear: both"></div>
 
==&{template:atkdmg}==
 
[[File:OGL atkdmg template.png|200px|right|none]]<nowiki>&{template:atkdmg} {{mod=+8}} {{rname=rname}} {{r1=r1}} {{always=1}} {{r2=r2}} {{attack=0}} {{range=range}} {{damage=1}} {{dmg1flag=1}} {{dmg1=dmg1}} {{dmg1type=dmg1type}} {{damage=1}} {{dmg2flag=1}} {{dmg2=dmg2}} {{dmg2type=dmg2type }} {{crit1=$[[6]]}} {{crit2=$[[7]]}} {{save=1}} {{saveattr=saveattr}} {{savedesc=savedesc}} {{savedc=savedc}} {{desc=desc}} ammo=ammo {{charname=charname}}</nowiki><div style="clear: both"></div>
 
==&{template:spell}==
 
[[File:OGL spell template.png|200px|right|none]]<nowiki>&{template:spell} {{level=Level }} {{name=name}} {{castingtime=castingtime}} {{range=range}} {{target=target}}{{v=1}} {{s=1}} {{m=1}} {{material=material}} {{duration=duration}} {{description=description}} {{athigherlevels=athigherlevels}} 0 {{concentration=1}} {{charname=charname}}</nowiki>
 
*target: populates the target field
 
*v/s/m: toggles showing/hiding V, S, M(and the specific material component) after the components label
 
*concentration: toggles show/hide of “concentration” in duration<div style="clear: both"></div>
 
==&{template:npcaction}==
 
[[File:OG npcaction template.png|200px|right|none]]<nowiki>&{template:npcaction} {{name=NAME}} {{rname=RNAME}} {{description=DESCRIPTION}} {{charname=CHARNAME}}</nowiki><div style="clear: both"></div>
 
==&{template:npcatk}==
 
[[File:OG npcatk template.png|200px|right|none]]<nowiki>&{template:npcatk} {{attack=1}} {{damage=1}} {{dmg1flag=1}} {{name=NAME}} {{rname=RNAME}} {{rnamec=RNAMEC}} {{r1=R1 [[1d20]]}} {{always=1}} {{r2=R2 [[1d20]]}} {{description=DESCRIPTION}} {{charname=CHARNAME}}</nowiki><div style="clear: both"></div>
 
==&{template:npcdmg==
 
[[File:OGL npcdmg template.png|200px|right|none]]<nowiki>&{template:npcdmg} {{damage=1}} {{dmg1flag=1}} {{dmg1=DMG1  [[1d20]]}} {{dmg1type=DMG1TYPE}} {{dmg2flag=1}} {{dmg2=DMG2  [[1d20]]}} {{dmg2type=DMG2TYPE}}</nowiki><div style="clear: both"></div>
 
==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 <nowiki>{{always/normal/advantage/disadvantage=1}} {{r2=[[1d20</nowiki>. This attribute would allow you to link whether a second d20 is rolled or not to what the settings of your sheet are.
 
*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.
 
  
[[Category:Tips]]
+
[[Category:DnD5E]]
 +
[[Category:Character Sheet Documentation]]

Latest revision as of 14:56, 25 June 2019

There are 9 roll templates provided by the D&D 5e OGL character sheet by Roll20.

Contents

[edit] 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.
  • 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.

[edit] Style Differences

The D&D 5e OGL sheet has different styling depending on if you are using it in a custom D&D 5e game or in a game started from a module (such as Lost Mines of Phandelver or Storm King's Thunder). These styling differences extend to the output of the roll templates, but do not change the syntax described below for using the roll template.

[edit] 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).
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 die to roll in order to 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.)

[edit] Roll Templates

[edit] Description

D&D 5E OGL Description Template.jpg

Template

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

[edit] Simple

D&D 5E OGL Simple Template.jpg

Template

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

Character Sheet Examples

  • Attribute Checks
  • Saving Throws
  • Skill Checks


Caveats

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

[edit] Attack

D&D 5E OGL Atk Template.jpg

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.

[edit] Damage

D&D 5E OGL Dmg Template.jpg

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.

[edit] Attack & Damage

D&D 5E OGL AtkDmg Template.jpg

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.

[edit] Spell

D&D 5E OGL Spell Template.jpg

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.

[edit] NPC Action

D&D 5E OGL NpcAction Template.jpg

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.

[edit] NPC Attack

D&D 5E OGL NpcAtk Template.jpg

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.

[edit] 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')