List of province scope triggers

From Europa Universalis 3 Wiki
Jump to navigation Jump to search

This article is accurate for the latest versions of EU3, Napoleon’s Ambition, In Nomine, Heir to the Throne and Divine Wind.

This article lists all possible event triggers.

See also the List of country scope triggers

Miscellaneous

Boolean container trigger
Availability Syntax Values Comment
AND EU3.gif AND = { } <trigger syntax> Return true if all the triggers inside the bracket return true.
OR EU3.gif OR = { } <trigger syntax> Return true if one of the triggers inside the bracket return true.
NOT EU3.gif NOT = { } <trigger syntax> Return true if all the triggers inside the bracket return false.
Values
Name Explanation
natural numbers ℕ means { 0, 1, 2, 3, ...}.
integers ℤ means {..., −3, −2, −1, 0, 1, 2, 3, ...}.
[0,1] positive real interval [0,1] mean any real number between 0 and 1, for example 0 and 0.5. 0.5 mean 50%.
[-1,1] real interval [-1,1] mean any real number between -1 and 1, for example 0 and -0.8. -0.8 mean -80%.
THIS The country that received the event
FROM The country that triggered the event
<...> code name Any code name as defined in the relevant game files (given in link).
yes/no Boolean Obviously, yes return true and no return false

All Scopes

Triggers that works on any scope
Availability Syntax Values Comment
year EU3.gif 1.3 year = Returns true if ℕ is the current year or an earlier year.
month EU3.gif 1.3 month = Returns true if ℕ is the current month or an earlier month. 0 = January (...) 11 = December.
is_religion_enabled EU3.gif 1.3 is_religion_enabled = <religion type> Returns true if that particular religion type has been enabled.
exists EU3.gif 1.3 exists = <country tag> Returns true if the specified country exists.
num_of_electors EU3.gif 1.3 num_of_electors = Returns true if there are currently ℕ electors or more.
AI NA.gif ai = yes/IN.gifno Returns true if the country is handled by the AI. IN.gif: ai = no is available. DW.png: seem to be documented to work in any scopes. It have be verified.
revolution_target_exists NA.gif revolution_target_exists = yes/no Returns true if a revolution target has been chosen.
check_variable NA.gif check_variable = { } which = <variable name> value = ℤ Returns true if the variable exists and its value is ℤ (must check if it's equal or bigger than).

IN.gif3.1: The variable now returns true if its value is at least ℤ (≥ instead of =). DW.png: Documented as working in all scopes.

has_global_flag IN.gif has_global_flag = <name of flag> Returns true if the flag exists.
papacy_active HTTT.png papacy_active = yes/no When yes, returns true if the papacy has not been deactivated.
hre_size HTTT.png 4.1 hre_size = Returns true if there are at least ℕ member countries in the Holy Roman Empire.
national_focus HTTT.png national_focus = province ID#/THIS Returns true if the target is the National Focus. (Contributor note: I believe this is actually a country-scope trigger which automatically changes to owner-scope if used in province-scope.)
start_date DW.png start_date = YYYY.MM.DD Returns true if the game started on start date.
has_hre_member_modifier DW.png has_hre_member_modifier = <modifier name> Returns true if the HRE member countries has the modifier.
has_hre_member_modifier DW.png has_hre_member_modifier = <modifier name> Returns true if the HRE member countries has the modifier.
has_hre_emperor_modifier DW.png has_hre_emperor_modifier = <modifier name> Returns true if emperor has the modifier.
imperial_influence DW.png imperial_influence = Returns true if imperial influence is equal to ℕ or higher. ℕ = {0,...,100}
religion_years DW.png religion_years = { } <religion name> = ℕ Returns true if religion name has been enabled for ℕ years or longer.
shogun_exists DW.png shogun_exists = yes/no Returns true if any country is shogun
kampaku_exists DW.png kampaku_exists = yes/no Returns true if any country is kampaku.
shogun_influence DW.png shogun_influence = Returns true if the shogun has influence equal to ℕ or higher. ℕ = {0,...,100}
shogunate_civil_war DW.png shogunate_civil_war = yes/no Returns true if at least two daimyos are at war with each other.
num_of_daimyos DW.png num_of_daimyos = Returns true if the number of daimyos is equal to ℕ or higher.

Province Scope

Triggers that work on provinces.

Triggers that works on any scope
Availability Syntax Values Comment
port EU3.gif 1.3 port = yes/no Returns true if the current province has a port.
cot EU3.gif 1.3 cot = yes/no Returns true if the current province has a Center of Trade.
owned_by EU3.gif 1.3 owned_by = tag/this Returns true if the specified country owns the current province. If this is used the scope has to be changed so that the target nation can be compared to the country that received the event.
religion EU3.gif 1.3 religion = religion name/this Also works for country. Returns true if the country/province in the current scope follows the same religion. If this is used as the religion-type the scope has to be changed so that the target nation can be compared to the country that received the event.
religion_group EU3.gif 1.3 religion_group = religion group name/this Also works for country.Returns true if the province in the current scope belongs to the same religion-group. If this is used as the religion-type the scope has to be changed so that the current province can be compared to the country (or province?) that received the event.
is_colony EU3.gif 1.3 is_colony = yes/no Returns true if the current province is a colony.
has_province_flag EU3.gif 1.3 has_province_flag = flag name Returns true if the current province has the specified province flag (added by a previous event).
has_province_modifier EU3.gif 1.3 has_province_modifier = modifier name Returns true if the current province has the specified province modifier (added by a previous event).
continent EU3.gif 1.3 continent = name of continent Returns true if the current province belongs to the specified continent. IN NOMINE: Now it takes THIS into account.
native_size EU3.gif 1.3 native_size = x Returns true if the native size of a province is equal to x or higher.
native_ferocity EU3.gif 1.3 native_ferocity = x Returns true if the native ferocity value is equal to x or higher.
native_hostileness EU3.gif 1.3 native_hostileness= x Returns true if the native hostileness value is equal to x or higher.
citysize EU3.gif 1.3 citysize= x Returns true if the city size in a province is equal to x or higher.
hre EU3.gif 1.3 hre= yes/no Returns true if the province belongs to the Holy Roman Empire.
has_building EU3.gif 1.3 has_building= building type Returns true if the province has the specified building.
trade_goods EU3.gif 1.3 trade_goods= trade goods type Returns true if the province’s trade goods match the specified trade goods type.
units_in_province EU3.gif 1.3 units_in_province = x Returns true if there are x or more units in the current province.
infantry_in_province EU3.gif 1.3 infantry_in_province = x Returns true if there are x or more infantry in the current province.
galleys_in_province EU3.gif 1.3 galleys_in_province = x Returns true if there are x or more galleys in the current province.
is_core EU3.gif 1.3 is_core = country/this Returns true if the current province is a core of the specified country. By using this you can test if another province is a core of the owner of the current province. For example:

any_neighbor_province = { is_core = this } See also the country-scope version.

controlled_by NA.gif controlled_by = tag / this / from Returns true if the province is under control of the specified country. IN NOMINE: Now this trigger accepts “owner” as an argument.
has_empty_adjacent_province NA.gif has_empty_adjacent_province = yes / no Returns true if the province borders an empty province. 'Empty province' might include ocean/lake/wasteland provinces (bug fixed in later expansions).
province_id NA.gif province_id = ID of a province Returns true if this province has the specified ID.
placed_merchants NA.gif placed_merchants = number Returns true if the country has at least the given number of merchants in the CoT in the current province. Starting in HttT 4.1 this is also a country-scope trigger.
has_discovered NA.gif has_discovered = tag/THIS Returns true if the current province has been discovered by the target country.
nationalism IN.gif nationalism = ???? MUST CHECK. I guess this might be one of two things: it expects a number and will return true if the RR due to nationalism is at least that in the province, or it expect a yes / no and will return true if there is nationalism in the province. I’d bet on the former…
tolerance_to_this IN.gif tolerance_to_this= ???? MUST CHECK. I guess this might expect a number and will return true if the tolerance for the province religion is at least said number. But it might be an entirely different thing… even a country trigger.
region IN.gif region= region name Returns true if the province belongs to the specified region.
culture IN.gif culture= culture name Returns true if the province belongs to the specified culture.
is_overseas IN.gif is_overseas= yes/ no Returns true if the province is an overseas province.
empty IN.gif empty= yes/ no Returns true if the province is empty.
range IN.gif range= yes/ no Returns true if the province is in colonial range.
is_mission_province IN.gif is_mission_province= yes/ no Returns true if the province is the mission target for THIS
has_owner_religion IN.gif has_owner_religion= yes/ no Returns true if the province has the same religion as its owner. Needed inside 'any_neighbor_province' type triggers since the parent scope remains the top level scope. (So, 'owner' event targets will still be for the top level province.)
has_owner_culture IN.gif has_owner_culture= yes/ no Returns true if the province has the same culture as its owner. Needed inside 'any_neighbor_province' type triggers since the parent scope remains the top level scope. (So, 'owner' event targets will still be for the top level province.)
is_capital IN.gif is_capital= yes/ no Returns true if the province is a capital.
is_blockaded IN.gif is_blockaded= yes/ no Returns true if the province is being blockaded.
base_tax IN.gif base_tax= x Returns true if the base tax in the province is at least x.
cot_value IN.gif cot_value= x Returns true if the province is trading through a COT with a value of at least x.
looted IN.gif looted= yes/ no Returns true if the province is looted.
has_missionary IN.gif has_missionary= yes/ no Returns true if the province is in the process of being converted. Might be broken (see: forum:365252). Tests with Divine Wind v5.1 seems to indicate it works.
religion_years IN.gif religion_years= {religion name = x} Untested, should return true if the province religion is currently the specified one and has been for x or more years.
has_siege IN.gif has_sieges= yes / no Returns true if the province is under siege.
garrison IN.gif 3.1 garrison= x Returns true if the province garrison has at least x men at the moment.
can_spawn_rebels IN.gif 3.1 can_spawn_rebels= type of rebel Returns true if the probability for that province to spawn that type of rebel (patriot_rebels, nationalist_rebels, pretender_rebels...) is more than 0.
culture_group IN.gif 3.1 culture_group= culture group name Returns true if the province culture belongs to the same culture-group. Not sure if this can also be used like in its country scope counterpart.
has_national_focus HTTT.png has_national_focus= yes/no Returns true if the province is/isn't affected by the National Focus
national_focus HTTT.png national_focus= <province ID?> / THIS Returns true if the target is the National Focus

(Contributor note: I believe this is actually a country-scope trigger which automatically changes to owner-scope if used in province-scope.)

previous_owner HTTT.png previous_owner= <country tag> / THIS Returns true if the target country is the previous owner of the current province
had_province_flag HTTT.png had_province_flag= { flag = <flag name> days/months/years = x } Returns true if the current province has had the named flag set for at least x days/months/years.
manpower HTTT.png 4.1 manpower= x Returns true if the province base manpower value is at least x. Base manpower value is listed in province history and is visible in-game as a modifier to garrison growth.

Sources