Wiki

Clone wiki

5eShaped / Attributes and Macros List

See Referencing Attributes, Macros, and Repeating Sections for a general overview the information found here. For attributes/marcos remember that many should use @{NAME|..} or %{NAME|..} to ensure they are referenced properly.

Note. The character in the tables is not the | character so be aware if using copy-paste

For repeating sections, see ......

Sections


Header

Attribute(s) Macro Example Value Description and Usage
@{character_name} The name of the character
@{class_and_level} %{shaped_class} Bard 3 The class and levels of the character
@{background} %{shaped_background} The background of the character
@{race} %{shaped_race} The race of the character
@{alignment} %{shaped_alignment} The alignment of the character
@{xp}, @{xp_next_level} %{shaped_xp} The current xp and the needed xp to level

Core Tab (PC)

Ability Scores/Checks

Attribute(s) Macro Example Value Description and Usage
@{strength}, @{strength_mod}, @{strength_check_mod}, @{strength_check_mod_with_sign}, @{strength_check_formula} %{shaped_strength_check} The strength score of the character (strength), the modifier of that score (strength_mod), the modifier of the strength check (strength_check_mod), with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{dexterity}, @{dexterity_mod}, @{dexterity_check_mod}, @{dexterity_check_mod_with_sign}, @{dexterity_check_formula} %{shaped_dexterity_check} The dexterity score of the character (dexterity), the modifier of that score (dexterity_mod), the modifier of the dexterity check (dexterity_check_mod), with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{constitution}, @{constitution_mod}, @{constitution_check_mod}, @{constitution_check_mod_with_sign}, @{constitution_check_formula} %{shaped_constitution_check} The constitution score of the character (constitution), the modifier of that score (constitution_mod), the modifier of the constitution check (constitution_check_mod), with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{intelligence}, @{intelligence_mod}, @{intelligence_check_mod}, @{intelligence_check_mod_with_sign}, @{intelligence_check_formula} %{shaped_intelligence_check} The intelligence score of the character (intelligence), the modifier of that score (intelligence_mod), the modifier of the intelligence check (intelligence_check_mod), with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{wisdom}, @{wisdom_mod}, @{wisdom_check_mod}, @{wisdom_check_mod_with_sign}, @{wisdom_check_formula} %{shaped_wisdom_check} The wisdom score of the character (wisdom), the modifier of that score (wisdom_mod), the modifier of the wisdom check (wisdom_check_mod), with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{charisma}, @{charisma_mod}, @{charisma_check_mod}, @{charisma_check_mod_with_sign}, @{charisma_check_formula} %{shaped_charisma_check} The charisma score of the character (charisma), the modifier of that score (charisma_mod), the modifier of the charisma check (charisma_check_mod), with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.

Saving Throws

Attribute(s) Macro Example Value Description and Usage
@{strength_check_mod}, @{strength_check_mod_with_sign}, @{strength_check_formula} %{shaped_strength_saving_throw} The check_mod is the value added to the check before global bonus, with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{dexterity_check_mod}, @{dexterity_check_mod_with_sign}, @{dexterity_check_formula} %{shaped_dexterity_saving_throw} The check_mod is the value added to the check before global bonus, with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{constitution_check_mod}, @{constitution_check_mod_with_sign}, @{constitution_check_formula} %{shaped_constitution_saving_throw} The check_mod is the value added to the check before global bonus, with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{intelligence_check_mod}, @{intelligence_check_mod_with_sign}, @{intelligence_check_formula} %{shaped_intelligence_saving_throw} The check_mod is the value added to the check before global bonus, with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{wisdom_check_mod}, @{wisdom_check_mod_with_sign}, @{wisdom_check_formula} %{shaped_wisdom_saving_throw} The check_mod is the value added to the check before global bonus, with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.
@{charisma_check_mod}, @{charisma_check_mod_with_sign}, @{charisma_check_formula} %{shaped_charisma_saving_throw} The check_mod is the value added to the check before global bonus, with sign adds a + or - in front. The formula is the full formula added to a d20 for the roll.

Spells

The formula used in cantrip damage for scaling is [[ceil((@{level} + 2) / 6)]]

Attribute(s) Macro Example Value Description and Usage
@{spell_save_DC} shaped_spell_dc The spell saving throw DC for a caster’s spells
@{spell_to_hit} shaped_spell_attack The bonus to hit with a spell attack
@{spells_known} The number of spells known by the character (aka, how many spells are in the spell section)
@{spell_slots_lLEVEL} The current remaining spell slots the character has of a given level. Replace LEVEL with the appropriate number between 1-9
@{spell_slots_lLEVEL_calc} The base number of spell slots of the character automatically calculated based on spellcasting classes. Replace LEVEL with the appropriate number between 1-9. Not used with NPCs
@{spell_slots_lLEVEL_bonus} The bonus spell slots the character has for a given spell level.Replace LEVEL with the appropriate number between 1-9
@{spell_slots_lLEVEL⎮max} The total spell slots the character has of a given level. Replace LEVEL with the appropriate number between 1-9
@{spell_points} The current spell points the character has
@{spell_points⎮max} The maximum amount of spell points the character has
%{shaped_spells} Outputs a list of spells known and prepared with clickable buttons for each along with spell slots available

Armor

Attribute(s) Macro Example Value Description and Usage
@{base_ac} Base ac for unarmored

Weight

Attribute(s) Macro Example Value Description and Usage
@{weight_offense} The total weight of all items in the offense section currently equipped
@{weight_utility} The total weight of all items in the utility section currently equipped
@{weight_ammo} The weight of all carried ammo
@{weight_armor} The weight of all currently equipment armor
@{weight_equipment} The weight of all currently carried equipment
@{weight_coinage} The weight of the coins carried by the character
@{weight_per_coin} The weight to use per coin carried
@{weight_total} The total weight carried by the character by adding all the above sections together

Carrying Capacity

Attribute(s) Macro Example Value Description and Usage
@{carrying_capacity} The normal carrying capacity of the character
@{max_push_drag_lift} The total weight that the character can push, drag, or lift
@{encumbered} The amount of weight the character can carry before becoming encumbered if using variant encumbrance rules
@{heavily_encumbered} The amount of weight the character can carry before becoming heavily encumbered if using variant encumbrance rules
@{weight_multiplier} The number to multiply the base carrying weights by for a character that is larger, or smaller (or counts as) for the purpose of determining carrying weight
@{carrying_capacity_multiplier} The multiplier to use to determine carrying capacity based on strength
@{max_push_drag_lift_multiplier} The multiplier to use to determine the push, drag, or lift weight of a character based on strength
@{encumbered_multiplier} The multiplier to use to determine encumbered weight for the character based on strength
@{heavily_encumbered_multiplier} The multiplier to use to determine heavily encumbered weight for the character based on strength

Coinage

Attribute(s) Macro Example Value Description and Usage
@{cp} %{shaped_coinage_cp} The current amount of copper pieces the character has
@{sp} %{shaped_coinage_sp} The current amount of silver pieces the character has
@{ep} %{shaped_coinage_ep} The current amount of electrum pieces the character has
@{gp} %{shaped_coinage_gp} The current amount of gold pieces the character has
@{pp} %{shaped_coinage_pp} The current amount of platinum pieces the character has
@{total_gp} %{shaped_coinage_total_gp} The total value of all coins the character has in gold value

Speed

Attribute(s) Macro Example Value Description and Usage
@{speed} %{shaped_speed} The base movement speed of the character
@{speed_burrow} %{shaped_speed} The burrow speed of the character
@{speed_climb} %{shaped_speed} The climb speed of the character
@{speed_fly} %{shaped_speed} The fly speed of the character
@{speed_swim} %{shaped_speed} The swim speed of the character

Senses

Attribute(s) Macro Example Value Description and Usage
@{blindsight} %{shaped_senses} The range of the character's blindsight (if applicable)
@{darkvision} %{shaped_senses} The range of the character's darkvision (if applicable)
@{tremorsense} %{shaped_senses} The range of the character's tremorsense (if applicable)
@{truesight} %{shaped_senses} The range of the character's trusight (if applicable)

General

Attribute(s) Macro Example Value Description and Usage
@{inspiration} %{shaped_inspiration} Shows if a player has inspiration (value of 1) or not (value of 0)
@{pb} %{shaped_pb} The current proficiency bonus of the character
@{proficiencies} %{shaped_proficiencies} The proficiencies of the character
%{shaped_saving_throw} Outputs a lists of saves in chat with clickable ability command buttons as if the “Saving throws” text was clicked. Uses big text
%{shaped_ability_checks} Outputs a list of ability checks in chat with clickable ability command buttons as if the “Skills” text was clicked. Uses big text
@{languages} %{shaped_languages} The languages the character knows
@{AC} %{shaped_ac} The current AC of the character
@{initiative} %{shaped_initiative} The total initiative. The macros rolls initiative if a token is currently selected.
@{HP} @{HP⎮max} %{shaped_hp} The current and max HP of a character
@{temp_HP} %{shaped_temp_hp} The temp hp the character currently has
@{hd_dSIDES}, @{hd_dSIDES⎮max} %{shaped_hd_dSIDES} The number of hit dice the character has and the total they could have. Replace SIDES with the die type (d2,d4,d6,d8,d10,d12,d20)
@{death_saving_throw_successes} @{death_saving_throw_failures} %{shaped_death_saving_throw} The current number of successes and failures for death saving throws
@{personality_traits} %{shaped_personality_traits} The personality traits a character has
@{ideals} %{shaped_ideals} The ideals of the character
@{bonds} %{shaped_bonds} The bonds the character has in the world
@{flaws} %{shaped_flaws} The flaws of the character
@{damage_vulnerabilities} %{shaped_damage_vulnerabilities} The damage types the character is vulnerable to
@{damage_resistances} %{shaped_damage_resistances} The damage types the character is resistant to
@{damage_immunities} %{shaped_damage_immunities} The damage types the character is immune to
@{condition_immunities} %{shaped_condition_immunities} The conditions the character is immune to
@{exhaustion_level} %{shaped_conditions} The current level of exhaustion of the character

Core Tab (NPC)

Attribute(s) Macro Example Value Description and Usage
@{character_name} The name of the NPC
@{size} The size of the NPC
@{type} The creature type of the NPC
@{alignment} The alignment of the NPC
@{AC}, @{ac_notes} %{shaped_ac} The AC and any notes about the AC of the NPC(such as “natural armor” in notes)
@{initiative} %{shaped_initiative} The initiative of the NPC
@{HP}, @{HP⎮max} %{shaped_hp} The current HP and the max HP of the NPC
@{hit_dice}, @{hit_die}, @{hp_extra}, @{hp_formula} %{shaped_npc_hp} The number of hit dice that NPC has (hit_dice), the type of hit die (hit_die ex. D4, d6 etc.). The bonus to HP of the character (hp_extra) and the full formula for calculated the NPC’s health
@{speed} %{shaped_speed} The base movement speed of the character
@{speed_burrow} %{shaped_speed} The burrow speed of the character
@{speed_climb} %{shaped_speed} The climb speed of the character
@{speed_fly} %{shaped_speed} The fly speed of the character
@{speed_swim} %{shaped_speed} The swim speed of the character
@{ABILITY} @{ABILITY_mod} @{ABILITY_mod_with_sign} See Ability Scores/Checks
@{ABILITY_check_mod} @{ABILITY_check_mod_with_sign} @{ABILITY_check_formula} %{shaped_ABILITY_check} See Ability Scores/Checks
@{ABILITY_saving_throw_mod} @{ABILITY_saving_throw_mod_with_sign} %{shaped_ABILITY_saving_throw} See Saving Throws
@{damage_vulnerabilities} %{shaped_damage_vulnerabilities} The damage types the character is vulnerable to
@{damage_resistances} %{shaped_damage_resistances} The damage types the character is resistant to
@{damage_immunities} %{shaped_damage_immunities} The damage types the character is immune to
@{condition_immunities} %{shaped_condition_immunities} The conditions the character is immune to
@{blindsight} %{shaped_senses} The range of the character's blindsight (if applicable)
@{darkvision} %{shaped_senses} The range of the character's darkvision (if applicable)
@{tremorsense} %{shaped_senses} The range of the character's tremorsense (if applicable)
@{truesight} %{shaped_senses} The range of the character's trusight (if applicable)
@{languages} %{shaped_languages} The languages the NPC knows
@{challenge}, @{xp}, @{xp_readable} %{shaped_challenge} The challenge rating of the NPC, the xp the NPC is worth, and the xp as a more readable value (using comma separation)
@{pb} %{shaped_pb} The proficiency bonus of the NPC
@{legendary_action_amount} The number of legendary actions the NPC can take

Spells

The formula used in cantrip damage for scaling is [[ceil((@{spellcaster_level} + 2) / 6)]]

Attribute(s) Macro Example Value Description and Usage
@{spell_save_DC} shaped_spell_dc The spell saving throw DC for a caster’s spells
@{spell_to_hit} shaped_spell_attack The bonus to hit with a spell attack
@{spells_known} The number of spells known by the character (aka, how many spells are in the spell section)
@{spell_slots_lLEVEL} The current remaining spell slots the character has of a given level. Replace LEVEL with the appropriate number between 1-9
@{spell_slots_lLEVEL_calc} The base number of spell slots of the character automatically calculated based on spellcasting classes. Replace LEVEL with the appropriate number between 1-9. Not used with NPCs
@{spell_slots_lLEVEL_bonus} The bonus spell slots the character has for a given spell level.Replace LEVEL with the appropriate number between 1-9
@{spell_slots_lLEVEL⎮max} The total spell slots the character has of a given level. Replace LEVEL with the appropriate number between 1-9
@{spell_points} The current spell points the character has
@{spell_points⎮max} The maximum amount of spell points the character has
%{shaped_spells} Outputs a list of spells known and prepared with clickable buttons for each along with spell slots available
@{spellcaster_level} The level of spellcaster the NPC
@{caster_level} For the purpose for determining level for spells like cantrips. Replace @Longjiang Lv with @{caster_level} when using the cantrip formula for NPCs who have the spellcasting trait
@{spellcasting_class} The class the NPC gets its spells from

Character Tab

Appearance

Attribute(s) Macro Example Value Description and Usage
@{gender} The gender of the character
@{size} The size of the character
@{age} The age of the character
@{height} The height of the character
@{weight} The weight of the character
@{eyes} The eyes of the character (usually just color)
@{skin} The skin color of the character
@{hair} The hair color of the character
@{appearance} A description of the characters appearance

Other

Attribute(s) Macro Example Value Description and Usage
@{backstory} A notes section for the characters backstory
@{miscellaneous_notes} Additional notes relevant to the character
@{miscellaneous_notes_2} A secondary notes section for the character

Settings Tab

Miscelaneous

Attribute(s) Macro Example Value Description and Usage
@{medium_armor_max_dex} The maximum bonus to AC that can be gained from the character's dexterity modifier
@{base_dc} The base DC to use in saving throw DC calculations (default 8)

Custom Gold Values

Attribute(s) Macro Example Value Description and Usage
@{copper_per_gold} Copper per gold
@{silver_per_gold} Silver per gold
@{electrum_per_gold} Electrum per gold
@{platinum_per_gold} Platinum per gold

Measurement System

Attribute(s) Macro Example Value Description and Usage
@{encumberance_multiplier} A multiplier to the encumbered and heavily encumbered weights only

Quick Chat Macros

Attribute(s) Macro Example Value Description and Usage
%{shaped_saving_throw_query} A query to roll a chosen saving throw as normal.
%{shaped_saving_throw} Outputs a lists of saves in chat with clickable ability command buttons. Uses settings from the settings page
%{shaped_ability_checks_query} A query to roll a chosen ability check as normal
%{shaped_ability_checks} Outputs a list of ability checks in chat with clickable ability command buttons. Uses settings from the settings page
%{shaped_traits} Outputs a list of traits of the character in chat with clickable ability command buttons
%{shaped_offense} Outputs a list of offense items from the character in chat with clickable ability command buttons
%{shaped_utility} Outputs a list of utility items from the character in chat with clickable ability command buttons
%{shaped_spells} Outputs a list of spells with clickable ability command buttons of the spells known by the character. Uses the settings from the settings page

NPC Only Macros

Attribute(s) Macro Example Value Description and Usage
%{shaped_statblock} Outputs a statblock of the NPC in chat with clickable ability command buttons for actions, skills, traits, etc
%{shaped_actions} Outputs a list of the NPCs actions as clickable ability command buttons
%{shaped_reactions} Outputs a list of NPC reactions as clickable ability command buttons
%{shaped_legendaryactions} Outputs a list of the NPCs legendary actions as clickable ability command buttons
%{shaped_lairactions} Outputs a list of Lair actions of the NPC as clickable ability command buttons
%{shaped_regionaleffects} Outputs a list of the NPCs regional effects as clickable ability command buttons

Misc Hidden Fields

General Hidden Fields

Attribute(s) Macro Example Value Description and Usage
@{level} The total level of the character for all classes. Useful for total level based abilities such as cantrip damage
@{ability_checks_macro_var} Pre-done ability command buttons for all ability checks of an character. Use in custom macros such as {{text_big=@{NAME⎮ability_checks_macro_var}}
@{saving_throw_macro_var} Pre-done ability command buttons for all saving throws of an character. Use in custom macros such as {{text_big=@{NAME⎮saving_throw_macro_var}}
@{traits_macro_var} Pre-done ability command buttons for all the traits of an character. Use in custom macros such as {{text_big=@{NAME⎮traits_macro_var}}

NPC Only Hidden Fields

Attribute(s) Macro Example Value Description and Usage
@{actions_macro_var} Pre-done ability command buttons for all the actions of an NPC. Use in custom macros such as {{text_big=@{NAME⎮actions_macro_var}}
@{reactions_macro_var} Pre-done ability command buttons for all the reactions of an NPC. Use in custom macros such as {{text_big=@{NAME⎮reactions_macro_var}}
@{legendaryactions_macro_var} Pre-done ability command buttons for all the legendary actions of an NPC. Use in custom macros such as {{text_big=@{NAME⎮legendaryactions_macro_var}}
@{lairactions_macro_var} Pre-done ability command buttons for all the lair actions of an NPC. Use in custom macros such as {{text_big=@{NAME⎮lairactions_macro_var}}
@{regionaleffects_macro_var} Pre-done ability command buttons for all the regional effects of an NPC. Use in custom macros such as {{text_big=@{NAME⎮regionaleffects_macro_var}}

Repeating Fields

PC Repeating Fields

Below is a table of the repeating sections that exist on the PC sheet and the name of the section and macro to use in macros such as SECTION and MACRO in %{NAME|repeating_SECTION_ID_MACRO}

Repeating Section SECTION MACRO
Skills skill skill
Offense offense roll
Utility utility roll
Ammo ammo ammo
Features & Traits trait trait
Spells spell spell
Armor armor armor
Equipment equipment equipment
Class class
Attacher attacher

Repeating Field Attributes

Belows are lists of the attributes that can be referenced from each repeated section. Replace ATTRIBUTE in @{NAME|repeating_SECTION_ID_ATTRIBUTE} with what is found in the attribute column to reference that attribute of an item in a given repeating section.

Skills

Example format:

Attribute: @{NAME|repeating_skill_ID_ATTRIBUTE}

Macro: %{NAME|repeating_skill_ID_roll}

Passive Macro: %{NAME|repeating_skill_ID_passive}

Attribute Description and Usage
name The name of the skill
proficiency The level of proficiency of the character, returns a string of unproficient, proficient, or expertise
bonus The bonus the character has to a given skill
formula The full formula that is added to the skill roll
total The total value added to the roll without a sign
total_with_sign The total value that is added to the skill check, has a "+" or "-" in front of the value so one does not need to be added if adding it
passive The passive score of the skill

Offense

Example format:

Attribute: @{NAME|repeating_offense_ID_ATTRIBUTE}

Macro: %{NAME|repeating_offense_ID_attack}

For the attack and saving throw fields, see the General Repeating Fields section

Attribute Description and Usage
name The name of the attack
uses The current number of remaining uses of the attack
uses⎮max The maximum amount uses for the attack
per_use The number of “charges” to use (aka the number of usages per use)
recharge When the current number of uses recharges
content A text field for a description of the attack
Ammo
ammo_field_name The name of the ammo repeating section to use for the ammo
ammo_per_use The number of ammo used per attack
Other Fields
emote An emote for the attack
freetext The freetext of the attack, normally a full description of the attack if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding
qty The number carried, usually of the weapon
weight The weight of the attack

Ammo

Example format:

Attribute: @{NAME|repeating_ammo_ID_ATTRIBUTE}

Macro: %{NAME|repeating_ammo_ID_ammo}

Attribute Description and Usage
name The name of the ammo type
qty The quantity carried of the given ammo
weight The weight per piece of ammo

Feature and Traits

Racial Features

Example format:

Attribute: @{NAME|repeating_racialtraits_ID_ATTRIBUTE}

Macro: %{NAME|repeating_racialtraits_ID_roll}

Class Features

Example format:

Attribute: @{NAME|repeating_classfeature_ID_ATTRIBUTE}

Macro: %{NAME|repeating_classfeature_ID_roll}

Feats Example format:

Attribute: @{NAME|repeating_feat_ID_ATTRIBUTE}

Macro: %{NAME|repeating_feat_ID_roll}

Traits

Example format:

Attribute: @{NAME|repeating_trait_ID_ATTRIBUTE}

Macro: %{NAME|repeating_trait_ID_trait}

For the saving throw, Other Damage, and Heal fields, see the General Repeating Fields section

Attribute Description and Usage
name The name of the trait
uses The current number of remaining uses of the feature
uses⎮max The maximum amount uses for the ability
per_use The number of “charges” used per use
recharge The condition for the trait to recharge
Other
emote An emote for the trait
freetext The freetext of the trait, normally a full description of the trait if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding {{text=<Some text>}} will add the text to the roll template macro as if using custom macros

Spells

Example format:

Attribute: @{NAME|repeating_spellLEVEL_ID_ATTRIBUTE}

Macro: %{NAME|repeating_spellLEVEL_ID_spell}

Replace LEVEL with the level of the spell, use zero for cantrips so a value between 0-9

The formula used in cantrip damage for scaling is

[[ceil((@{level} + 2) / 6)]]

For the attack, saving throw, Other Damage, and Heal fields, see the General Repeating Fields section

Attribute Description and Usage
name The name of the spell
spell_level The level of the spell
ritual Denotes if the spell is a ritual
is_prepared Denoted if the spell is prepared
casting_time The casting time of the spell
range The range of the spells
components The components for casting the spell (V,S,M)
materials The materials needed to cast the spell
duration The duration of the spell
content The content of the spell, normally the description of the spell
higher_level Text saying what the spell does at higher levels
Other
emote An emote for the trait
freetext The freetext of the trait, normally a full description of the attack if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding {{text=<Some text>}} will add the text to the roll template macro as if using custom macros

Armor

Example format:

Attribute: @{NAME|repeating_armor_ID_ATTRIBUTE}

Macro: %{NAME|repeating_armor_ID_roll}

Attribute Description and Usage
name The name of the armor
uses The current number of uses remaining on the armor
uses⎮max The total number of uses for the armor
ac_total The total AC of the armor worn
weight The weight of the armor
type The type of the armor (Light, Medium, Heavy, etc.)
ac_base The base AC of the armor, the number before dex or the bonus to AC depending on armor type
ac_total The total AC of the armor (include base, bonus and DEX if appropriate)
strength_requirements The required strength score to use the armor without disadvantages
stealth If the armor gives disadvantage to stealth
content A description of the armor

Equipment

Example format:

Attribute: @{NAME|repeating_equipment_ID_ATTRIBUTE}

Macro: %{NAME|repeating_equipment_ID_roll}

Attribute Description and Usage
name The name of the equipment entry
uses The current number of uses remained for the equipment
uses⎮max The maximum number of uses for the equipment
qty The quantity of the equipment carried
weight The weight of the equipment
weight_total The total weight of all of the given equipment carried (qty * weight)
content A description of the equipment

Class

Example format:

Attribute: @{NAME|repeating_class_ID_ATTRIBUTE}

Macro: none

Attribute Description and Usage
name The name of the class
level The level of the class
hd The hit dice type the class uses (d6,d8,d10,etc.)
spellcasting The type of spellcasting of the class (none, full, half, third, or warlock)
custom_name The name of the custom class
*Level: The level of a class can be accessed with a secondary method not involving repeating sections. To access this level, use the format @{NAME⎮CLASS_level} . Example: to add the level of fighter to say a second wind roll, use @{NAME⎮fighter_level}.

Attachers

Example format:

Attribute: @{NAME|repeating_attacher_ID_ATTRIBUTE}

Macro: none

Attribute Description and Usage
name The name of the attacher
freetext The freetext of the attacher, normally the description or important information to add to anything using the attacher
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding
Referencing attachers for a given option
attacher_ABILITY_check The attacher fields added to a given ability check (replace ABILITY with the name of the ability “strength, dexterity, etc.)
attacher_initiative The attacher fields added to the initiative
attacher_ABILITY_saving_throw The attacher fields added to abilities saving throw (replace ABILITY with the name of the ability “strength, dexterity, etc.)
attacher_death_saving_throw The attacher fields added to death saving throws
attacher_hit_dice The attacher fields added to hit dice rolls
attacher_offense The attacher fields added to offense
attacher_utility The attacher fields added to utility
attacher_spell The attacher fields added to spells
attacher_skill The attacher fields added to skill checks

NPC Repeating Fields

Below is a table of the repeating sections that exist on the NPC sheet and the name of the section to use in macros (as seen with SECTION in @{NAME|repeating_SECTION_ID_ATTR)) as well as if that section has a macro call

Repeating Section SECTION Macro
Skills skill Yes
Features & Traits trait Yes
Actions action Yes
Reactions reaction Yes
Legendary Actions legendaryaction Yes
Lair Actions lairaction Yes
Regional Effects regionaleffect Yes
Spells spell Yes

NPC Skills

See PC Skills

NPC Features and Traits

Example format:

Attribute: @{NAME|repeating_trait_ID_ATTRIBUTE}

Macro: %{NAME|repeating_trait_ID_trait}

For the attack, saving throw, Other Damage, and Heal fields, see the General Repeating Fields section

Attribute Description and Usage
name The name of the trait
uses The current number of remaining uses of the feature
uses⎮max The maximum amount uses for the ability
per_use The number of “charges” used per use
recharge The condition for the trait to recharge
Other
emote An emote for the trait
freetext The freetext of the trait, normally a full description of the trait if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding {{text=<Some text>}} will add the text to the roll template macro as if using custom macros

NPC Actions and Reactions

Actions Example format:

Attribute: @{NAME|repeating_action_ID_ATTRIBUTE}

Macro: %{NAME|repeating_action_ID_roll}

Reactions

Example format:

Attribute: @{NAME|repeating_reaction_ID_ATTRIBUTE}

Macro: %{NAME|repeating_reaction_ID_roll}

For the attack, saving throw, Other Damage, and Heal fields, see the General Repeating Fields section

Attribute Description and Usage
name The name of the attack
uses The current number of remaining uses of the attack
uses⎮max The maximum amount uses for the attack
per_use The number of “charges” to use (aka the number of usages per use)
recharge When the current number of uses recharges
content A description of the action
Other
emote An emote for the attack
freetext The freetext of the attack, normally a full description of the attack if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding

Legendary Actions

Example format:

Attribute: @{NAME|repeating_legendaryaction_ID_ATTRIBUTE}

Macro: %{NAME|repeating_legendaryaction_ID_roll}

For the attack, saving throw, Other Damage, and Heal fields, see the General Repeating Fields section

Attribute Description and Usage
name The name of the attack
cost How much the actions costs of its possible legendary actions
content A description of the action
Other
emote An emote for the attack
freetext The freetext of the attack, normally a full description of the attack if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding

Lair Actions Regional Effects

Lair Actions

Example format:

Attribute: @{NAME|repeating_lairaction_ID_ATTRIBUTE}

Macro: %{NAME|repeating_lairaction_ID_roll}

Regional Effects

Example format:

Attribute: @{NAME|repeating_regionaleffect_ID_ATTRIBUTE}

Macro: %{NAME|repeating_regionaleffect_ID_roll}

Attribute Description and Usage
recharge When the action recharges
content A description of the action
Other
emote An emote for the attack
freetext The freetext of the attack, normally a full description of the attack if needed
freeform The freeform section of the ability. Freeform allows for adding sections to the macro as if using a custom macro. For example, adding

General Repeating Fields

Attack Fields

Damage Macro

%{NAME|repeating_SECTION_ID_attack_damage}

Crit Damage Macro

%{NAME|repeating_SECTION_ID_attack_damage_crit}

Attribute Description and Usage
Attack Roll
attack_type The type of the attack (Melee, ranged)
attack_ability The ability used for the attack roll
attack_bonus The bonus to the attack roll of the attack
to_hit The total to hit chance
range The range of the attack
attack_target The target of the attack
crit_range The critical range of the attack. A number equal to or higher than this value is a crit
Attack Damage
attack_damage_average The average damage of the attack’s main damage
attack_damage_dice The number of dice to roll for the damage
attack_damage_die The type of die to roll (d4,d6,d8 etc)
attack_damage_ability The ability used for added damage to the attack
attack_damage_bonus The bonus to add to the damage of the attack
attack_damage_crit The damage to add to a critical hit
attack_damage_type The damage type of the attack
attack_damage_second_damage_condition If there is a second damage to the attack, returns PLUS else it returns nothing
attack_second_damage_average The average of the attack’s secondary damage
attack_second_damage_dice The number of dice to roll for the damage
attack_second_damage_die The type of die to roll (d4,d6,d8 etc)
attack_second_damage_ability The ability used for added damage to the attack
attack_second_damage_bonus The bonus to add to the damage of the attack
attack_second_damage_crit The damage to add to a critical hit
attack_second_damage_type The damage type of the attack
Spell Only
attack_higher_level_dice The number of dice to roll per higher level slot above the main
attack_second_higher_level_dice The number of dice to roll per higher level slot above the main

Saving Throw Fields

Damage Macro

%{NAME|repeating_SECTION_saving_throw_damage}

Attribute Description and Usage
Saving Throw DC
saving_throw_vs_ability The ability uses to make the saving throw
saving_throw_ability The ability used to calculate the saving throw DC
saving_throw_bonus The bonus to the saving throw DC
saving_throw_dc The final total for the DC of the saving throw (the value is a single number which already adds prof, ability mod, and bonus together)
saving_throw_success What happens on a successful save (such as half damage)
Saving Throw Damage
saving_throw_damage_average The average damage done by the main damage of the save
saving_throw_damage_dice The number of dice to roll for the saving throw damage
saving_throw_damage_die The type of die to roll for the damage(d4,d6,d8 etc)
saving_throw_damage_ability The ability mod that is added to the damage
saving_throw_damage_bonus The bonus added to the saving throw damage
saving_throw_damage_type The type of damage the saving throw deals
saving_throw_second_damage_average The average damage done by the secondary damage of the save
saving_throw_second_damage_dice The number of dice to roll for the saving throw damage
saving_throw_second_damage_die The type of die to roll for the damage(d4,d6,d8 etc)
saving_throw_second_damage_ability The ability mod that is added to the damage
saving_throw_second_damage_bonus The bonus added to the saving throw damage
saving_throw_second_damage_type The type of damage the saving throw deals
Spell Only
saving_throw_higher_level_dice The number of dice to roll per level increase
saving_throw_second_higher_level_dice The number of dice to roll per level increase for the second damage

Other Damage Fields

Attribute Description and Usage
other_damage_average The average damage done by the main damage of the “other” damage
other_damage_dice The number of dice to roll for the other damage
other_damage_die The type of die to roll for the damage(d4,d6,d8 etc)
other_damage_ability The ability mod that is added to the damage
other_damage_bonus The bonus added to the other damage
other_damage_type The type of damage the other deals
other_second_damage_average The average damage done by the secondary damage of the other damage
other_second_damage_dice The number of dice to roll for the other damage
other_second_damage_die The type of die to roll for the damage(d4,d6,d8 etc)
other_second_damage_ability The ability mod that is added to the damage
other_second_damage_bonus The bonus added to the other damage
other_second_damage_type The type of damage the other damage deals
Spell Only
other_higher_level_dice The number of dice to roll per level increase
other_second_higher_level_dice The number of dice to roll per level increase

Heal

Attribute Description and Usage
heal_dice The number of dice to roll for the healing
heal_die The type of die to roll for the healing (d4,d6,d8, etc)
heal_ability The ability mod that is added to the healing roll
heal_bonus The bonus to add to the healing
heal_query_toggle Give you 0 or a query for a value to add to the heal roll
Spell Only
heal_higher_level_dice The number of dice to roll per level increase
higher_level_heal The flat bonus to add per level increase

Updated