Wiki
Clone wiki5eShaped / 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 {{text=<Some text>}} will add the text to the roll template macro as if using custom macros |
| 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 {{text=<Some text>}} will add the text to the roll template macro as if using custom macros |
| 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 {{text=<Some text>}} will add the text to the roll template macro as if using custom macros |
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 {{text=<Some text>}} will add the text to the roll template macro as if using custom macros |
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 {{text=<Some text>}} will add the text to the roll template macro as if using custom macros |
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