Roll Formulas

To explore the data model within Foundry to find the properties detailed below, here are a few approaches:

• Select a token, then open up the dev tools (F12 on Win; ⌥⌘I on Mac), and paste this into the Console (or save it as a Script macro in your hotbar): console.log(canvas.tokens.controlled[0].actor.getRollData());

• Or: Install the "Autocomplete Inline Properties" module, to be able to just start typing in a supported field and have the available properties pop up (not all systems supported yet).

• Or: Right-click an actor in the sidebar and choose Export Data, which will get you a JSON file you can browse through. (This won’t contain any values that are derived at roll-time.)

Actor Properties

Abilities

@abilities.str - Strength

@abilities.dex - Dexterity

@abilities.con - Constitution

@abilities.int - Intelligence

@abilities.wis - Wisdom

@abilities.cha - Charisma

Note: Replace the * in the following formulas with the three-letter code from above.

@abilities.*.value - Ability score

@abilities.*.mod - Base ability modifier

@abilities.*.dc - Feature DC based on this ability, equals 8 + modifier

@abilities.*.bonuses.check - Formula for ability-specific check bonuses (applies to generic ability checks and saves that use this ability)

@abilities.*.checkBonus - Flat ability check bonus, combining ability-specific bonuses with global check bonuses

@abilities.*.checkProf - Ability check proficiency details

@abilities.*.save - Flat ability save modifier (without any dice bonuses)

@abilities.*.bonuses.save - Formula for ability-specific saving throw bonuses

@abilities.*.saveBonus - Flat ability save bonus, combining ability-specific bonuses with global save bonuses

@abilities.*.saveProf - Ability save proficiency details

Attributes

Armor Class

@attributes.ac.calc - Calculation mode that its used for determining attributes.ac.base

@attributes.ac.formula - Custom formula that will be used to determine attributes.ac.base if calc is set to custom

@attributes.ac.flat - Value that will be used as final value if flat calculation is set, or as base with natural calculation

@attributes.ac.armor - Base value of equipped armor or 10 if no armor is worn

@attributes.ac.dex - Actor's dexterity modifier capped by any max dexterity allowed by equipped armor

@attributes.ac.base - Base AC, result of the selected AC formula

@attributes.ac.shield - AC bonus provided by an equipped shield

@attributes.ac.bonus - Additional bonuses to AC provided by spells or magic items

@attributes.ac.cover - Any cover effects for the actor, must be set by active effects or modules

@attributes.ac.value - Final AC value, result of adding ac.base + ac.shield + ac.bonus + ac.cover

Attunement

@attributes.attunement.value - Number of currently attuned items

@attributes.attunement.max - Maximum number of attunement slots

Death Saves

@attributes.death.success & .failure - Death save successes & failures

Encumbrance

Hit Points

@attributes.hp.min & .max - Minimum & maximum hit points (not including any changes from temporary max)

@attributes.hp.value - Current hit points (not including temp)

@attributes.hp.temp - Temporary hit points

@attributes.hp.tempmax - Temporary changes to max hit points

Initiative

@attributes.init.mod - Actor's base initiative modifier

@attributes.init.prof - Initiative proficiency details

@attributes.init.bonus - Any extra arbitrary bonus (active effects or the initiative config window)

@attributes.init.total - Final initiative modifier

Movement

@attributes.movement.burrow -

@attributes.movement.climb -

@attributes.movement.fly -

@attributes.movement.swim -

@attributes.movement.walk -

@attributes.movement.units -

@attributes.movement.hover -

Senses

@attributes.senses.blindsight -

@attributes.senses.darkvision -

@attributes.senses.tremorsense -

@attributes.senses.truesight -

@attributes.senses.units -

@attributes.senses.special -

Other Attributes

@attributes.exhaustion - Current exhaustion level

@attributes.hd - Currently available hit dice

@attributes.inspiration - Whether the actor has inspiration

@attributes.prof - Base, numerical proficiency value (does not reflect options like Proficiency Dice)

@attributes.spellcasting - Spellcasting ability (three-letter code, not the modifier)

@attributes.spelldc - Spell save DC based on the selected spellcasting ability

@attributes.spellmod - Base ability modifier for the actor's selected spellcasting ability

Bonuses

Ability

@bonuses.abilities.check - Global ability check bonuses (added to base ability checks and skills checks)

@bonuses.abilities.save - Global ability save bonuses

@bonuses.abilities.skill - Global skill check bonuses

Attacks

@bonuses.msak - Melee spell attack

@bonuses.mwak - Melee weapon attack

@bonuses.rsak - Ranged spell attack

@bonuses.rwak - Ranged weapon attack

Note: Replace the * in the following formulas with the four-letter code from above.

@bonuses.*.attack - Global bonus to attack rolls

@bonuses.*.damage - Global bonus to damage rolls

Spell

@bonuses.spell.dc - Global bonus to spell save DC

Classes

Note: Replace the * in the following formulas with identifier specified on the class item.

@classes.*.levels -

@classes.*.hitDice -

@classes.*.hitDiceUsed -

@classes.*.isOriginalClass -

@classes.*.spellcasting.progression -

@classes.*.spellcasting.ability -

Currency

@bonuses.currency.pp, .gp, .sp, .ep, .cp - Amount of each type of current held by actor

Details

@details.level - Overall character level

@details.xp.value - Actor's total XP earned

@details.xp.min & .max - XP range for the actor's current level

@details.xp.pct - Progress towards the next level

Proficiency

@prof - Actor proficiency

@prof.term - Either flat proficiency value or dice, depending on whether "Proficiency Dice" settings is set in system settings

@prof.flat - Flat proficiency value, regardless of settings

@prof.dice - Dice-based proficiency value, regardless of settings

Resources

@resources.primary, .secondary, .tertiary - Three resource slots

Note: Replace the * in the following formulas with one of the slots above.

@resources.*.value -

@resources.*.max -

@resources.*.sr -

@resources.*.lr -

@resources.*.label -

Scale

Skills

@skills.acr - Acrobatics

@skills.ani - Animal Handling

@skills.arc - Arcana

@skills.ath - Athletics

@skills.dec - Deception

@skills.his - History

@skills.ins - Insight

@skills.itm - Intimidation

@skills.inv - Investigation

@skills.med - Medicine

@skills.nat - Nature

@skills.prc - Perception

@skills.prf - Performance

@skills.per - Persuasion

@skills.rel - Religion

@skills.stl - Slight of Hand

@skills.ste - Stealth

@skills.sur - Survival

Note: Replace the * in the following formulas with the three-letter code from above.

@skills.*.ability - Three letter code for the ability associated with this skill by default

@skills.*.mod - Ability modifier from the default ability

@skills.*.prof - Skill proficiency details

@skills.*.bonuses.check - Bonus formula for this skill's modifier

@skills.*.bonus - Flat skill check bonus, combining skill-specific bonus, ability check bonus, and global skill bonus

@skills.*.total - Total skill check modifier (without any dice bonuses)

@skills.*.bonuses.passive - Bonus formula for this skill's passive score (cannot contain dice)

@skills.*.passive - Passive skill value equalling 10 + total + bonuses.passive

Spells

@spells.spell1, .spell2, .spell3, etc. - Normal spell slot levels

@spells.pact - Pact slots

Note: Replace the * in the following formulas with one of the spell slots above.

@spells.*.value - The currently available slots at this level

@spells.*.max - Maximum number of slots at this level

@spells.*.override - This value overrides the calculated max slots

@spells.*.level - Spell slot level (for pact slots only)

Traits

@traits.size - Actor size