List of effects

This article lists all possible event effects. Add any that are missing.

Syntax and terminology

Many event options are of the form

X = {
	limit = {
		A = B
	}
	Y = Z
}

What this means is that when the event triggers, and this outcome is selected, then for all X such that A = B, Y = Z happens to X. X is the target of the command, and may be a group of pops, a group of provinces or states, a country, or other things; A = B is the condition, and may be limiting the pops to only those of certain cultures, limiting the states to only those that are slave states, or other things; Y is the effect, and Z is the argument that tells the effect what to do. This is a general pattern, and may not hold for specific examples.

These may also be nested; for instance,

any_state = {
	limit = {
		is_slave = yes
	}
	any_pop = {
		limit = {
			has_pop_culture = dixie
		}
		consciousness = 0.5
	}
}

says that in all states (any_state) that are slave states (limit = {is_slave = yes}), all pops (any_pop) that are of the Dixie culture will have a CON increase of 0.5

Targets

Pops

An effect that applies to pops can target pops in these classes:

target	what it means
any_pop	targets all pops
aristocrats artisans bureaucrats capitalists clergymen clerks craftsmen farmers labourers officers slaves soldiers	the type of pop specified
poor_strata middle_strata rich_strata	all pops in a certain wealth level

This target can be limited by:

• has_pop_culture = (culture)
• has_pop_religion = (religion)
• is_state_religion = (yes/no)
• type (type = slaves or NOT = { type = slaves}, for example)
• is_primary_culture = (yes/no)
• is_accepted_culture = (yes/no)
• consciousness = n (all pops where CON is at least n)
• militancy = n

Province

An effect that targets provinces can target these classes:

target	what it means
any_owned	all provinces; can be nested within a state or country target to give all provinces within the state, states, or country selected.
(a province ID)	the province referenced by the ID
capital_scope	for a country event, this targets the country's capital province.

For a province event, if no target is given the effect will target the province for which the event fired.

This target can be limited by:

• is_core = (tag) (to specify provinces that have certain cores on them)
• province_id = n (to exclude specific provinces from a larger group)
• has_province_modifier = (modifier)
• has_province_flag = (flag name) (only provinces that have that flag will be targeted)
• (ideology) = n (only provinces where (ideology) has more than n% representation)
• average_militancy = n (all provinces with average MIL over n)
• average_consciousness = n

State

An effect that targets states can target these classes:

target	what it means
random_state	any one state, randomly chosen
(a state name, e.g. USA_1)	the state referenced by that name
state_scope	For a province event, state_scope is the state containing the province

This target can be limited by:

• is_slave = (yes/no)
• is_colonial = (yes/no)
• average_militancy = n (all states with average MIL over n)
• average_consciousness = n
• has_pop_type = (type)
• (issue) = n (all states where (issue) is the primary issue for n% of the population)

Country

An effect that targets a country as a whole can use these targets

target	what it means
no target given	For a country event, the default target is the country that fired the event
(a tag)	the country referenced by the tag
any_country	all countries (the current country not included)
any_greater_power	randomly choose one of the eight great powers
FROM	for a triggered event, FROM is the country that fired the triggering event.
THIS	the country that fires a country-scope event.
owner	for a province event, owner is the country that owns the province that fired the event
sphere_owner	If the country that fired an event is in a sphere, sphere_owner is the nation controlling that sphere

This target can be limited by:

• has_country_flag = (flag name) (only countries that have that flag will be targeted)
• civilized = (yes/no)
• in_culture_group = (group)
• (reform_class) = (reform_level) (only countries that have a certain level of political or social reform, ex. press_rights = free_press)
• prestige = n (limits to countries with n prestige or more)
• tag = (tag) or, more importantly, NOT = {tag = (tag)} (limits to the country with (or the countries without) the given tag

Population Effects

Name	Target	Syntax	Effect	Notes
assimilate	POPs	assimilate = yes/no	Changes all the pop cultures in a scope into the primary culture	Only works in the province scope. any_owned = { assimilate = yes } Changes the all pops in the country to the primary culture.
consciousness	POPs	consciousness = n	Change the CON of the targeted pop or pops by the given value	poor_strata = { consciousness = 1.5 }
dominant_issue	POPs	dominant_issue = { value = (issue) factor = n }	Changes the dominant issue of a portion of the targeted pop to the given issue. It works the same way as upper_house.
ideology	POPs	ideology = { factor = n value = (name) }	Change the proportion of the targeted pop that follows the specified ideology. It works the same way as upper_house.
literacy	POPs	literacy = n	Changes the literacy of the targeted pop by the specified amount.	literacy = -0.10 Reduces literacy by 10%.
militancy	POPs	militancy = n	Change the MIL of the targeted pop or pops by the given value. Similar in all respects to consciousness, as described above.
money	POPs	money = n	Changes the target pop's savings by the specified amount.
move_issue_percentage	POPs	move_issue_percentage = { from = (issue) to = (issue) value = n }	Makes a certain percentage of people supporting issue A, switch to issue B. This effect is used in the adding of CB, where people switch from jingoism to pro military.
move_pop	POPs	move_pop = (province ID)	Moves the targeted pop to the specified province. There have been issues encountered with this effect, such as having the moved pop automatically join up with pops of the same religion even if they're not the same culture. Use with caution
pop_type	POPs	pop_type = (type)	Changes the type of the targeted pop.
reduce_pop	POPs	reduce_pop = n	Changes the targeted pop to the given proportion of its current value. Increases POP size if n>0.
scaled_consciousness	POPs	scaled_consciousness = { factor = n ideology or issue = (name) }	Changes the consciousness of the targeted pops by the given value multiplied by the proportion of the pop that is of the given ideology or issue. E.g. if a pop has 40% support for pro-military, and n = 0.5, then the CON increase would be 0.4 * 0.5 = 0.2.
scaled_militancy	POPs		see scaled_consciousness

Provincial Effects

Name	Target	Syntax	Effect	Notes
add_core	Province	add_core = [TAG/THIS/FROM]	Adds a core of the given country to the targeted province
add_province_modifier	Province	add_province_modifier = { name = (modifiername) duration = n }	Adds the specified modifier to the targeted province. n in days.
change_controller	Province	change_controller = [TAG]	Changes the controller (not owner) of the target province.
change_province_name		change_province_name = "name"	Changes the province's name to the one specified.
change_region_name	State	change_region_name = "name"	Changes the region (state) name to the one specified.	Example: 1 = { state_scope = { change_region_name = "name" } } Don't include ANY other effects in the same province scope as this one, else the event will cause a crash.
flashpoint_tension	State	flashpoint_tension = n	Increases the flashpoint tension of the state by n.	HoD only. Example: state_scope = { flashpoint_tension = 10 }
fort	Province	fort = n	Changes the target province's fortification level by n.
infrastructure	Province	infrastructure = n	Changes the target province's infrastructure level by n.
life_rating	Province	life_rating = n	Changes the target province's life rating by n.
naval_base	Province	naval_base = n	Changes the target province's naval base level by n.
remove_core	Province	remove_core = [TAG/THIS]	Removes a core of the given country to the targeted province.	FROM does not work.
remove_province_modifier	Province	remove_province_modifier = [modifier name]	Removes the specified modifier from the targeted province.	If the modifier does not currently exist in the province, this command won't appear in the tooltip.
RGO_size	Province	RGO_size = n	Changes the target province's RGO size by n.
secede_province	Province	secede_province = [tag/THIS/FROM]	Transfers the province in scope from the targeted nation to another.
trade_goods	Province	trade_goods = [type]	Changes the good produced by the target province to the one specified.

National Effects

Name	Target	Syntax	Effect	Notes
activate_technology	Country	activate_technology = [technology]	Adds the specified technology to the country, whether it is the next level or not.	AHD only
add_accepted_culture	Country	add_accepted_culture = [culture]	Makes the specified culture accepted by the targeted country.
remove_accepted_culture	Country	remove_accepted_culture = (culture)	Removes the specified culture as accepted by the targeted country.
add_country_modifier	Country	add_country_modifier = { name = [modifier] duration = n }	Adds the specified modifier to the targeted country. n is in days.	Won't replace or extend an already existing modifier.
add_crisis_interest	Country	add_crisis_interest = [yes/no]	Involves the country in scope to the current crisis.	HoD only
add_crisis_temperature		add_crisis_temperature = n	Increases the temperature of the current crisis by n.
badboy	Country	badboy = n	Change the target country's infamy by n.
capital	Country	capital = [province]	Change the capital of the country to the specified province id.
civilized	Country	civilized = [yes/no]	Changes the civilized/uncivilized status of the country.
kill_leader		kill_leader = [ID]	Kills the specified army/navy leader.	The ID can be found in the save file. Unclear if the ID is always the same for leaders created using define_general.
define_general		define_general = { name = [name] personality = [trait] background = [trait] }	Creates a new general with the specified parameters.	name: see kill_leader
nationalvalue	Country	nationalvalue = [value]	Changes the national value of the current country to the value specified.	value from common\nationalvalues.txt
plurality	Country	plurality = n	Change the plurality of the targeted country by n.
prestige	Country	prestige = n	Change the prestige of the targeted country by n.
prestige_factor	Country	prestige_factor = n	Changes the prestige of the targeted country by the current prestige multiplied with n. Change cannot be less than ±1.
primary_culture	Country	primary_culture = [culture]/[TAG/THIS/FROM]	Changes the target country's primary culture.	This may be used on non-existing countries.
religion	Country	religion = (religion)	Changes the scoped country's state religion to the specified one. State religion is only visible in save files.
remove_country_modifier		remove_country_modifier = [modifier]	Removes a country modifier.	If the country modifier does not exist, the command won't appear in the tooltip.
research_points	Country	research_points = n	Grants n RPs to the target country's current research project.
war_exhaustion	Country	war_exhaustion = n	Changes the target country's war exhaustion by n.
years_of_research	Country	years_of_research = n	Grants a number of RP that would have been accumulated over n years.
nationalize	Country	nationalize = [yes/no]	Turns all factories invested by foreign powers your own.

Political Effects

Name	Target	Syntax	Effect	Notes
economic_reform	Country	economic_reform = [reform]	Adds the specified economic reform to the uncivilized nation.	AHD only
election	Country	election = yes	Starts the election process ahead of schedule.
enable_ideology		enable_ideology = [ideology]	Globally enables the specified ideology.
government	Country	government = [government]	Changes the target country's government to the specified type.	Does not change any of the country's reforms.
is_slave	State	is_slave = (yes/no)	Sets the slave state / free state status of a state. Appears in a triggered-only event, syntax doesn't fit the normal model.
military_reform	Country	military_reform = [reform]	Adds the specified military reform to the uncivilized nation.	AHD only
political_reform	Country	political_reform = [reform]	Changes the target country to the specified political reform.
ruling_party_ideology	Country	ruling_party_ideology = [ideology]	Changes the current ideology of the country's ruling party.	The exact party is random if there is more than one for that ideology.
social_reform	Country	social_reform = [reform]	Changes the target country to the specified social reform.
upper_house	Country	upper_house = { ideology = [ideology] value = [n] }	Changes the proportion of the upper house that follows the specified ideology.	The amount gained (U) is calculated by the following formula: U=1-1/(1+N) The other values will be multiplied by 1-U. Example: Upperhouse starts with 10% (0.1) liberals and 90% (0.9) conservatives. U=1-1/(1+N)=1-1/(1+0.25)=1-0.8=0.2 1-U=0.8 liberals = 0.1*0.8+.2 = 0.28 = 28% conservatives = 0.9*0.8 = 0.72 = 72% N = -1-1/(U-1)

Diplomatic Effects

Name	Target	Syntax	Effect	Notes
add_casus_belli	Country	add_casus_belli = { target = [TAG/FROM/THIS] type = [casus belli] months = n }	Gives the target a casus belli against the country in scope for n months.
annex_to	Country	annex_to = [TAG/THIS/FROM]	Annexes the targeted country to the country in the current scope.
casus_belli	Country	casus_belli = { target = [TAG/FROM/THIS] type = [casus belli] months = n }	Grants the scoped country a casus belli against the target country for n months.
create_alliance	Country	create_alliance = [TAG]	Creates an alliance between target country and the scoped country.
create_vassal	Country	create_vassal = [TAG]	Makes the specified country a vassal of the scoped country, even if they are already a vassal.
diplomatic_influence	Country	diplomatic_influence = { who = [TAG/FROM/THIS] value = n }	Changes the influence that the targeted country has on the specified country by n.
end_military_access	Country	end_military_access = [TAG/THIS/FROM]	Ends the military access granted by the specified country to the current country.
end_war	Country	end_war = [TAG]	Ends any war between the target country and the specified country.	Does not create a truce, and there are no penalties for the cancelled CBs. Will not cancel the war with allies or vassals.
inherit	Country	inherit = [TAG/FROM/THIS]	Adds all provinces of the specified country to the targeted country.
leave_alliance	Country	leave_alliance = [TAG]	Remove the current country from an alliance with the specified country.
military_access	Country	military_access = [TAG/THIS/FROM]	Gives the target country military access to the specified country.
neutrality	Country	neutrality = [yes/no]	Dissolves all alliances a nation has and set all satellites free.
relation	Country	relation = { who = [TAG/FROM/THIS] value = n }	Changes the relation between the targeted country and the specified country by n.
release	Country	release = [TAG]	Allows the target country to release the specified country and thereby create a new independent nation.
release_vassal	Country	release_vassal = [TAG/FROM/THIS]	If this targets a vassal nation (or substate), the vassal is freed. If this targets a non-existing nation, it is released as a vassal of the current country.	If the capital of the released country is not owned, the country is simply freed outright and not as a vassal (check with is_possible_vassal).
war	Country	war = [TAG] war = { target = [TAG] attacker_goal = { casus_belli = [casus belli] } defender_goal = { casus_belli = [casus belli] } call_ally = [yes/no] }	Starts a war between the country for whom the event fired and the given country.

Economic Effects

Name	Target	Syntax	Effect	Notes
add_tax_relative_income	Country	add_tax_relative_income = n	Used to remove or add money relative to country's income with maximum taxation.	E.g. if n=0.1, 10% of what income would be if all taxes were maxed out is added.
[resource name]	Country	[resource name] = n	Changes the national stockpile of the resource named by n.
treasury	Country	treasury = n	Change the amount of cash in the treasury by n.

Function Effects

Name	Target	Syntax	Effect	Example
change_tag	Country	change_tag = [TAG]	Switches the nation in scope to the specified country tag. No cores will change.	change_tag = culture probably changes to the union tag for that culture.
change_tag_no_core_switch		change_tag_no_core_switch = [TAG]	Switches the player nation from the current one to the specified one.
change_variable		change_variable = { which = [variable] value = n }	Increases or decreases the value of an existing variable.
clr_province_flag	Province	clr_province_flag = [flag]	Removes the specified province flag.
clr_country_flag	Country	clr_country_flag = [flag]	Removes the specified country flag.
clr_global_flag	Global	clr_global_flag = [flag]	Removes the specified global flag.
country_event		country_event = [event] country_event = { id = [event] days = n }	Fires the specified country event for the targeted country.	Second syntax only with AHD, FROM will not work with that.
province_event		province_event = { id = [event] }	Fires the specified province event for the targeted province.	Event can only fire for the owner of the province, and does not work on empty provinces. It will however work if you secede_province at the same time.
random		random = { chance = n [effects] }	Specifies the probability n that the effects specified will occur.
random_list		random_list = { E1 = { [effect1] } E2 = { [effect2] } ... En = { [effectn] } }	Causes one of two or more possible effects to happen and specifies the probability for each. Probability of any effect Ex occurring is Ex/(E1+E2+...+En).	Due to the game using a random number seed, the output for this effect will be the same every time it's used in the same event.
set_province_flag	Province	set_province_flag = [flag]	Sets the specified flag for the current province.
set_country_flag	Country	set_country_flag = [flag]	Sets the specified flag on the current country.
set_global_flag	Global	set_global_flag = [flag]	Sets the specified flag globally (meaning every tag, existing or not, gets the flag)
set_variable		set_variable = { which = [name] value = n }	Creates a new variable and assigns it the value n.If the variable exist，it's value will be set by n.

See also

• List of commands
• List of scopes
• Modifier effects
• Modding overview
• Event modding