Darkest Dungeon® Guide

List of all Effects, Buffs and Skills parameters for Darkest Dungeon®

List of all Effects, Buffs and Skills parameters

Overview

These are all parameters that I could find to use for modding. (Probably missed some)Intended to be used with Official Modding Guide For examples of usage search for it in *.effects.darkest, *.buffs.json or *.info.darkest, *.art.darkest filesThis stuff was found manually while datamining manually, so if you found that something is missing or just want to improve the guide feel free to leave a comment or add me as friend.

Effects

Parameter
Arguments
.name
Effect Name
.target
performer
performer_group
performer_group_other
target
target_group
target_group_other
target_enemy_group
global
.curio_result_type
positive
negative
neutral
none
.chance
value
.on_hit
true or false
.on_miss
true or false
.queue
true or false
.dotBleed
value
.dotPoison
value
.dotStress
value
.stress
value
.healstress
value
.combat_stat_buff
1 or 0
.damage_low_multiply
.damage_high_multiply
.max_hp_multiply
.attack_rating_add
.crit_chance_add
.defense_rating_add
.protection_rating_add
.speed_rating_add
value
_multiply can be used instead of _add and vise versa
.buff_ids
buff IDs
.duration
value
.dotHpHeal
value
.heal
value
.heal_percent
value
.can_crit_heal
true or false
.cure
1 or 0
.cure_bleed
1 or 0
.cure_poison
1 or 0
.clearDotStress
1 or 0
.tag
1 or 0
.untag
1 or 0
.stun
value
.unstun
1 or 0
.keyStatus
tagged
poisoned
bleeding
stunned
dazed
transformed ?
.riposte
1 or 0
.riposte_on_miss_chance_add
.riposte_on_hit_chance_add
.riposte_on_miss_chance_multiply
.riposte_on_hit_chance_multiply
value
.riposte_effect
effect ID
.clear_riposte
1 or 0
.guard
1 or 0
.clearguarding
1 or 0
.clearguarded
1 or 0
.torch_decrease
value
.torch_increase
value
.item
1 or 0
.curio
1 or 0
.dotShuffle
1 or 0
.push
value
.pull
value
.shuffletarget
.shuffleparty
.instant_shuffle
.buff_amount
value
.buff_type
buff type
.buff_sub_type
buff sub type
.buff_duration_type
buff duration type
.steal_buff_stat_type
buff stat type
hp_dot_bleed
hp_dot_poison
hp_dot_heal
stress_dot
shuffle_dot
.steal_buff_source_type
check buff sources
.swap_source_and_target
true or false
.kill
1 or 0
.immobilize
1 or 0
.unimmobilize
1 or 0
.control
value
.uncontrol
1 or 0
.kill_enemy_types
monster type
corpse
.monsterType
monster type
unholy
man
beast
eldritch
vampire
husk
.capture
1 or 0
.capture_remove_from_party
1 or 0
.disease
any
disease ID
.remove_vampire
1 or 0
.summon_monsters
monster IDs
.summon_chances
value
.summon_ranks
value
.summon_limits
value
.summon_count
value
.summon_erase_data_on_roll
1 or 0
.summon_can_spawn_loot
1 or 0
.summon_rank_is_previous_monster_class
1 or 0
.summon_does_roll_initiatives
1 or 0
.crit_doesnt_apply_to_roll
true or false
.virtue_blockable_chance
value
.affliction_blockable_chance
value
.set_mode
mode ID
.can_apply_on_death
true or false
.apply_once
true or false
.rank_target
ranks
.clear_rank_target
ranks
.performer_rank_target
1 or 0
.apply_with_result
true or false
.initiative_change
value
.source_heal_type
check Heal sources
.skill_instant
true or false
.actor_dot
actor dot ID
.health_damage
value
.bark
bark string entry
.set_monster_class_id
monster ID
.set_monster_class_ids
monster IDs
.set_monster_class_chances
values
.set_monster_class_reset_hp
1 or 0
.set_monster_class_reset_buffs
true or false
.set_monster_class_carry_over_hp_min_percent
value
.set_monster_class_clear_initative
true or false
.set_monster_class_clear_monster_brain_cooldowns
true or false
.set_monster_class_reset_scale
true or false
.has_description
true or false
.stealth
1 or 0
.unstealth
1 or 0
.clear_debuff
1 or 0
.health_damage_blocks
value
.dotSource
check Buff Sources
.buff_source_type
check Buff Sources
.use_item_id
item ID
.use_item_type
item TYPE
.skips_endless_wave_curio
true or false
.spawn_target_actor_base_class_id
monster or hero class
changes target if it’s on a spawn effect
.clearvirtue
1 or 0 probably
.riposte_validate
true or false
.buff_is_clear_debuff_valid
true of false
.refreshes_skill_uses
true of false
.cure_disease
1 or 0
.individual_target_actor_rolls
true or false
.damage_type
check Damage types
.damage_source_type
check Damage sources
.damage_source_data
depends on source_type
e.g. monster ID for monster
or trinket ID for trinket
.daze
1 or 0
Might not work outside of Circus
.undaze
1 or 0

Combat Skills

Parameter
Argument
.id
skill name
.dmg
min max – for monsters
value – for heroes
.atk
value
.def
value
.move
back forth
.crit
value
.level
value
.type
“melee”
“ranged”
“move”
“”
“teleport”
.starting_cooldown
value
.per_battle_limit
value
.per_turn_limit
value
.is_continue_turn
true or false
.launch
ranks
.target
ranks
.self_target_valid
true or false
.extra_targets_chance
value
.extra_targets_count
value
.is_crit_valid
true or false
.effect
effects IDs
.valid_modes
modes IDs
.%s_effects
effects IDs
%s is a mode
.ignore_stealth
true or false
.ignore_guard
true or false
.can_miss
true or false
.can_be_riposted
true or false
.ignore_protection
true or false
.required_performer_hp_range
value
.rank_damage_modifiers
rank4 rank3 rank2 rank1
.heal
min max
.can_crit_heal
true or false
.generation_guaranteed
true or false
.is_user_selected_targets
true or false
.is_knowledgeable
true or false
.is_monster_rerank_valid_on_attack
true or false
.is_monster_rerank_valid_on_friendly_presentation_end
true or false
.is_monster_rerank_valid_on_friendly_post_result
true or false
.is_stall_invalidating
true or false
.refresh_after_each_wave
true or false
.damage_heal_base_class_ids
monster or hero classes
.ignore_deathsdoor
true or false
.icon
“icon name”
.anim
“anim name”
.fx
“fx name”
.targfx
.targheadfx
.targchestfx
.misstargfx
.misstargheadfx
.misstargchestfx
“fx name”
.area_pos_offset
X Y
.target_area_pos_offset
X Y
.reset_source_stance
true or false
.reset_target_stance
true or false
.can_display_selection
true or false
.hide_performer_health
true or false
.condensed_tooltip_effects
true or false
.condensed_tooltip_stats
true or false
.condensed_tooltip_type
true or false
.condensed_tooltip_effects_per_line
value
.nil
true or false
hides skill stats and stuff like uses per battle,
move forward, etc
.custom_target_anim
anim name
.custom_idle_anim_name
anim name
.custom_idle_round_duration
value
.has_crit_vo
true or false
.can_display_skill_name
true or false
.can_display_performer_selection_after_turn
true or false

Buff Types

stat_type
stat_sub_type
hp_heal_amount
optional Heal Source
hp_heal_percent
optional Heal Source
hp_heal_received_percent
optional Heal Source
combat_stat_multiply
max_hp
damage_low
damage_high
you can also use sub types from
combat_stat_add
combat_stat_add
attack_rating
crit_chance
defense_rating
protection_rating
speed_rating
riposte_on_hit_chance
riposte_on_miss_chance
and vise versa
resistance
stun
move
poison
bleed
disease
debuff
death_blow
trap
poison_chance
bleed_chance
stress_dmg_percent
optional Stress Source
stress_dmg_received_percent
optional Stress Source
stress_heal_percent
optional Stress Source
stress_heal_received_percent
optional Stress Source
party_surprise_chance
monsters_surprise_chance
ambush_chance
scouting_chance
starving_damage_percent
upgrade_discount
armour
weapon
combat_skill
camping_skill
…
can be used for making custom tooltips, because this buff doesn’t crash or throw errors with custom sub type
damage_received_percent
debuff_chance
resolve_check_percent
stun_chance
move_chance
remove_negative_quirk_chance
food_consumption_percent
resolve_xp_bonus_percent
activity_side_effect_chance
add_currency
remove_currency
add_trinket
remove_trinket
activity_lock
apply_buff
go_missing
vampire_evolution_duration
quirk_evolution_death_immune
disable_combat_skill_attribute
heal
buff
debuff
bleed
poison
stun
tag
stress
move
disease
guard
daze
guard_blocked
tag_blocked
ignore_protection
ignore_stealth
rules don’t work
crit_received_chance
riposte
effect ID
status
tag
guarded
vampire
stealth
hp_dot_bleed
hp_dot_poison
hp_dot_heal
stress_dot
shuffle_dot
rule only works if remove_if_not_active is set to true, which kills the buff if rule condition isn’t met
torch_increase_percent
torch_decrease_percent
torchlight_burn_percent
was changed since CoM update:
works in all ranks
value above 0 -> torch burns faster
value below 0 -> slower
stress_on_miss
stress_from_idle_in_town
shard_reward_percent
shard_consume_percent
damage_reflect_percent
hp_dot_bleed_duration_received_percent
hp_dot_bleed_duration_percent
hp_dot_bleed_amount_received_percent
hp_dot_bleed_amount_percent
hp_dot_poison_duration_received_percent
hp_dot_poison_duration_percent
hp_dot_poison_amount_received_percent
hp_dot_poison_amount_percent
stress_dot_duration_received_percent
stress_dot_duration_percent
stress_dot_amount_received_percent
stress_dot_amount_percent
hp_heal_dot_duration_received_percent
hp_heal_dot_duration_percent
hp_heal_dot_amount_received_percent
hp_heal_dot_amount_percent
shuffle_dot_duration_received_percent
shuffle_dot_duration_percent
guard_duration_received_percent
guard_duration_percent
cure_bleed_received_chance
cure_poison_received_chance
cure_bleed_chance
cure_poison_chance
random_target_friendly_chance
random_target_attack_chance
transfer_debuff_from_attacker_chance
transfer_buff_from_attacker_chance
quirk_tag_evolution_duration
Quirk Tag
deathblow_chance
heartattack_stress_heal_percent
ignore_guard
buff_duration_percent
Affects not only buffs but debuffs, dots, marks, guards, etc.
riposte_duration_percent

Buff Rules

rule_type
float
string
always
0
skill
0
skill name ID
riposte
0
rangedonly
0
meleeonly
0
actorStatus
0
tagged
poisoned
bleeding
stunned
virtued
afflicted
monsterType
0
monster type
unholy
man
beast
eldritch
vampire
corpse
monsterSize
value
firstroundonly
0
in_camp
0
in_dungeon
0
dungeon ID
cove
crypts
warrens
weald
town
darkestdungeon
farm
courtyard
in_activity
0
meditation
prayer
flagellation
bar
gambling
brothel
treatment
disease_treatment
in_room
0
in_corridor
0
at_deaths_door
0
in_rank
rank from 0 to 3
hpbelow
value
hpabove
value
lightbelow
value
lightabove
value
stress_below
value
stress_above
value
virtued
0
afflicted
0
monster_type_count_min
value
monster type
is_vampire
0
target_is_vampire
0
has_quirk
0
quirk ID
walking_backwards
0
actor_base_class
0
monster or hero class
in_mode
0
mode ID
is_guarded
0
target_is_guarded
0
is_guarding
0
target_is_guarding
0
is_stealthed
0
target_is_stealthed
0
has_item_id
0
item ID
has_item_type
0
item type
is_actor_status
0
tagged
poisoned
bleeding
stunned
virtued
afflicted
for “if virtued/afflicted” there’re virtued
and afflicted rules
no_trinkets
0
attacking_monster_type
0
monster type
target_hpabove
value
target_hpbelow
value
activated_last
0
activated_first
0
ondeathsdoorenter
0

If you want to prevent your buff from stacking with other similar buffs in tray (as in they have same type, sub type, rule, duration type but different amount and/or duration) you can put anything else rather than `0` or “ in `float` or `string` fields

Buff Durations

duration_type
round
combat_end
quest_end
quest_complete
quest_not_complete
activity_end
idle_start_town_visit
till_removed
none
before_turn
after_turn
after_round
status

Sources

Type
Used for
Known Sources
Buff sources
effect: .steal_buff_source_type
effect: .dotSource
effect: .buff_source_type
bsrc_skill
bsrc_notspecified
bsrc_affliction
bsrc_virtue
bsrc_item
bsrc_curio
bsrc_disease
bsrc_riposte
bsrc_campingskill
bsrc_quirk
bsrc_trinket
bsrc_trinket_set
bsrc_instantSkill
bsrc_guard
bsrc_deathsdoor
bsrc_deathsdoor_recovery
bsrc_deathsdoor_recovery_heart_attack
bsrc_quest_failure
bsrc_companion
bsrc_stun
bsrc_town
bsrc_district
bsrc_torchsettings
bsrc_crit
bsrc_trinket_additional_effect
bsrc_battle_modifier
bsrc_never_again
bsrc_vampire
bsrc_town_event
bsrc_flashback_start
bsrc_flashback_result
bsrc_completed_darkest_dungeon_quest_party_hero
bsrc_quest_modifier
bsrc_last_hero
combat_end
for more info check out this guide[docs.google.com] by Sasiji
Heal sources
effect: .source_heal_type
buff: hp_heal_amount
buff: hp_heal_percent
buff: hp_heal_received_percent
hero_skill
hero_skill_multi_target
monster_skill
monster_skill_multi_target
camp_skill
camp_skill_multi_target
companion
eat
act_out
damage_heal
effect
flashback
dot
curio
Stress sources
buff: stress_dmg_received_percent
buff: stress_dmg_percent
buff: stress_heal_percent
buff: stress_heal_received_percent
hunger
death_blow
hero_crit
hero_killing_blow
mode
control
unkown (yep, there is a typo)
town_idle
quest_fail
pass
camping_relieve_stress
camping_eat
tile
retreat
effect
capture
monster_crit
curio
there could be more, so let me know if you find any new ones
Damage Types
effect: .damage_type
attack
bleed
poisoned
obstacle
trap
hunger
captor
healing
ddexit
townexit
additionaleffect
effect
reflect
unknown
“” (empty type)
there are most likely more of those
Damage Sources
effect: .damage_source_type
monster
friendly
hero
obstacle
trap
hunger
trinket
item
quirk
effect
reflect
unknown
friendly_quirk_actout
friendly_trait_actout
“” (empty source)
again, there’re more of them, probably

Trinket Effects Triggers

Trigger type
Description
attack_skill_additional_effects
On Attack (target: monster)
friendly_skill_additional_effects
Friendly Skill (target: ally)
kill_performer_additional_effects
On Monster Kill (target: hero)
kill_all_monsters_additional_effects
On Monster Kill (target: all monsters)
kill_all_heroes_additional_effects
On Monster Kill (target: party)
was_killed_all_heroes_additional_effects
Hero Killed (target: party)
was_killed_all_monsters_additional_effects
Hero Killed (target: all monsters)
was_hit_additional_effects
Hero Was Hit (target: attacker | performer: hero)
was_hit_all_heroes_additional_effects
Hero Was Hit (target: party | performer: hero)
was_hit_all_monsters_additional_effects
Hero Was Hit (target: all monsters | performer: hero)
melee_attack_skill_additional_effects
On Melee Attack (target: monster)
ranged_attack_skill_additional_effects
On Ranged Attack (target: monster)
attack_crit_additional_effects
On Crit (target: monster)
riposte_skill_additional_effects
On Riposte (target: monster)

—Everything-below-is-incomplete—

raw, unformatted and untested

Monster Mashes

.types
.chance
.name
.min_vampire_heroes
.max_vampire_heroes
.infestation_sequence_element
.infestation_activity_level
.darkness_range
.inventory_valid_item_percent_range
.loading_screen
.flashback_id
.bosses
.dungeon_length_range
.qty (quantity?)
.plot_quest_requirement
.random_dungeon_roaming_id
.limit
.can_be_ambush
.max_quirk_tags
.completed_flashback_id
.quirk_tag
.min_quirk_tags

Battle Modifiers

battle_modifier:
.can_relieve_stress_from_crit
.can_relieve_stress_from_killing_blow
.always_surprise
.always_be_surprised
.can_surprise
.can_be_surprised
.does_count_towards_stall_penalty
.accelerate_stall_penalty
.disable_stall_penalty
.disabled_act_out_combat_start_turn_types
.living_other_enemy_buffs
.living_hero_buff_instance_ids
.can_be_guarded
.remove_on_retreat
.can_be_damaged_directly
.can_be_random_target
.can_be_hit
.can_be_missed
.can_be_summon_rank
.is_valid_friendly_target
.does_count_as_guardable_for_monster_brain
.does_count_as_monster_size_for_monster_brain

Skill Reactions

skill_reaction:
.was_killed_all_heroes_effects
.was_killed_effects
.was_killed_other_monsters_effects
.was_killed_by_hero_effects
.was_hit_performer_effects
.was_hit_target_effects

Modes

mode:
.id
.is_raid_default
.always_guard_actor_base_class_ids
.is_targetable
.keep_rounds_in_ranks
.stress_damage_per_turn
.bark_override_id
.affliction_combat_skill_id
.battle_complete_combat_skill_id

Death Class

death_class:
.monster_class_id
.random_monster_class_ids
.random_monster_class_chances
.type
.is_valid_on_crit
.is_valid_on_blight_dot
.is_valid_on_bleed_dot
.carry_over_hp_min_percent
.use_previous_monster_hp
.clear_monster_brain_cooldowns
.change_class_effects
.can_die_from_damage
.reset_scale_anim
.on_change_sfx

Generation

generation:
.is_generation_enabled
.town_event_dependency
.number_of_positive_quirks_min
.number_of_positive_quirks_max
.number_of_negative_quirks_min
.number_of_negative_quirks_max
.number_of_class_specific_camping_skills
.number_of_shared_camping_skills
.number_of_random_combat_skills
.number_of_cards_in_deck
.card_chance
.reduce_number_of_cards_in_deck_hero_class_id
.reduce_number_of_cards_in_deck_amount

ActorDot Update Duration Types

“update_duration_type”:
after_turn_attack
after_turn_attack_kill
after_turn_friendly

Camping Skills

“type”:
buff
health_heal_max_health_percent
health_damage_max_health_percent
stress_heal_amount
stress_damage_amount
remove_bleeding
remove_poison
remove_deaths_door_recovery_buffs
remove_disease
reduce_torch
reduce_ambush_chance
loot
item
“requirements”:
afflicted
has_deaths_door_recovery_buffs
religious
not_religious
“selection”:
self
individual
party
party_other

Buff Attributes

id
stat_type
stat_sub_type
amount
duration
duration_type
rule_type
is_false_rule
rule_data
remove_if_not_active
remove_on_battle_complete
is_clear_debuff_valid
fx
has_description

require testing: (seems like these are only used in save files)
target
source
sourcedata_number
source_name
source_guid
source_class_id
damageSourceType
guarded_guid
rule
ruledata_number
ruledata_string

Inventory Items

inventory_item:
.type
.id
.purchase_gold_value
.purchase_shard_value
.sell_gold_value
.estate_can_be_provision
.tutorial_id
.sfx_override
.fx_bone_override
.use_id_take_sfx
.sequential_use_effects
.act_out_consume_priority
.wait_for_item_use_to_finish
.replace_buffs
.can_modify_cost
.base_stack_limit
.can_modify_stack_limit
inventory_system_config:
.type
.use_stack_limits
.max_slots
extra_stack_limit:
.id
.item_type
.item_id
.amount

AI Brains

Use THIS[docs.google.com] instead

Districts

Buff Type
Parameters         
Description/Notes
all types
name
hero_type_tags []
hero_type_tags might not work for some
DistrictCampingBuffData
camping_points
Increases Respite Points
DistrictCurioInteractionBuffData
curio_tags []
stress_heal
health_heal
Interacting with certain Curios heals stress/hp
DistrictDisableBuffData
disabled_type
Disables stuff like Hunger checks
Currently known possible disables:
hunger
DistrictEstateBuffData
weekly_gold_interest
Gain interest every week
DistrictHeroBuffData
buff_list []
Grants buffs to heroes
DistrictLightBuffData
darkness {}
loot_darkness_bonus []
Modifies torch bonuses and loot tables
DistrictPrestigeBuffData
does nothing, useful for making custom tooltips
DistrictReplacementInventoryEffectBuffData
item_type
item_id
effect
Changes effects of consumable items
DistrictRosterStressReliefBuffData
stress_relief
Increases stress heal for idling in town
DistrictStackingBuffData
extra_stack_limit_id
Increases stack sizes
DistrictSupplyBuffData
item_type
item_name
target_inventory
range_min
range_max
Generates a random amount of certain items every week
Currently known possible inventories:
provision
estate
DistrictBuffData
Probably doesn’t exist and shouldn’t be here

Town Events

Type
free_activity
activity_lock
activity_cost_change
bonus_recruit
dead_recruit
plot_quest
embark_party_buff
in_activity_buff
idle_buff
idle_resolve_level
provision_item_type_cost_change
provision_item_type_amount_change
upgrade_tag_discount
upgrade_tag_free
remove_quest_hero_level_restriction
stage_coach_bonus_recruits
trinket_retention_add_from_storage
remove_vampire
districts_unlocked
bonus_currency
stress_treatment_debuff
shard_buff
event_cost
quirked_recruit
roster_stress_heal
roster_disease_heal
Requirements
minimum_week
dead_heroes
finished_plot_quests
available_plot_quest
infestation_sequences
hero_level_counts
upgrades_purchased
trinket_storage_count
minimum_number_of_district_buildings
© 2025 Steam Solo • Made by
SteamSolo.com