Damage mechanics

From Baldur's Gate 3 Wiki
Revision as of 22:58, 21 October 2023 by NtCarlson (talk | contribs) (Fixed line breaks in technical details section)
Jump to navigation Jump to search
1d4 + 1d6 Poison.png
A single attack, spell, trap, or other harmful effect can often result in multiple Damage Rolls. Determining the resulting damage from these various rolls can be difficult due to hidden mechanics which are commonly referred to by the community as damage "sources" and damage "riders". The term damage "instances" is sometimes used in place of damage "sources," but for the purpose of this page the only terms to be used are damage source(s) and damage rider(s). The game does not inform players what is a damage source vs. what is a damage rider, or how these two interact with each other. This page describes the mechanical differences between damage sources and damage riders, how they interact, and lists which effects and abilities fall into each category.

Damage Sources (DS) vs. Damage Riders (DR)

A damage source could be described as what initializes the damage. Examples include striking a target with your weapon, a spell, or thrown items such as an Alchemist's Fire. Damage sources often require the use of an action (e.g. throwing an object such as a grenade), bonus action (e.g. making an attack with your offhand weapon while dual wielding), or reaction (e.g. the Hellish Rebuke Hellish Rebuke spell).

A damage rider is something which adds additional damage onto the damage source. It can only be present in the event there is an applicable damage source for it to "ride along" with, hence the name of a damage rider. Examples of damage riders include the Hex Hex spell adding damage to the damage from a Warlock's Eldritch Blast Eldritch Blast or weapon attacks, coatings applied to weapons providing additional damage to a weapon attack, a 6th level Draconic Bloodline Sorcerer applying their elemental affinity to a spell of the appropriate damage type, or a ragingBarbarian adding rage damage to their weapon attacks. Many damage riders are gained from passives or other forms of buffs. Any eligible damage riders from a damaging effect will be applied to a damage source which is a part of that damaging effect.

Damage Riders treated as Damage Sources (DRS)

There are some damage riders which defy the typical trends described above. They still must "ride along" with a damage source in order to be applied, but when the damage is calculated they are treated as damage sources instead of damage riders. This means that these "damage riders which are treated as damage sources" can then cause normal damage riders to be applied once again as part of the same ability (e.g. attack or spell) which caused the damage.

Example Calculation

A character with 18 Strength, the Tavern Brawler Feat, Lightning Charges (Condition) Lightning Charges (Condition), and the Ring of Flinging uses the Returning Pike to make a thrown weapon attack against a target which is affected by Hex Hex.

Damage Sources (DS):

  • Thrown weapon attack using the Returning Pike applies 1d10 (damage die) + 1 (weapon enchantment) + 4 (Strength modifier) piercing damage

Damage Riders (DR):

  • Lightning Charges (Condition) Lightning Charges (Condition) add +1 Lightning Damage to each damage source
  • The Ring of Flinging adds 1d4 damage which is of the same type as the weapon used (piercing in this example) to each damage source.
  • Hex Hex adds 1d6 necrotic damage to each damage source.

Damage Riders treated as Damage Sources (DRS):

  • The Tavern Brawler feat allows characters to add their Strength modifier an additional time to damage rolls when using unarmed strikes, improvised weapons, or thrown weapons. When applied to melee attacks this damage bonus is treated as a damage rider. But as of Patch 3 with thrown weapons, this +4 piercing damage from the character's strength score being applied a second time due to the tavern brawler feat being treated as a damage source.


Calculating total damage:

To determine the total damage applied take each DS and DRS. Then apply the damage riders onto each of these. In this example that means one should evaluate the pike damage source plus all damage riders, followed by the Tavern Brawler damage source and all damage riders applied again.

Tavern Brawler on thrown weapon attacks is a DRS, meaning the damage roll in the above scenario would on average yield 28.5 total damage (ignoring resistances) calculated as follows:

As a hypothetical scenario to show the impact that this minor detail can have, instead imagine Tavern Brawler were to be treated as a DR in the above scenairo. In this hypothetical scenario the above damage roll would yield 21.5 total damage on average (ignoring resistances) calculated as follows:

DRS Effects

The following are a list of items and abilities which have DRS effects, and what the relevant DRS effect is.

Weapons
Item Act Found Relevant Effect Notes
Arrow of Acid All Deals Weapon Damage + 2d4Damage TypesAcid (Dexterity Save to negate). Creates a permanent Acid Surface. N/a
Arrow of Fire All Deals weapon damage + 2d4Damage TypesFire (Dexterity Save to negate). Creates a Fire Surface for 2 turns. N/a
Arrow of Ice All Deals weapon damage + 2d4Damage TypesCold (Dexterity Save to negate). Creates an Ice Surface for 2 turns. N/a
Arrow of Lightning All Deals weapon damage + 2d4Damage TypesLightning (Dexterity Save to negate). N/a
Prepared (Condition) Prepared (Condition) All Spend 6 m / 20 ft of your movement to deal additional physical damage (minimum 1) on each successful weapon attack for the rest of the turn. Weapon Action available to all Greataxes. Recharges on Short Rest
Assassin's Touch One Deathly Slumber: Deals an additional 1d4 Damage TypesNecrotic damage to creatures that are  Knocked Out Knocked Out or Sleeping Sleeping . N/a
Hoppy: Revitalising Strike One Revitalising Strike: Smash into a foe, wounding them and healing your own injuries. On a hit, heal 1d6hit points. You deal additional  Damage TypesNecrotic damage equal to your Proficiency Bonus. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Very Heavy Greataxe: Gargantuan Cleave One or Two Gargantuan Cleave: Swing your weapon with all your might. You can attack multiple targets, but become Off Balance Off Balance. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
The Undead Bane: Profane Scourge Three Profane Scourge: Strike with subjugating fury, adding your Proficiency Bonus to the damage roll. If you hit a Fiend or Undead creature, deal an additional 2d6Damage TypesSlashing damage and possibly Bane Bane it. Undead and Constructs can't Bleed Bleed. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest. This weapons special bonus damage vs undead and fiends is applied to both the weapons base damage and the damage applied by the Profane Scourge weapon action.
The Sacred Star: Dawnburst Strike Three Dawnburst Strike: Deal additional Damage TypesRadiant damage equal to your Proficiency Bonus. On a hit, light erupts around you in a 3m / 10ft area. Enemies in the light must succeed a DC 13 Constitution Saving Throw or be Blinded Blinded. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Soulbreaker Greatsword: Soulbreaker One Soulbreaker: Rend the enemy's body and soul, dealing an additional 4Damage TypesPsychic damage, and possibly Stun Stun them. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Silver Sword of the Astral Plane: Soulbreaker One or Three Soulbreaker: Rend the enemy's body and soul, dealing an additional 4Damage TypesPsychic damage, and possibly Stun Stun them. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Ritual Dagger: Blood Sacrifice One Blood Sacrifice: Pain is a path to power. Take 1d4Damage TypesSlashing damage to receive a +1d4 bonus to Attack Rolls and Saving Throws. Damage riders are applied to the self inflicted damage.
Loviatar's Scourge: Willing Whip One Willing Whip: Grants Resistance to Damage TypesNecrotic damage. Deals an additional 1d6Damage TypesNecrotic damage to nearby targets, including the wielder. This damage does not benefit from many damage riders that are applied to the base weapon attack. For instance when used as part of a smite attack, bonus damage applied to spells is not applied to the damage caused by the willing whip ability.
Shortsword of First Blood One Break the Unbroken: Deal an additional 1d8Damage TypesPiercing damage to targets that still have all their hitpoints. The target must be at full health.
Moonlight Glaive: Moonlight Butterflies Two Moonlight Butterflies: Strike a foe, conjuring an illusory swarm of moon-pale butterflies, gaining Advantage Icon.png Advantage on attacks against the target. Deal additional Damage TypesPsychic damage equal to your Proficiency Bonus. When the target moves away from your illusion, it takes 1d6Damage TypesPsychic damage. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Justiciar's Scimitar: Shadowsoaked Blow Two Shadowsoaked Blow: Strike an enemy, adding your Proficiency Bonus to the damage. Moreover, if the attack hits, it also deals an additional 1d6Damage TypesPsychic damage. This attack doesn't break concealment. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Punch-Drunk Bastard Three Tippler's Rage: When you have the Alcohol Alcohol condition, you have Advantage Icon.png Advantage on Attack Rolls. You also create a blast with each attack, dealing 1d4Damage TypesThunder damage for 3m / 10ft. This damage does not benefit from many damage riders that are applied to the base weapon attack. For instance when used as part of a smite attack, bonus damage applied to spells is not applied to the damage caused by the Tippler's Rage ability.
The Blast Pendant: Lightning Blast One Lightning Blast: Once per Long Rest you may focus the electricity in your veins as a bonus action. Your next lightning spell or cantrip deals additional Damage TypesLightning Lightning damage equal to your remaining Lightning Charges Lightning Charges. On a hit, all of your Lightning Charges are consumed. This is a usable once per long rest and only applies to Lightning Spells or cantrips.
Lightning Jabber Two Throwing: Lighting Damage: When launched at a target, deal an additional 1d4Damage TypesLightning damage. This is only works when thrown.
Nyrulna: Zephyr Connection Three Zephyr Connection: This weapon will return to your hand when thrown. You cannot be forced to drop the trident. When thrown, the weapon creates an explosion that deals 3d4Damage TypesThunder damage in a 6m/20ft blast centered on the target. This is only works when thrown.

This damage does not benefit from many damage riders that are applied to the base weapon attack.

Phalar Aluve: Shriek One All enemies within 6m of range have a 1d4 penalty to Charisma, Wisdom and Intelligence Saving Throws. Affected creatures receive an extra 1d4Damage TypesThunder damage. The sword will stop Shrieking if unequipped. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Dragon's Grasp: Burned Alive One Deals an additional 1d4Damage TypesSlashing damage to Burning Burning targets. Can apply multiple times.
Firestoker: Burned Alive One Deals an additional 1d4Damage TypesPiercing damage to Burning Burning targets. Can apply multiple times.
Exterminator's Axe: Scourge of Pets One Deals an additional 1d6Damage TypesFire damage to Plants, Insects or Small creatures. N/a
Deep Delver: Dig Deep One Inflicts Shattered on hit. When attacking a Shattered target, deal an additional 1d4Damage TypesPiercing damage. N/a
Blooded Greataxe: Relentless Revenge One When the wielder has 50% HP Icon.png hit points or less, they deal an additional 1d4Damage TypesSlashing damage. N/a
Sword of Life Stealing Two On a Critical Hit, the target takes an extra 10Damage TypesNecrotic damage as long as it isn't a construct or an undead. You also gain 10 temporary hit points. N/a
Render of Mind and Body: Psychic Steel Virtuoso Two When the wielder attacks with Advantage Icon.png Advantage, they deal an additional 1d8Damage TypesPsychic damage N/a
Stalker Gloves: Skullduggery Attack Three Your  Sneak Attack Sneak Attack deals an additional 1d4Damage TypesForce damage N/a
Craterflesh Gloves: Craterous Wounds Three Whenever you score a Critical Hit, deal an additional 1d6Damage TypesForce damage. N/a
Balduran's Giantslayer: Topple the Big Folk Three Deal additional damage equal to your Proficiency Bonus. On a hit, Large, Huge, or Gargantuan creatures take an additional 2d6Damage TypesSlashing damage and must suceed a Strength Saving Throw or fall Prone. This is a weapon action specific to this weapon. As with all weapon actions, it recharges on a short rest.
Crimson Mischief: Redvein Savagery Three (Only when wielded in main hand) When you make an attack with Advantage Icon.png Advantage, the target takes an additional 7Damage TypesPiercing damage. This applies for most damage sources in the base attack, It does not apply on some DRSs eg the ranger colossus slayer ability.
Duelist's Prerogative: Withering Cut Three (Only when wielded in main hand) On a hit with a melee weapon, use a reaction to deal additional Damage TypesNecrotic damage equal to your Proficiency Bonus. N/a
Class Abilities
Class Level

Obtained

Relevant Effect Notes
Rogue 1 Sneak Attack Sneak Attack: Deal an extra 1d6 damage to a foe you have Advantage against. You can also use Sneak Attack if you have an ally within 1.5m / 5ft of the target and you don't have Disadvantage. Sneak Attack is only treated as a damage source if you use the automatic reaction. Using the Sneak Attack action is instead treated as a damage rider.
Paladin 2 Divine Smite Divine Smite: Your weapon emanates divine might as you strike, dealing an additional 2d8Damage TypesRadiant damage. Deals an additional 1d8Damage TypesRadiant damage to Fiends and Undead. N/a
Hunter Ranger 3 Colossus Slayer Colossus Slayer: Once per turn, your weapon attack deals an extra 1d8Damage TypesPhysical damage if the target is below its hit point maximum This can be applied multiple times for each damage source in the portion of the attack that triggers it. This could include the entire attack or just portions of it.
Cleric 8 Divine Strike Divine Strike: Once per turn, deal 1d8 damage (damage type depends on Cleric Domain) in addition to your weapon's damage. The 1d8Damage TypesPhysical variant from War Domain Cleric is treated as a damage source only when triggered as a reaction. All other variants of Divine Strike Divine Strike work as damage sources either when used as a reaction or when used directly.
Way of Shadow Monk 11 Shadow Strike Shadow Strike: Teleport to a foe from a hidden position, striking them with the creeping, psychic ferocity of the shadows themselves, dealing an additional 3d8Damage TypesPsychic damage. N/a
Warlock 12 Lifedrinker Lifedrinker: Your melee attacks deal additional Necrotic equal to your Charisma modifier. N/a
Other Abilities
Ability Ability Type Relevant Effect Notes
Hunter's Mark Hunter's Mark 1st Level Spell Mark a creature as your quarry to deal an additional 1d6Damage TypesPhysical damage whenever you hit it with a weapon attack. Only when used with thrown weapon attacks.
Tavern Brawler Tavern Brawler Feat When you make an unarmed attack, use an improvised weapon, or throw something, your strength modifier is added twice to the damage and Attack Roll Only when used with thrown weapon attacks.

Technical details

The scripts defining all the effects in the game are found in .txt files inside Gustav.pak and Shared.pak. (See Modding:Unpacking and converting files). In these scripts, damage rider effects are implemented with one of several damage functions. These are:

  • WeaponDamage(), CharacterWeaponDamage(), and CharacterUnarmedDamage(): The basic, well-behaved damage bonuses are implemented with this function. The bonus will apply only to the triggering attack, and nothing else. Example effect: 2Damage TypesAcid from Caustic Band.
  • DamageBonus(): Damage riders using this function will apply their bonus damage to each independent damage instance. When combined with damage riders using DealDamage() (see below), a single attack can create numerous independent damage instances. In these cases, DamageBonus() will apply its bonus damage multiple times, but WeaponDamage() only once. Example effect: 2Damage TypesRadiant from Callous Glow Ring.
  • DealDamage(): This function is used by all damaging attacks, spells, and status effects to apply their damage. It is also used by "damage riders treated as damage sources" to apply their bonus damage. It creates a separate damage instance that can be independently boosted by applicable DamageBonus() effects. Furthermore, damage riders using DealDamage() can trigger each other in some cases, creating far more damage instances than might be expected. Example effect: 1d8Damage TypesPhysical from Colossus Slayer.

Each of these functions can optionally specify the damage type. If not specified, the damage type will be inherited from the triggering DealDamage() instance.

Potential bugs

The following items compose a non-exhaustive list which indicates that the "Damage Riders" as compared to "Damage Riders treated as Damage Sources" may include several bugs and therefore many of these abilities may change in future patches:

  • Patch 3 changed Lightning Charges from a "Damage Rider treated as a Damage Source" to a "Damage Rider."
  • Tavern Brawler is treated as a Damage Rider with unarmed attacks and improvised weapon attacks, but as a "Damage Rider treated as a Damage Source" when it comes to thrown weapon attacks.
  • Sneak Attack is treated as a Damage Rider when a character uses the Sneak Attack action, but as a "Damage Rider treated as a Damage Source" when Sneak Attack is applied by the automatic reaction system.