查看“条件”的源代码

{{version|3.3}}

'''Conditions''' or '''Triggers''' are used in [[scripting]] to restrict events and [[commands]] to correct targets.

They appear:
*In condition blocks (<code>trigger</code> section of [[Event modding|events]], or equivalent: <code>mult_modifier</code>, <code>can_use_title</code>, <code>potential</code>, <code>allow</code>, ...)
*In the <code>limit</code> clause of command blocks
*In [[scripted trigger]]s, which can be used to group conditions into re-usable macro.
*At the root of events for [[pre-trigger]]s used to improve performances
Syntax for most conditions accepting numeric values was extended with [[Scripting#Numeric_operators|numeric operators]] since version 2.8.
The following triggers do not (fully) support these operators:
* <code>among_most_powerful_vassals</code>
* <code>days_since_last_hostile_action</code>
* <code>demesne_size</code>
* <code>demesne_efficiency</code>
* <code>num_of_realm_counties</code>
* <code>real_month_of_year</code>
* <code>real_day_of_year</code>
* <code>realm_character_percent</code>
* <code>religion_authority</code> (< and <= do not work)
* <code>scaled_wealth</code>
* <code>tier</code> (as well as similar triggers, such as <code>(lower/higher_)(real_)tier(_than)</code>
* <code>heavy_troops</code>, <code>light_troops</code> (simple right-hand side only, clause form fully support numeric operators)
* <code><troop_type></code>, for example <code>pikemen</code>

==List of conditions==

Available conditions depend on the current [[scope]] type.

{|class="wikitable sortable"
!Condition
!Used in vanilla
!Used from scope
!Value type
!Description
!Example
!Category
|-
|adventurer
!✓
|title
|bool
|Checks adventurer flag of the title (title that gets destroyed whenever the holder gains another title or when the holder dies). 
|<code>adventurer = yes</code>
|Titles
|-
|age
!✓
|character
|int
|The age of a character. Can be any whole number.
|<code>age < 45</code>
|Characters
|-
|age_diff
!✓
|character
|clause
|The ''absolute value'' of the age difference between two characters. Typically used in conjunction with <code>is_older_than</code>.
|<pre>
age_diff = {
    who = PREV
    years >= 25
}
</pre>
|Characters
|-
|ai
!✓
|character
|bool
|
*If yes, will only fire for ai characters.
*If no, will only fire for the player(s).
Can also be used as a [[pre-trigger]] for events and decisions.
|<code>ai = no</code>
|Characters
|-
|ai_ambition
!✓
|character
|int
|rowspan=5 | Check an [[Modifiers#AI behavior|AI behavior modifier]] (based on [[traits]])
|<code>ai_ambition >= 0</code>
|Characters
|-
|ai_greed
!X
|character
|int
|<code>ai_greed >= 10</code>
|Characters
|-
|ai_honor
!✓
|character
|int
|<code>ai_honor < 30</code>
|Characters
|-
|ai_rationality
!✓
|character
|int
|<code>ai_rationality < 0</code>
|Characters
|-
|ai_zeal
!✓
|character
|int
|<code>ai_zeal >= 50</code>
|Characters
|-
|always
!✓
|any
|bool
|Can be used to fail the conditions, without needing to comment/delete the code (<code>always = no</code>).
Also used to test if [[scopes]] do or do not exist:
<pre>
NOT = {
    some_scope = {
	always = yes
    }
}
</pre>
If the scope matches nothing, then conditions fails.
|
|Control
|-
|among_most_powerful_vassals
!✓
|character
|int
|Checks if the character is among the nth most powerful vassals of the realm. It compares the character's powerbase with that of all other direct vassals of the same liege. Also see <code>is_powerful_vassal</code> and <code>relative_power</code>. Does not permit the use of 2.8+ comparison operators!
|<code>among_most_powerful_vassals = 5</code>
|Realm
|-
|any_religion_distance
!✓
|province
|int
|Checks if any religion has been generated within the specified distance. Only used in alternate start generation/
|<code>any_religion_distance < 200</code>
|Alternate start
|-
|artifact
!✓
|artifact
|artifact
|(2.8) Checks to see if the scoped artifact is the same as the target artifact.
|<code>artifact = PREV</code>
|Control
|-
|artifact_age
!✓
|artifact
|int
|(2.8) Checks to see if the artifact is older than the specified value. Always returns false if the artifact has no known creation date.
|<code>artifact_age > 10</code>
|Control
|-
|artifact_can_be_gifted_to
!X
|artifact
|character
|(2.8) Checks if the scoped artifact can be gifted to the target character.
|<code>artifact_can_be_gifted_to = ROOT</code>
|Artifacts
|-
|artifact_type
!✓
|artifact
|artifact type
|Checks if the scoped artifact is of the given type
|<code>artifact_type = golden_platypus</code>
|Artifacts
|-
|artifact_type_owned_by
!✓
|artifact
|character
|Checks if the given character owns at least one instance of the scoped artifact.
|<code>artifact_type_owned_by = ROOT</code>
|Artifacts
|-
|attribute_diff
!✓
|character
|clause
|Checks that currently scoped character has at least ''value'' more points in the given ''attribute'', than target character.
|
<pre>
attribute_diff = {
    character = FROM
    attribute = martial
    value >= 9
}
</pre>
|Characters
|-
|at_location
!✓
|character
|character/province/title
|Checks if two characters are in the same location. If target is a title, uses the current location of the titleholder.
|<pre>
at_location = spouse
at_location = k_france
any_courtier = { at_location = ROOT }
NOT = { at_location = 719 }
</pre>
|Provinces
|-
|base_health
!✓
|character
|double
|Checks for hidden attribute base [[health]]
|<code>base_health >= 6</code>
|Health
|-
|bloodline
!X
|bloodline
|bloodline
|Returns true if the current scope <bloodline> is the exact same bloodline as the RHS scope <bloodline>. Note that this compares bloodlines, not bloodline types.
|
|Bloodlines
|-
|bloodline_is_active_for
!✓
|bloodline
|character
|Returns true if current scope <bloodline> is active for <character> on right-hand side.
|
|Bloodlines
|-
|borders_lake
!✓
|province
|bool
|Province borders a lake
|<code>borders_lake = yes</code>
|Provinces
|-
|borders_major_river
!✓
|province
|bool
|Province borders a major river
|<code>borders_major_river = yes</code>
|Provinces
|-
|calc_true_if
!✓
|any
|clause
|Returns true if amount of the triggers in it return true.<ref>[[Forum:774248]]</ref>
|In this example at least 3 of the 5 triggers need to return true:
<pre>
calc_true_if = {
    amount >= 3
    culture = swedish
    religion = catholic
    is_female = no
    is_adult = yes
    age >= 50
}
</pre>
|Control
|-
|can_be_given_away
!✓
|title
|bool
|The title is not occupied, has no holdings being sieged, or contested in war.<br><br>The title is not a capital settlement. (Normally, you'd give it away by giving away the county.)
|<pre>
any_demesne_title = {
    can_be_given_away = yes
}
</pre>
|Titles
|-
|can_change_religion
!✓
|character
|bool
|
|<code>can_change_religion = yes</code>
|Religion
|-
|can_call_crusade
!✓
|character
|bool
|Checks if character is the head of a religion that uses crusades
|<code>can_call_crusade = yes</code>
|Religion
|-
|can_copy_personality_trait_from
!✓
|character
|character
|
|<pre>
ROOT = {
    can_copy_personality_trait_from = PREV
}
</pre>
|Traits
|-
|can_grant_title
!✓
|character
|minor_title
|Checks if scoped ruler can grant at least one target minor title
|can_grant_title = title_commander
|Rulers
|-
|can_land_path_to
!✓
|province
|province/clause
|Checks if it is possible to travel by land between two provinces. Can be expanded to also take a <code>distance</code> parameter.
|<pre>
can_land_path_to = {
    target = event_target:home_capital
    distance < 1000
}
</pre>
|Provinces
|-
|can_naval_path_to
!✓
|province
|province/clause
|Checks if it is possible to travel by sea between two provinces. Both provinces have to be sea or coastal. Can be expanded to also take a <code>distance</code> parameter.
|<pre>can_naval_path_to = c_london</pre>
<pre>can_naval_path_to = { target = c_london distance < 100 }</pre>
|Provinces
|-
|can_have_more_leadership_traits
!✓
|character
|bool
|Checks the limit of leadership trait based on martial education trait (<code>leadership_traits = N</code>)
|
|Traits
|-
|can_hold_title
!✓
|character
|jobTitle/minorTitle
|Checks the conditions for the specified councillor position or minor title.
|<code>can_hold_title = job_marshal</code>
<code>can_hold_title = title_commander</code>
|Characters
|-
|can_join_society
!✓
|character
|society
|Checks if scope character can join the specified society.
|<code>can_join_society = monastic_order_orthodox</code>
|Societies
|-
|can_marry
!✓
|character
|bool/character
|False if the character has any traits with <code>cannot_marry = yes</code>, rules a theocracy of a religion that prohibits priest marriages, or is a member of a holy order.

Also false for characters who are married (even if their religion allows polygamy!) or betrothed.
|
<pre>
AND = {
    can_marry = yes
    is_marriage_adult = yes
}
</pre>
|Marriage
|-
|can_see_secret_religion
!X
|character
|character
|Checks if the character scope you're currently in can see the target character's secret religion.
|
|Religion
|-
|can_swap_job_title
!✓
|character
|character
|Checks if a character can get the job position of another character
|
<pre>
job_chancellor = {
    NOT = { character = ROOT }
    can_swap_job_title = ROOT
}
</pre>
|
|-
|can_use_cb
!✓
|character
|clause
|(2.8) Checks if the specified casus belli would show up and be usable in the UI. Checks everything in the CB itself, plus the extra hardcoded restrictions on regular war declarations.
{|class="wikitable"
!Parameter !! Type !! Description
|-
|target || character/title || Required. What character or title to target.
|-
|casus_belli || CB || Required. What CB to use.
|-
|thirdparty_title || title || Optional. What title to target, if relevant.
|-
|thirdparty || character || Optional. What character to declare war on the behalf of, if relevant.
|-
|only_check_triggers || boolean || Required.
|-
|}
|<pre>can_use_cb = {
    target = d_mecklemburg
    casus_belli = religious
    thirdparty_title = d_mecklemburg
    only_check_triggers = yes
}</pre>
|Wars
|-
|character
!✓
|character
|character/title/int
|Checks if 2 characters are the same.
|<pre>
any_dynasty_member = { 
    limit = { NOT = { character = ROOT } }
}
</pre>
<code>character = c_1234</code>
|Characters
|-
|check_variable
!✓
|character/province
|clause
|Used in conjunction with change_variable command.
|
<pre>
check_variable = {
    which = bob_saget
    value = 4.5
}
</pre>
|Control
|-
|claimed_by
!✓
|title
|character
|
|<pre>
any_demesne_title = {
    claimed_by = ROOT
}
</pre>
|Claims
|-
|clan
!✓
|character,title
|bool
|Whether character is the head of a nomadic clan, or title is a nomadic clan.
|<pre>
any_vassal = {
    clan = yes
}</pre>
|Clans
|-
|clan_opinion
!✓
|character
|clause
|
|<pre>
clan_opinion = {
    who = FROM
    value >= 0
}
</pre>
|Opinion
|-
|clan_opinion_diff
!✓
|character
|clause
|
|<pre>
clan_opinion_diff = {
    first = FROM
    second = PREV
    value >= 0
}
</pre>
|Opinion
|-
|combat_rating
!✓
|character
|int
|Checks combat rating [[modifier]]
|<code>combat_rating >= 0</code>
|Character
|-
|climate
!X
|province
|winter_type
|Check whether a province has a winter climate defined in /map/climate.txt - does NOT check whether province is ''currently'' experiencing a winter, use <code>is_winter</code> for that.
Note that you can only check for winter types (<code>mild_winter</code>, <code>normal_winter</code>, <code>severe_winter</code>), and not for <code>temperate</code> climate; but obviously any province that does not have a winter climate is temperate.
|<code>climate = severe_winter</code>
|Provinces
|-
|combat_rating_diff
!✓
|character
|clause
|Tests combat rating modifier difference with another character
|
<pre>
combat_rating_diff = {
    character = FROM
    value >= 3
}
</pre>
|Character
|-
|completely_controls
!X
|character
|title
|Character controls (personally or via a vassal) all the baronies under specified title. 
Notes: 
*the title itself doesn't need to exist.
*completely_controls is true if title name is invalid.
|
|Rulers
|-
|completely_controls_region
!✓
|character
|region
|Similar to <code>completely_controls</code>
|<code>completely_controls_region = world_steppe</code>
|Rulers
|-
|conquest_culture
!✓
|title
|bool/character
|If yes, only fires if conquest_culture is set (?). Certain CBs set Conquest_Culture (used for cultural conversion events)
|
|Culture
|-
|continent
!X
|province
|continent
|Supplanted by more flexible <code>region</code> trigger, but still works
|
|Provinces
|-
|controlled_by
!✓
|title/province
|character/title
|Checks if province/holding is occupied (war) by another character/realm
|<pre>
any_demesne_province = {
    controlled_by = ROOT
}
</pre>
|Wars
|-
|controls
!X
|character
|province
|Checks if scoped character has province in own demesne and is unsieged, or has sieged down this province. Only takes province ID, so of very limited use.
|<code>controls = 333 # Rome</code>
|Wars
|-
|controls_religion
!✓
|character/title
|bool
|If yes, only picks characters who are the head of their religion (holder of a title with a flag <code>controls_religion = <religion></code>)
|<code>controls_religion = yes</code>
|Religion
|-
|could_be_child_of
!X
|character
|character
|(2.8) Checks if the scoped character is young enough to be the target character's parent. This means that they're at least AGE_OF_MARRIAGE_MALE years younger, and at most MAX_CHILD_BIRTH_AGE years younger if the target is female (for immortal characters, as long as they became immortal before this age they bypass the check). It also checks that they didn't die before the birth date of the scoped character.
|<code>could_be_child_of = ROOT</code>
|Characters
|-
|could_be_parent_of
!✓
|character
|character
|(2.8) Checks if the scoped character is old enough to be the target character's parent. This means that they're at least AGE_OF_MARRIAGE_MALE years older, and at most MAX_CHILD_BIRTH_AGE years older if female (for immortal characters, as long as they became immortal before this age they bypass the check). It also checks that they didn't die before the birth date of the target.
|<code>could_be_parent_of = event_target:displaced_prince</code>
|Characters
|-
|count
!✓
|
|int
|Checks number of elements matched by a scope and some <code>limit</code>. Since [[patch 2.3]] works with all <code>any_</code> scopes. Does not work in traits with <code>cached = yes</code> associated scopes.
|<pre>
any_spouse_even_if_dead = {
    count >= 3
}
</pre>
|Control
|-
|crusade_artifact_pot
!X
|any
|float
|Checks the artifact pot for the on-going new-style Crusade
|<code>crusade_artifact_pot > 10</code>
|Wars
|-
|crusade_gold_pot
!X
|any
|float
|Checks the gold pot for the on-going new-style Crusade
|<code>crusade_gold_pot > 2000</code>
|Wars
|-
|crusade_piety_pot
!X
|any
|float
|Checks the piety pot for the on-going new-style Crusade
|<code>crusade_piety_pot > 1000</code>
|Wars
|-
|crusade_prestige_pot
!X
|any
|float
|Checks the gold pot for the on-going new-style Crusade
|<code>crusade_prestige_pot > 5000</code>
|Wars
|-
|crusade_defense_strength
!X
|any
|float
|Checks the military strength of the defenders to the military strength of the preparing attackers in a new-style Crusade. Doesn't work.
|<code>crusade_defense_strength < 0.75</code>
|War
|-
|crusade_preparation_strength
!✓
|any
|float
|Checks the military strength of the preparing attackers to the military strength of the defenders in a new-style Crusade
|<code>crusade_preparation_strength < 0.75</code>
|War
|-
|crusade_preparation_time_elapsed
!X
|any
|int
|Checks how many days have passed since the preparation of the current new-style Crusade started
|<code>crusade_preparation_time_elapsed < 100</code>
|War
|-
|crusade_preparation_time_remaining
!✓
|any
|int
|Checks how many days remain before the current new-style Crusade will start in earnest
|<code>crusade_preparation_time_remaining > 500</code>
|War
|-
|culture
!✓
|character/province/title
|culture/character/province/title
|Checks if the character has this specific culture
|
|Culture
|-
|culture_group
!✓
|character/province/title
|cultureGroup/character/province/title
|Checks if the character is part of this culture group
|
|Culture
|-
|day_of_birth
!✓
|character
|int
|Checks if the day of the character's date of birth is at least this number.
|<code>day_of_birth >= 18</code>
|Characters
|-
|date
!✓
|General
|date
|Checks the current date
|<code>date < 1234.5.6</code>
|General
|-
|days_at_current_society_rank
!✓
|character
|int
|Checks if scope character has been at current rank in society for the given number of days.
|<code>days_at_current_society_rank >= 1095</code>
|Societies
|-
|days_in_society
!✓
|character
|int
|Checks if scope character has been in a society for the given number of days
|<code>days_in_society > 365</code>
|Societies
|-
|days_since_last_hostile_action
!✓
|war
|clause
|Checks how long ago a character participated in a war, either through combat or siege. Does not support numeric operators.
|<pre>
FROM = {
    ROOT = {
	any_war = {
	    days_since_last_hostile_action = {
		who = PREVPREV
		days = 365
	    }
	}
    }
}
</pre>
|Offmap
|-
|days_since_policy_change
!✓
|offmap
|int
|True if the specified number of days has passed since the last policy change of the scoped offmap power.
|<code>days_since_policy_change < 10950 #30 years</code>
|Offmap
|-
|days_since_status_change
!X
|offmap
|int
|True if the specified number of days has passed since the last status change of the scoped offmap power.
|<code>days_since_status_change > 1</code>
|Offmap
|-
|defending_against_claimant
!✓
|character
|clause
|
|<pre>
defending_against_claimant = {
    character = PREVPREV
    title = ROOT
}
</pre>
|Wars
|-
|demesne_efficiency
!X
|character
|double
|
|
|Rulers
|-
|demesne_garrison_size
!✓
|character
|int
|
|<code>demesne_garrison_size >= 500</code>
|Warfare
|-
|demesne_size
!✓
|character
|int
|Checks if the character has a minimum of this demesne size
|
|Rulers
|-
|demesne_size_compared_to_limit
!✓
|character
|double
|(2.8) Checks if the character's demesne size is proportional to the floating point percentage specified.
|<code>demesne_size_compared_to_limit < 1</code>
|Rulers
|-
|de_facto_liege
!✓
|character/title/province
|character/title
|
|<pre>
ROOT = {
    de_facto_liege = FROM
}
</pre>
|Vassalage
|-
|de_facto_liege_title
!X
|character/title
|character/title
|Checks that the defacto liege title of a character or title is the right-hand side.
|<pre>
ROOT = {
    de_facto_liege_title = e_hre
}
</pre>
|Vassalage
|-
|de_jure_liege
!✓
|character/title/province
|character/title
|Checks whether current scope is a direct de jure vassal of right hand side scope.
|<code>de_jure_liege = e_rajastan</code>
|Vassalage
|-
|de_jure_liege_or_above
!✓
|character/title/province
|character/title
|Checks whether current scope is a de jure vassal of right hand side scope.
|<code>de_jure_liege_or_above = FROM</code>
|Vassalage
|-
|de_jure_vassal_or_below
!✓
|character/title
|character/title
|Checks whether current scope is a de jure liege of right hand side scope.
|<pre>
crusade_target = {
    de_jure_vassal_or_below = FROM
}
</pre>
|Vassalage
|-
|death_reason
!✓
|character
|deathReason
|
|<code>death_reason = death_murder</code>
|Health
|-
|decadence
!✓
|character
|double
|
|<code>decadence >= 90</code>
|Characters
|-
|disease
!✓
|province
|disease
|Checks if the province has the specified disease.
|<code>disease = bubonic_plague</code>
|Provinces
|-
|disease_defence
!X
|province
|float
|Checks if the province has at least the specified disease defence modifier.
|<code>disease_defence > 0.1</code>
|Provinces
|-
|disliked_by_offmap
!✓
|character
|clause
|Checks whether the scoped character matches the current "dislike" of the offmap power of the specified ''type''.  If the "dislike" trigger has a context, the ''context'' parameter must match to return true.  If the "dislike" trigger has no context, the context parameter must be omitted to return true.
|<pre>
disliked_by_offmap = {
    type = offmap_china
    context = eunuch
}
</pre>
|Offmap
|-
|difficulty
!X
|any
|int/string
|The game difficulty
|
|Control
|-
|diplomacy
!✓
|character
|int
|The character's Diplomacy attribute. For state value, see <code>realm_diplomacy</code>
|
|Characters
|-
|diplomatic_immunity
!✓
|character
|bool
|Checks if character has the diplomatic_immunity flag, protecting him from hostile actions.
|
|Characters
|-
|dislike_tribal_organization
!✓
|character/title
|bool
|Checks for dislike_tribal_organization religion flag
|<code>dislike_tribal_organization = no</code>
|Religion
|-
|distance
!✓
|character/province
|clause
|Determines the minimum [[distance]] from the scope. If used with NOT, it becomes maximum distance. Distances are pixels within the main map images & positions.txt
|<pre>
distance = {
    who = ROOT
    value >= 100
}
distance = {
    where = PREV
    distance < 1000
}
</pre>
|Provinces
|-
|distance_from_realm
!✓
|character
|clause
|
|<pre>
distance_from_realm = {
    who = FROM
    value = 20
}
</pre>
|Provinces
|-
|dynastic_prestige
!X
|character
|int
|Checks if the character's dynasty has a dynastic prestige of at least this amount.
|<code>dynastic_prestige >= 100</code>
|Family
|-
|dynasty
!✓
|character
|character/int/no/none
|The character's dynasty, indexed by an integer value. Lowborn (no dynasty) match ''none'' or ''no'' value.
|<pre>
dynasty = none
dynasty = ROOT
</pre>
|Family
|-
|dynasty_realm_power
!✓
|character
|double
|
|<pre>
top_liege = {
    dynasty_realm_power >= 0.25
}
</pre>
|Family
|-
|excommunicated_for
!✓
|character
|character
|
|<pre>
top_liege = {
    excommunicated_for = ROOT
}
</pre>
|Religion
|-
|faction_exists
!X
|character
|clause
|
|<pre>
faction_exists = {
    faction = faction_succ_seniority
    title = PREV
    thirdparty = FROM
}
</pre>
|Factions
|-
|faction_power
!✓
|character
|clause
|
|<pre>
faction_power = {
    faction = faction_succ_seniority
    power >= 1.0
}
</pre>
|Factions
|-
|family
!✓
|character
|character/title/bool
|Alias for <code>dynasty</code>
|<pre>
any_vassal = {
    family = ROOT
}
</pre>
|Family
|-
|father_of_unborn_known
!✓
|character
|bool
|Checks if a pregnant woman's unborn child has a known father.
|
|Family
|-
|fertility
!✓
|character
|double
|The character's fertility value. In-game, can only be seen through the "charinfo" console command.
|
|Characters
|-
|flank_has_leader
!✓
|battle
|bool
|Used in combat tactics
|
|Wars
|-
|flank_has_tactic
!X
|Combat
|combat tactic
|
|
|Wars
|-
|fort_has_building
!X
|province
|building
|Checks if a fort has the specified building.
|<code>fort_has_building = <fo_some_building></code>
|Buildings
|-
|fort_has_any_building
!X
|province
|building
|Checks if a fort has at least 1 building.
|
|Buildings
|-
|free_court_slots
!✓
|character
|int
|Checks how many free court slots a ruler has
|<code>free_court_slots < -10</code>
|Rulers
|-
|from_ruler_dynasty
!✓
|character
|bool
|
|<code>from_ruler_dynasty = yes</code>
|Family
|-
|government
!✓
|character
|government, title, character, province
|Check government type of a character. For checking government groups, see <code>is_feudal</code>, <code>is_republic</code>, etc. Provinces must be by relative scope or saved event target, since numbers are interpreted as character IDs.
|<pre>
government = nomadic_government
government = k_norway
government = ROOT
</pre>
|Government
|-
|graphical_culture
!✓
|character
|culturegfx
|A character's graphical culture. This is different from the effect set_graphical_culture which takes a culture, not a culturegfx. In-game, can only be seen through the "charinfo" console command. '''Fixed in 2.8.''' (In 2.7 and earlier, checking against an invalid culturegfx will cause a CTD.)
|<code>graphical_culture = norsegfx</code>
|Characters
|-
|had_artifact_flag
!X
|character
|clause
|(2.8) Before 3.0 <code>months</code> and <code>years</code> do not work as parameters, only <code>days</code> does.
|
|Control
|-
|had_bloodline_flag
!X
|bloodline
|clause
|Returns true if the current scope <bloodline> has had the script flag for the defined time period
{|class="wikitable"
!Parameter !! Type !! Description
|-
|flag || flag || Obligatory, flag to be checked
|-
|years/months/days || int || Obligatory, time since the flag should have been set
|-
|}
|
|Control
|-
|had_character_flag
!✓
|character
|clause
|Evaluates to true if the character has had that flag for the specified number of days. Before 3.0 <code>months</code> and <code>years</code> do not work as parameters, only <code>days</code> does.
|<pre>
had_character_flag = {
    flag = money_from_the_pope
    years >= 2
}
</pre>
|Control
|-
|had_dynasty_flag
!X
|character
|clause
|Note: ''months'' and ''years'' do not work as parameters, only ''days'' does.
|
|Control
|-
|had_flag
!✓
|any with flags
|clause
|Checks if the current scope has had a given flag for a given time in days, months or years. Works for any scope that can store flags, unlike the more specific <code>had_''scope''_flag</code> triggers.
|<pre>
had_flag = {
    flag = used_legendary_gathering
    years >= 100
}
</pre>
|Control
|-
|had_global_flag
!✓
|any
|clause
|Before 3.0 <code>months</code> and <code>years</code> do not work as parameters, only <code>days</code> does.
|<pre>
had_global_flag = {
    flag = crusade_called
    months >= 6
}
</pre>
|Control
|-
|had_province_flag
!✓
|province
|clause
|Before 3.0 <code>months</code> and <code>years</code> do not work as parameters, only <code>days</code> does.
|<pre>
had_province_flag = {
    flag = aztec_explorers
    years >= 2
}
</pre>
|Control
|-
|had_offmap_flag
!X
|offmap
|clause
|Checks whether the offmap power previously had the specified ''flag'' for the specified amount of time. Does not appear to be functioning as of at least version 3.3.0. Use <code>had_flag</code> instead.
|<pre>
had_offmap_flag = {
    flag = busy
    months >= 1
}
</pre>
|Offmap
|-
|had_offmap_tmp_flag
!✓
|offmap
|clause
|Checks if the specified temporary flag added by script to the scoped offmap power, NOT including those defined in the offmap status or policy files, has been present for the specified amount of time.
|<pre>
had_offmap_tmp_flag = {
    flag = busy
    years < 2
}
</pre>
|Offmap
|-
|had_title_flag
!✓
|title
|clause
|Before 3.0 <code>months</code> and <code>years</code> do not work as parameters, only <code>days</code> does.
|<pre>
had_title_flag = {
    flag = xxx
    years >= 2
}
</pre>
|Control
|-
|has_alternate_start_setting</br>
has_alternate_start_parameter
!✓
|any
|clause
|Checks specified settings/parameters used in alternate world generation.
|<pre>
has_alternate_start_setting = {
    setting = shattered_cbs
    option = on_limited
}

has_alternate_start_setting = {
    setting = age_span
    max == 0
    min == 0
}

has_alternate_start_parameter = {
    key = religion_names
    value = random
}
</pre>
|Control
|-
|has_ambition
!✓
|character
|bool/objective
|
|<code>has_ambition = obj_improve_martial</code>
|Objectives
|-
|has_any_building
!✓
|title
|bool
|Checks if the holding has any building
|<code>has_any_building = yes</code>
|Holdings
|-
|has_any_opinion_modifier
!✓
|character
|modifier
|Similar to <code>has_opinion_modifier<code>.
|<code>has_any_opinion_modifier = opinion_seducing_concubine<code>
|Characters
|-
|has_any_quest
!✓
|character
|bool
|Checks whether or not the scoped character has any quests
|<code>has_any_quest = yes</code>
|Characters
|-
|has_any_symptom
!X
|character
|bool
|Checks if scoped character has any traits with <code>is_symptom = yes</code>.<br/> <code>has_any_symptom = no</code> does not work, use <code>NOT = { has_any_symptom = yes }</code> instead.
|<code>has_any_symptom</code>
|Health
|-
|has_artifact
!✓
|character
|artifact
|Checks if the scoped character owns an artifact by that name.
|<code>has_artifact = necronomicon<code>
|Artifacts
|-
|has_artifact_flag
!✓
|artifact
|flag
|Checks if the scoped artifact has the given flag defined.
|<code>has_artifact_flag = crown_jewel</code>
|Artifacts
|-
|has_assigned_minor_title
!✓
|character
|minorTitle/clause
|Checks to see if the character has assigned a particular minor title, or at least how many of them
|<pre>
has_assigned_minor_title = title_master_of_the_horse

has_assigned_minor_title = {
    title = title_commander
    count >= 2
}</pre>
|Characters
|-
|has_autocephaly
!✓
|character
|bool
|Checks for religion autocephaly = yes
|<code>has_autocephaly = yes</code>
|Religion
|-
|has_bloodline_flag
!✓
|bloodline
|string
|Checks if a bloodline has a specified flag. <br/>'''Note:''' "flags" in CKII scripting are not pre-determined or stored anywhere, they are dynamically created in the script. A mistyped flag will not be caught by the Validator, as there are no "invalid" flags.
|<code>has_bloodline_flag = created_bloodline</code>
|Control
|-
|has_blood_oath_with
!✓
|character
|character
|
|<code>has_blood_oath_with = ROOT</code>
|Clans
|-
|has_building
!✓
|title (barony only),province
|building
|Checks if a holding has the specified building (under construction buildings do not count).
|<pre>
family_palace = {
    has_building = fp_mansion_4
}
</pre>
|Holdings
|-
|has_called_crusade
!✓
|character
|bool
|
|
|Religion
|-
|has_capital
!X
|province
|bool
|
|
|Province
|-
|has_castle
!✓
|province
|bool
|Checks if a province has a castle holding
|<code>has_castle = yes</code>
|Province
|-
|has_cb
!X
|character
|character
|Checks if scoped character can use any CB against target character
|<code>has_cb = FROM</code>
|Rulers
|-
|has_character_flag
!✓
|character
|string
|Checks if a character has a specified flag. <br/>'''Note:''' "flags" in CKII scripting are not pre-determined or stored anywhere, they are dynamically created in the script. A mistyped flag will not be caught by the Validator, as there are no "invalid" flags.
|
|Control
|-
|has_character_modifier
!✓
|character
|modifier
|Checks if the character has a [[modifiers|modifier]] 
|<code>has_character_modifier = illumination</code>
|Modifiers
|-
|has_children
!✓
|character
|bool
|Checks if the character has children. Functionally identical to <code>num_of_children >= 1</code>.
|<code>has_children = yes</code>
|
|-
|has_city
!✓
|province
|bool
|Checks if a province has a city holding
|<code>has_city = yes</code>
|Province
|-
|has_claim
!✓
|character
|title
|
|<code>has_claim = k_papal_state</code>
|Claims
|-
|has_council
!✓
|character
|bool
|
|<pre>
liege = {
    has_council = yes
}
</pre>
|Council
|-
|has_councilor_faction_join_restriction
!✓
|character
|bool
|Used in conjunction with <code>set_councilor_faction_join_restriction</code>
|<pre>
liege = {
    has_councilor_faction_join_restriction = yes
}
</pre>
|Council
|-
|has_concubinage
!✓
|character
|bool
|Checks if religion flag max_consorts > 0
|<code>has_concubinage = yes</code>
|Religion
|-
|has_crown_law_title
!✓
|title
|bool
|Used to check crown laws for a specified title. Is not a condition itself though, it must be used as a scope to check crown laws by category (succession, for instance).
|
|Government
|-
|has_crusade_war_started
!X
|character/title/province/society/religion
|bool
|Checks if the scope's religion has an ongoing new-style Crusade. Also see <code>is_preparing_crusade</code>.
|<code>has_crusade_war_started = yes</code>
|Wars
|-
|has_custom_description
!X
|wonder
|bool
|True if the wonder has a description set by history
|<code>has_custom_description = yes</code>
|Wonders
|-
|has_custom_name
!✓
|wonder
|bool
|True if the wonder has a name set by the player or by history
|<code>has_custom_name = yes</code>
|Wonders
|-
|has_de_jure_pretension
!✓
|title
|character
|
|<pre>
any_demesne_title = {
    has_de_jure_pretension = ROOT
}
</pre>
|Rulers
|-
|has_disease
!✓
|character/province
|bool
|
|
<pre>
any_courtier = {
    has_disease = yes
}
</pre>
|Health
|-
|has_dlc
!✓
|any
|string
|Checks if the user has a specified DLC. Values: "The Sword of Islam", "Legacy of Rome", "Sunset Invasion", "The Republic", "The Old Gods", "Sons of Abraham", "Rajas of India", "Charlemagne", "Way of Life", "Horse Lords", "Zeus" or "Conclave" (both are equivalent), "Reapers", "Mystics", "Jade Dragon", or "Holy Fury".
|<code>has_dlc = "Charlemagne"</code>
|Control
|-
|has_dynasty_flag
!✓
|character
|flag
|
|<code>has_dynasty_flag = strange_chest</code>
|Control
|-
|has_dynasty_modifier
!✓
|character
|modifier
|Checks if a character's dynasty has the specified modifier
|<code>has_dynasty_modifier = ruling_in_crusader_kingdom</code>
|Control
|-
|has_earmarked_regiments
!✓
|character
|flag
|Set via spawn_unit command and earmark parameter. 
|<code>has_earmarked_regiments = conscripted_merchant_ships</code>
|Control
|-
|has_earmarked_regiments_not_raiding
!✓
|character
|flag
|Check for earmark & raiding
|<code>has_earmarked_regiments_not_raiding = tribal_organize_raid</code>
|Control
|-
|has_elector_stance
!✓
|character
|clause
|Checks elector stance for a title's Eldership election
|
<pre>
has_elector_stance = {
    title = FROMFROM
    stance = ecstatic
}
</pre>
|Elections
|-
|has_embargo
!✓
|character
|character
|
|<code>NOT = { has_embargo = FROM }</code>
|Wars
|-
|has_empty_holding
!✓
|province
|bool
|
|
<pre>
any_demesne_province = {
    has_empty_holding = yes
}
</pre>
|Provinces
|-
|has_epidemic
!✓
|character/province
|bool
|Checks for a trait with <code>is_epidemic = yes</code>, and checks if a province has an epidemic.
|
<pre>
any_child = {
    has_epidemic = yes
}

capital_scope = {
    has_epidemic = yes
}
</pre>
|Health
|-
|has_feud_with
!✓
|character
|character
|
|<code>has_feud_with = ROOT</code>
|Clans
|-
|has_flag
!✓
|any with flags
|flag
|Checks if the current scope has a given flag. Works for any scope that can store flags, unlike the more specific <code>has_''scope''_flag</code> triggers.
|
|Control
|-
|has_focus
!✓
|character
|focus
|Checks for [[focuses]]
|<code>has_focus = focus_war<code>
|Objectives
|-
|has_fort
!X
|province
|bool
|Checks whether a province has a fort
|<code>has_fort = yes</code>
|Provinces
|-
|has_full_court
!✓
|character
|bool
|Checks if scoped character has no free court slots left
|<code>has_full_court = yes<code>
|Rulers
|-
|has_game_rule
!✓
|any
|clause
|Checks if a [[game rule]] is active. See [[game rules modding]].
|<pre>
has_game_rule = {
    name = gender
    value = all
}
</pre>
|Control
|-
|has_game_started
!✓
|any
|bool
|Checks if the game is in the pre-game character selection screen.
|<code>has_game_started = yes</code>
|Control
|-
|has_global_flag
!✓
|any
|flag
|See [[flag]]s.
|<code>has_global_flag = found_the_holy_grail</code>
|Control
|-
|has_guardian
!✓
|character
|bool
|
|
<pre>
any_child = {
    has_guardian = no
}
</pre>
|Guardianship
|-
|has_had_offmap_name
!X
|offmap
|loc
|
|<code>has_had_offmap_name = liao_china</code>
|Offmap
|-
|has_heresies
!✓
|character/province
|bool
|
|
|Religion
|-
|has_higher_tech_than
!✓
|province
|province/character
|
|<pre>
location = {
    has_higher_tech_than = ROOT
}
</pre>
|Provinces
|-
|has_holder
!✓
|title
|bool
|Checks whether a title is currently hold by a character.
|
<pre>
any_claim = {
    has_holder = yes
}
</pre>
|Titles
|-
|has_hospital
!✓
|province
|bool
|Checks whether a province has a hospital
|<code>has_hospital = yes</code>
|Provinces
|-
|has_holding_modifier
!✓
|title
|modifier
|Checks if the holding has the given [[modifiers|holding modifier]]
|
<pre>
any_province_holding = {
    has_holding_modifier = recently_burnt_the_land
}
</pre>
|Modifiers
|-
|has_horde_culture
!✓
|character
|bool
|Check for hord flag from culture definition
|
|Culture
|-
|has_inheritance_blocker
!X
|character
|bool
|Checks if the character in the current scope has a trait that blocks inheritance (cannot_inherit = yes)
|
|-
|has_instances_of_character_modifier
!✓
|character
|modifier
|Checks if the character has amount of times the given [[modifiers|character modifier]]
|
<pre>
has_instances_of_character_modifier = {
    name = x
    amount == y
}
</pre>
|Modifiers
|-
|has_instances_of_holding_modifier
!X
|title
|modifier
|Checks if the holding has a amount of times the given [[modifiers|holding modifier]]
|
<pre>
has_instances_of_holding_modifier = {
    modifier = x
    amount < y
}
</pre>
|Modifiers
|-
|has_instances_of_province_modifier
!X
|province
|modifier
|Checks if the province has a amount of times the given [[modifiers|province modifier]]
|
<pre>
has_instances_of_province_modifier = {
    name = x
    amount >= y
}
</pre>
|Modifiers
|-
|has_job_action
!✓
|character
|bool/jobAction
|
|<code>has_job_action = action_improve_relations</code>
|Jobs
|-
|has_job_title
!✓
|character
|jobTitle/bool
|Checks that character is a councillor.
|<code>has_job_title = job_chancellor</code>
|Jobs
|-
|has_known_creation_date
!X
|artifact
|bool
|(2.8) Checks if the artifact has a creation date on record.
|
|Artifacts
|-
|has_landed_title
!✓
|character
|bool/title
|
|<code>has_landed_title = k_jerusalem</code>
|Titles
|-
|has_law
!✓
|character/title
|law
|
|<pre>
has_law = succ_feudal_elective
has_law = agnatic_succession
</pre>
|Government
|-
|has_liege_enforced_peace
!✓
|character
|bool
|Prevents wars, also see <code>will_liege_enforce_peace</code>.
|<code>has_liege_enforced_peace = no</code>
|Realm
|-
|has_living_children
!X
|character
|bool
|Checks if the character has living children.
|<pre>
any_dynasty_member = {
    has_living_children = yes
}
</pre>
|
|-
|has_lover
!✓
|character
|bool
|Yes if the character has a lover
|
|Marriage
|-
|has_mercenary_band
!✓
|title
|bool
|Checks if character has already created a mercenary band.
|<code>has_mercenary_band = yes</code>
|
|-
|has_mercenary_maintenance_modifier
!✓
|title
|modifier
|Checks for a static modifier added via <code>set_mercenary_maintenance_modifier</code> on scoped mercenary tile.
|<code>has_mercenary_maintenance_modifier = maintaining_mercenary_band</code>
|Modifiers
|-
|has_minor_title
!✓
|character
|minorTitle/bool
|Yes if the character has a minor title. Also includes religion titles.
|<code>has_minor_title = title_court_jester</code>
|Characters
|-
|has_newly_acquired_titles
!✓
|character
|bool
|Character holds titles he just recently acquired
|
|Titles
|-
|has_nickname
!✓
|character
|bool/nickname
|Can be used to check for a specific nickname, or (not) having any nickname.
|<pre>
has_nickname = nick_the_bastard
has_nickname = no
</pre>
|Characters
|-
|has_non_aggression_pact_with
!✓
|character
|character
|Checks if a character a non-aggression pact with another character.
|<code>has_non_aggression_pact_with = ROOT</code>
|
|-
|has_objective
!X
|character
|objective
|Deprecated, replaced by <code>has_ambition/has_plot</code>
|
|Objectives
|-
|has_offmap_currency
!✓
|character
|clause
|Whether the character has at least ''value'' currency in the specified ''offmap'' ID.
|<pre>
has_offmap_currency = {
    offmap = offmap_china
    value >= 10
}
</pre>
|Offmap
|-
|has_offmap_flag
!✓
|offmap
|string
|Checks if the specified temporary flag was added to the scoped offmap power, or if the scoped power's current status or policy has the flag included by default in its flags = { } array.
|<code>has_offmap_flag = disallow_interactions</code>
|Offmap
|-
|has_offmap_name
!✓
|offmap
|loc
|Checks if the scoped offmap power has the specified localisation key as its current name.
|<code>has_offmap_name = liao_china</code>
|Offmap
|-
|has_offmap_news_enabled
!✓
|character
|offmap
|Checks if the player ruler has chosen to receive news events from the specified offmap power through the interface.
|<code>has_offmap_news_enabled = offmap_china</code>
|Offmap
|-
|has_offmap_tmp_flag
!✓
|offmap
|string
|Checks if the specified temporary flag was added by script to the scoped offmap power, NOT including those defined in the offmap status or policy files.
|<code>has_offmap_tmp_flag = china_invaded_player_dynasty</code>
|Offmap
|-
|has_opinion_modifier
!✓
|character
|clause
|Checks if the scoped character has the given [[modifiers|opinion modifier]] towards 'who' character
|
<pre>
has_opinion_modifier = {
    who = ROOT
    name = i_attempted_murder
}
</pre>
|Opinion
|-
|has_overseas_holdings
!✓
|character
|bool
|
|
|Rulers
|-
|has_owner
!✓
|province
|bool
|
|
<pre>
any_neighbor_province = {
  has_owner = yes
}
</pre>
|Rulers
|-
|has_pentarchy
!X
|religion/character/province
|bool
|Checks for whether the associated religion has a pentarchy. Works with anything that has a religion
|<code>has_pentarchy = yes</code>
|Religion
|-
|has_pledged_crusade_defense
!X
|character
|bool
|Checks if a character has pledged defense for the new-style Crusade being planned
|<code>has_pledged_crusade_participation</code>
|Wars
|-
|has_pledged_crusade_participation
!✓
|character
|bool
|Checks if a character has pledged participation for the new-style Crusade being planned
|<code>has_pledged_crusade_participation</code>
|Wars
|-
|has_plot
!✓
|character
|plot/bool
|
|
<pre>
has_plot = yes

any_courtier = {
    has_plot = plot_kill_character
}
</pre>
|Objectives
|-
|has_policy
!✓
|offmap
|policy
|Checks if the scoped offmap power currently has the specified offmap policy (defined in /common/offmap_powers/policies).
|<code>has_policy = china_isolationist</code>
|Offmap
|-
|has_policy_flag
!X
|offmap
|flag
|Checks if the scoped offmap power's current policy has the specified flag (defined in /common/offmap_powers/policies).
|<code>has_policy_flag = disallow_interactions</code>
|Offmap
|-
|has_polygamy
!✓
|character
|bool
|Checks if religion flag max_wives > 0
|<code>has_polygamy = yes</code>
|Religion
|-
|has_portrait_property
!✓
|character
|clause
|Checks if a character has a given portrait property/overlay/etc.
|<pre>
has_portrait_property = {
    layer = 6
    index = 1
}
</pre>
|Characters
|-
|has_position
!✓
|character
|attitude/character
|Checks the voting attitude of a councillor, or if same as another character. Also see <code>is_voter</code>. Not to be confused with <code>has_minor_title</code> or <code>has_job_title</code>.
|<code>has_position = loyalist</code>
|Council
|-
|has_pressed_claim
!X
|character
|title
|True if the character has a pressed claim (i.e., a non-heritable weak or strong claim created through Fabricate Claims) on the target title.
|<code>has_pressed_claim = k_papal_state</code>
|Claims
|-
|has_province_flag
!✓
|province
|flag
|
|<code>has_province_flag = heresy_in_province
|Control
|-
|has_province_modifier
!✓
|province
|modifier
|Checks if the province has the given [[modifiers|province modifier]]
|
<pre>
any_realm_province = {
    has_province_modifier = heretic_stronghold
}
</pre>
|Modifiers
|-
|has_quest
!✓
|character
|quest_name
|Checks if the scoped character has a quest with the given quest_name.
|
<code>has_quest = quest_indian_monastic_order_pilgrimage</code>
|Societies
|-
|has_raised_levies
!✓
|character
|character
|Whether character has some personal levies (vassal levies do not count)
|
<pre>
liege = {
    has_raised_levies = ROOT
}
</pre>
|Wars
|-
|has_raised_standing_troops
!✓
|title
|bool
|
|
<pre>
primary_title = {
    has_raised_standing_troops = no
}
</pre>
|Wars
|-
|has_regent
!✓
|character
|bool
|
|<pre>
liege = {
    has_regent = no
}
</pre>
|Titles
|-
|has_regiments
!✓
|character
|bool
|
|<code>has_regiments = no</code>
|Wars
|-
|has_religion_feature
!✓
|character
|feature
|Checks if character religion has a specific feature
|<code>has_religion_feature = religion_equal</code>
|Religion
|-
|has_religion_features
!✓
|any
|bool
|Detects if religion features are enabled in the current game (usually dependent on whether or not Holy Fury is active)
|<code>has_religion_features = no</code>
|Religion
|-
|has_secret_religion
!✓
|character
|bool
|Checks if character secretly follows another religion
|<code>has_secret_religion = yes<code>
|Religion
|-
|has_selected_religion_feature
!✓
|character
|religion feature
|Checks if a religion feature has been selected in the reformation screen
|<code>has_selected_religion_feature = religion_syncretic<code>
|Religion
|-
|has_settlement_construction
!✓
|province
|bool
|Checks if a holding is under construction in the province
|<pre>
NOR = {
    num_of_settlements >= 5
    AND = {
	num_of_settlements >= 4
	has_settlement_construction = yes
    }
}
</pre>
|Holdings
|-
|has_siege
!✓
|title(holding)
|bool
|Holding is under siege.
|<code>has_siege = no</code>
|Wars
|-
|has_space_for_retinue
!X
|character
|retinue_type
|Checks if character has enough unused retinue cap for target retinue type
|<code>has_space_for_retinue = RETTYPE_CUL_HUNG</code>
|Retinues
|-
|has_started_building_wonder
!✓
|province/character/wonder
|bool/wonder type
|Checks if a province/character has started  building a tier/stage of a wonder. Can check particular wonders as well. Is not affected by pausing
|<code>has_started_building_wonder = yes/no/<wonder type name></code>
|Wonders
|-
|has_started_building_wonder_upgrade
!X
|province/character/wonder/upgrade
|bool/upgrade type
|Checks if a wonder has started constructing an upgrade. Can check particular wonder upgrades as well. Is not affected by pausing
|<code>has_started_building_wonder_upgrade = yes/no/<upgrade name></code>
|Wonders
|-
|has_status
!✓
|offmap
|status
|Checks if the scoped offmap power currently has the specified offmap status modifier (defined in /common/offmap_powers/statuses).
|<code>has_status = china_unrest</code>
|Offmap
|-
|has_status_flag
!X
|offmap
|string
|Checks if the scoped offmap power has the specified flag in its current offmap status modifier's <code>flags</code> list.
|<code>has_status_flag = disallow_interactions</code>
|Offmap
|-
|has_strong_claim
!✓
|character
|title
|
|
|Claims
|-
|has_strong_pressed_claim
!X
|character
|title
|True if the character has a strong pressed claim (i.e., a non-heritable strong claim) on the target title.
|<code>has_strong_pressed_claim = k_papal_state</code>
|Claims
|-
|has_temple
!X
|province
|bool
|Checks if a province has a temple holding
|<code>has_temple = yes</code>
|Province
|-
|has_terrain_specialization
!X
|character
|terrain/any/bool
|Checks for traits with terrain command modifiers
|
|Traits
|-
|has_title_flag
!✓
|title
|flag
|
|
|Control
|-
|has_trade_post
!✓
|province/title?
|bool
|
|
|Provinces
|-
|has_tribal
!✓
|province
|bool
|Checks if a province has a tribal holding
|<code>has_tribal = yes</code>
|Province
|-
|has_truce
!X
|character
|character
|
|
|Wars
|-
|has_weak_claim
!✓
|character
|title
|
|
|Claims
|-
|has_weak_pressed_claim
!X
|character
|title
|True if the character has a weak pressed claim (i.e., a non-inheritable claim) on the target title.
|<code>has_weak_pressed_claim = k_papal_state</code>
|Claims
|-
|has_wonder
!✓
|province/character/wonder
|bool/wonder type
|Checks if the scoped character is the current owner of any wonders, or if the scoped province contains any wonders. Can check particular wonders as well. Only applies for wonders that have completed first stage.
|<code>has_wonder = yes/no/<wonder type></code>
|Wonders
|-
|has_wonder_flag
!✓
|wonder
|string
|Checks if a wonder has a given flag.
|<code>has_wonder_flag = <flag name></code>
|Wonders
|-
|has_wonder_upgrade
!✓
|province/character/wonder/upgrade
|bool/upgrade type
|Checks if a wonder upgrade has a particular upgrade, or if it has any whatsoever.
|<code>has_wonder_upgrade = yes/no/<upgrade name></code>
|Wonders
|-
|has_wonder_upgrade_flag
!✓
|wonder/upgrade
|string
|Checks if a wonder upgrade has a given flag.
|<code>has_wonder_upgrade_flag = <flag name></code>
|Wonders
|-
|health
!✓
|character
|int
|A character's health value. In-game, can only be seen through the "charinfo" console command.
|
|Health
|-
|health_traits
!✓
|character
|int
|Number of traits with <code>is_health = yes</code>
|<code>health_traits >= 1</code>
|Traits
|-
|held_favor_activated_on
!X
|character
|character/title/province
|Checks if scoped character held a favor activated on target character. The reverse condition is <code>owed_favor_activated_on</code>. Province scopes must be relative or saved event targets, since numbers are interpreted as character IDs.
|<pre>
liege = {
    held_favor_activated_on = FROM
</pre>
|Characters
|-
|held_title_rating
!✓
|character
|character, int
|
|<code>held_title_rating >= FROM</code>
|Titles
|-
|higher_real_tier_than
!✓
|character
|character/tier
|Same as ''higher_tier_than'' but ignores temporary titles
|
|Tier
|-
|higher_tier_than
!✓
|character/title
|character/tier/title
|Check that the tier of scoped character/title is strictly higher than the given tier.
|<pre>
primary_title = {
    higher_tier_than = BARON
}
</pre>
|Tier
|-
|historical
!✓
|character
|bool
|Checks if character is historical (either by being scripted in character history, or created as historical by script), or part of an ongoing event chain
|<code>historical = yes</code>
|Characters
|-
|holder
!✓
|title
|character
|Checks if title is held by target character
|<code>holder = ROOT</code>
|Titles
|-
|holding_diff
!✓
|character
|clause
|
|<pre>
holding_diff = {
    first_type = city
    first_count_vassals = yes
    second_type = none
    value >= 1.5
}
</pre>
|Holdings
|-
|holding_type
!✓
|Title (county/barony)/province
|string
|city / temple / castle / tribal / nomad / family_palace
|
|Holdings
|-
|hospital_has_any_building
!X
|province
|bool
|Checks if the hospital of the province has any buildings.
|
|Buildings
|-
|-
|hospital_has_building
!✓
|province
|building
|Checks if a hospital has the specified building.
|<code>hospital_has_building = library_1</code>
|Buildings
|-
|hospital_level
!✓
|province
|int
|Checks the hospital level of a province.
|<code>hospital_level >= 2</code>
|Provinces
|-
|holding_garrison_percent
!X
|holding
|float
|Checks how full the holding's garrison is. 1 is 100%, 0 is 0%.
|<code>holding_garrison_percent < 1</code>
|Holdings
|-
|holding_raisable_levy_percent
!X
|holding
|float
|Checks how full the holding's raisable levy is. 1 is 100%, 0 is 0%.
|<code>holding_raisable_levy_percent < 1</code>
|Holdings
|-
|holding_total_levy_percent
!✓
|holding
|float
|Checks how full the holding's total levy (garrison + raisable) is. 1 is 100%, 0 is 0%.
|<code>holding_total_levy_percent < 1</code>
|Holdings
|-
|holds_favor_on
!✓
|character
|character
|Checks if a character holds a favor toward another character. The reverse condition is <code>owes_favor_to</code>.
|<pre>
liege = {
    holds_favor_on = ROOT
}
</pre>
|Characters
|-
|holy_order
!✓
|character/title
|bool
|
|<pre>
primary_title = {
    holy_order = no
}
</pre>
|Titles
|-
|holy_site_distance
!✓
|province/title
|character/religion/title/province/society
|Checks distance to the nearest holy site of the target scope
|<pre>
holy_site_distance = {
    target = FROM
    value > 500
}
</pre>
|Titles
|-
|immortal
!✓
|character
|bool
|Checks if the character has a trait with <code>immortal = yes</code>
|<code>immortal = no</code>
|Health
|-
|immortal_age
!✓
|character
|int
|Checks which age at which a character became immortal. Always false for mortal characters
|<code>immortal_age > 40</code>
|Health
|-
|imprisoned_days
!✓
|character
|int
|
|<pre>
any_courtier = {
    imprisoned_days >= 100
}
</pre>
|Characters
|-
|independent
!✓
|character
|bool
|Checks if ruler is independent and not in revolt
|
|Rulers
|-
|infamy
!X
|character
|double
|[[Threat]]
|<code>infamy >= 12.5</code>
|Wars
|-
|intrigue
!✓
|character
|int
|A character's Intrigue stat.
|
|Characters
|-
|in_battle
!✓
|character
|bool
|
|
|Wars
|-
|in_coalition_against
!X
|character
|character/title/province
|Checks if scoped character is in a coalition against of the target character or ruler of target title/province. Province scopes must be relative (ROOT/FROM) or saved event targets, since numbers are interpreted as character IDs.
|<pre>
in_coalition_against = FROM
in_coalition_against = e_hre
</pre>
|Characters
|-
|in_command
!✓
|character
|bool
|Character is leading troops.
|
|Characters
|-
|in_faction
!✓
|character
|bool/faction
|
|<code>in_faction = faction_independence</code>
|Factions
|-
|in_revolt
!✓
|character
|bool
|
|<pre>
liege = {
    in_revolt = no
}
</pre>
|Titles
|-
|in_seclusion
!✓
|character
|bool
|Checks if scoped character has ''in_seclusion'' character modifier (?)
|<code>in_seclusion = yes</code>
|Titles
|-
|in_siege
!✓
|character
|bool
|
|<code>in_siege = no</code>
|Wars
|-
|interested_in_society
!✓
|character
|bool
|Check if the character is interested in the society with the given tag.
|<code>interested_in_society = the_cult_of_kali</code>
|Societies
|-
|interested_in_society_of_character
!✓
|character
|character
|(2.8) Check if the character is interested in the society that the target character is a member of.
|<code>interested_in_society_of = ROOT</code>
|Societies
|-
|is_abroad
!✓
|character
|bool
|Valid if character is 'abroad' (not at liege's court)
|
|Characters
|-
|is_active
!✓
|wonder/upgrade
|bool
|
|<code>is_active = yes</code>
|Wonders
|-
|is_adult
!✓
|character
|bool
|Checks if the character is an adult.
|
|Characters
|-
|is_alive
!✓
|character
|bool
|If yes, will only affect alive characters
|
|Health
|-
|is_allied_with
!✓
|character
|character
|Checks for [[alliances]] and [[tributary]] relationships. Does not check for being temporary war allies. Expensive calculation, use with care<ref>[[Forum:774248]]</ref>
|
|Wars
|-
|is_allowed_holding_type
!✓
|title(holding)
|character
|Checks if holding type is allowed by the government of specified character. Uses de jure capital for titles above count-tier, uses county capital holding for titles above baron-tier.
|<code>is_allowed_holding_type = FROM</code>
|Government
|-
|is_allowed_to_loot
!✓
|character
|bool
|Character can raid.
|<code>is_allowed_to_loot = yes</code>
|Rulers
|-
|is_alternate_start
!✓
|any
|bool
|Checks if the world is randomised or shattered. Also see <code>is_random_world</code> and <code>is_shattered_world</code>
|<code>is_alternate_start = no</code>
|Control
|-
|is_ancestor_of
!✓
|character
|character
|(2.8) Checks if the scoped character is a progenitor of the target character's bloodline, within up to sixteen generations (for performance reasons). Expensive, so use with caution.
|<code>is_ancestor_of = ROOT</code>
|Characters
|-
|is_artifact_active
!✓
|artifact
|bool
|Checks if the scoped artifact is currently active, as defined by its active trigger. Artifacts without an active trigger will always be considered active, even if not owned, and artifacts with an active trigger and without an owner will never be considered active.
|
|Artifacts
|-
|is_artifact_equipped
!✓
|artifact
|bool
|Checks if the scoped artifact is currently equipped by its owner.
|
|Artifacts
|-
|is_artifact_same_type_as
!✓
|artifact
|artifact
|Checks if the scoped artifact is the same as the given artifact
|<code>is_artifact_same_type_as = ROOT</code>
|Artifacts
|-
|is_at_lootable_stage
!✓
|wonder
|bool
|True if the wonder is at a stage that is higher or equal to the lua define ""MIN_LOOTABLE_STAGE"".
|<code>is_at_lootable_stage = yes</code>
|Wonders
|-
|is_at_max_stage
!✓
|wonder
|bool
|True if the wonder has fully constructed its final stage.
|<code>is_at_max_stage = yes</code>
|Wonders
|-
|is_at_sea
!✓
|character
|bool
|
|
|Characters
|-
|is_attacker
!✓
|siege/combat
|bool
|
|<pre>
siege = {
    is_attacker = yes
}
combat = {
    is_attacker = no
}
</pre>
|Wars
|-
|is_aunt_uncle_of
!✓
|character
|character
|(2.8) Checks if the current scoped character is the sibling of either of the target character's parents (i.e., one of the target character's parents' siblings, colloquially known as [https://www.urbandictionary.com/define.php?term=pibling "piblings"]).
|<code>is_aunt_uncle_of = ROOT</code>
|Characters
|-
|is_being_looted
!✓
|wonder
|bool
|True if the wonder is currently being looted
|<code>is_being_looted = yes</code>
|Wonders
|-
|is_being_restored
!X
|wonder
|bool
|True if the wonder is currently being restored
|<code>is_being_restored = yes</code>
|Wonders
|-
|is_betrothed
!✓
|character
|bool
|If yes, will only affect betrothed characters
|
|Marriage
|-
|is_bloodline_founder_of
!✓
|character
|bloodline
|Returns true if current scope <character> is the founder of RightHand-Side(RHS) scope <bloodline>.
|
|Bloodlines
|- 
|is_bloodline_member_of
!X
|character
|bloodline
|Returns true if current scope <character> is a member of RightHand-Side(RHS) scope <bloodline>.
|
|Bloodlines
|- 
|is_building
!✓
|holding
|building
|Checks if a holding is constructing a new building
|<code>is_building = tb_hillfort_4</code>
|Holdings
|- 
|is_building_wonder
!✓
|province/character/wonder
|bool/wonder type
|Checks if a province/character is currently building a tier/stage of a wonder. Can check particular wonders as well. Only true if construction is not paused.
|<code>is_building_wonder = yes/no/<wonder type name></code>
|Wonders
|-
|is_building_wonder_upgrade
!✓
|province/character/wonder/upgrade
|bool/upgrade type
|Checks if a wonder is currently constructing an upgrade. Can check particular wonder upgrades as well. Only true if construction is not paused.
|<code>is_building_wonder_upgrade = yes/no/<upgrade name></code>
|Wonders
|-
|is_capital
!✓
|province/title
|bool
|If yes, will only affect the capital HOLDING
|
|Titles
|-
|is_child_of
!✓
|character
|character
|Checks if the scope is a child of another character
|
|Family
|-
|is_close_relative
!✓
|character
|character
|Checks if the scope is a close relative of another character. This includes spouses, parents, children, siblings, niblings, grandparents, and grandchildren
|<code>is_close_relative = ROOT</code>
|Family
|-
|is_conquered
!✓
|title
|bool
|
|<pre>
primary_title = {
    is_conquered = yes
}
</pre>
|Titles
|-
|is_consort
!✓
|character
|bool/character
|Checks if the scoped character is a concubine/consort of somebody; or a concubine/consort or the specified character
|<pre>
father_of_unborn = {
    is_consort = ROOT
}
</pre>
|Marriage
|-
|is_contested
!✓
|title
|bool
|If title is already being contested in some form of Claim or Succession War
|
|Titles
|-
|is_council_content
!✓
|character
|bool
|Checks whether the council is content or not.
|<pre>
liege = {
    is_council_content = no
}
</pre>
|Council
|-
|is_councillor
!✓
|character
|bool
|Checks if character has a councillor job (chancellor, ...)
|<pre>
any_courtier = {
    is_councillor = yes
}
</pre>
|Jobs
|-
|is_cousin_of
!✓
|character
|bool
|(2.8) True if the current scoped character is related to the target character by way of parental siblings.
|<code>is_cousin_of = ROOT</code>
|Characters
|-
|is_crown_law_title
!X
|title
|bool
|Checks for titles that can have [[crown laws]].
|<code>is_crown_law_title = yes</code>
|Titles
|-
|is_damaged
!✓
|wonder
|bool
|True of the wonder is in a damaged state
|<code>is_damaged = yes</code>
|Wonders
|-
|is_decision_potential</br>
is_decision_allowed</br>
is_fort_decision_potential</br>
is_fort_decision_allowed</br>
is_government_potential<br/>
is_government_allowed<br/>
is_hospital_decision_potential</br>
is_hospital_decision_allowed</br>
is_law_potential</br>
is_law_allowed</br>
is_settlement_decision_potential</br>
is_settlement_decision_allowed</br>
is_targeted_decision_potential</br>
is_targeted_decision_allowed</br>
is_title_decision_potential</br>
is_title_decision_allowed</br>
is_trade_post_decision_potential</br>
is_trade_post_decision_allowed
!✓</br>✓</br>✓</br>✓</br>✓</br>X</br>X</br>X</br>X</br>X</br>X</br>X</br>X</br>X</br>X</br>X</br>X</br>X
|character
|decision/government/law/clause
|Checks if current scope matches the <code>potential/allow</code> block of the given decision/law/government.<br/>
<code>is_decision_potential</code> takes a normal,  plot or society decision.<br/>
<code>is_targeted_decision_potential</code> takes any scope to a character, province or title.<br/>
<code>is_title_decision_potential</code> takes any scope to a title or province, except saved event target provinces.<br/>
<code>is_settlement_decision_potential</code> takes any scope to a barony title.<br/>
<code>is_fort/hospital/trade_post_decision_potential</code> takes any scope to a title or province. Uses province for barony or county tier titles, de jure capital for higher tier titles.
|<pre>
is_law_potential = succ_primogeniture

is_government_potential = muslim_government

is_decision_potential = request_to_rank_up_within_society

is_targeted_decision_potential = {
    key = prisoner_torture
    character = FROM
}

is_title_decision_potential = {
    key = set_crown_focus
    title = capital_holding
}

is_settlement_decision_potential = {
    key = convert_tribal_to_castle
    title = event_target:saved_barony_title
}

is_trade_post_decision_potential = {
	key = abandon_trade_post
	title = 78 # province ID
}
</pre>
|Control
|-
|is_connected_to
!✓
|province/title(county)
|clause
|Checks if two provinces are connected via some realm's territory. Can be somewhat performance intensive, so use sparingly.
{|class="wikitable"
!Parameter !! Type !! Description
|-
|target || capital/<br/>realm_capital/<br/>scope || Required. What province to find a connection to. Alternatively takes a scope that can be resolved to a province.
|-
|sea_gap || bool || Whether to allow pathing through gaps of a single sea province. Defaults to "no". Can't path through lakes.
|-
|land_gap || bool || Whether to allow pathing through gaps of a single land province. Defaults to "no". Can't path through wastelands.
|-
|sub_realm || bool/scope || Which realm to allow pathing through. "yes" for the sub-realm of the province owner. "no" for the realm of the top-liege. Alternatively takes a scope that can be resolved to a character. Defaults to "yes".
|-
|naval_distance || bool/int || Whether to allow pathing by sea (any number of provinces). Can take a number instead to use a max distance from already found ports.
|-
|}
|<pre>
is_connected_to = {
    sub_realm = no
    target = realm_capital
    land_gap = yes
    naval_distance = yes
}
</pre>
|Provinces
|-
|is_descendant_of
!✓
|character
|character
|(2.8) Checks if the scoped character descends from the target character, within up to sixteen generations (for performance reasons). Expensive, so use with care.
|<code>is_descendant_of = ROOT</code>
|Characters
|-
|is_dying
!✓
|character
|bool
|Checks if character is about to die. Used for on_actions called just when character dies, such as <code>on_chronicle_owner_change</code>.
|
|Characters
|-
|is_father
!✓
|character
|character
|
|<pre>
FROM = {
    is_father = PREV
}
</pre>
|Family
|-
|is_father_real_father
!✓
|character
|bool
|Case of illegitimate bastards.
|
|Family
|-
|is_female
!✓
|character
|bool
|If yes, will only affect female characters. Can also be used as an event [[pre-trigger]].
|
|Characters
|-
|is_feudal
!✓
|character/title
|bool
|Checks if government is part of feudal_governments group.
|<code>is_feudal = yes</code>
|Government
|-
|is_flanking
!✓
|flank
|bool
|Checks if scoped flank is flanking an enemy flank
|<code>is_flanking = yes</code>
|Wars
|-
|is_foe
!✓
|character
|character
|Checks if the target character is_rival or has an opinion modifier with crime = yes toward the scoped character
|<code>is_foe = ROOT</code>
|Relations
|-
|is_former_lover
!✓
|character
|bool
|
|<code>is_former_lover = ROOT</code>
|Marriage
|-
|is_friend
!✓
|character
|character
|Checks if this character is a friend of the given character
|<code>is_friend = ROOT</code>
|Relations
|-
|is_grandchild_of
!✓
|character
|character
|(2.8) Checks if the scoped character is the son or daughter of the target character's son or daughter.
|<code>is_grandchild_of = ROOT</code>
|Characters
|-
|is_grandparent_of
!✓
|character
|character
|(2.8) Checks if the scoped character is the father or mother of the target character's father or mother.
|<code>is_grandparent_of = ROOT</code>
|Characters
|-
|is_guardian
!✓
|character
|bool/character
|
|<pre>
father = {
    is_guardian = no
}
</pre>
|Guardianship
|-
|is_hard_to_convert
!✓
|character/province
|bool
|Checks if the character or province's religion has the field hard_to_convert = yes
|<code>is_hard_to_convert = yes</code>
|Religion
|-
|is_heir
!✓
|character
|bool/character/title
|Checks if a character is first in the succession line of a title.
|<pre>
is_heir = event_target:scoped_ruler

any_child = {
    is_heir = no
}

is_heir = event_target:scoped_title
</pre>
|Character
|-
|is_heresy_of
!✓
|character/province
|character/province/title/religion
|Checks if target is heresy of the given scope.
|<pre>
any_rival = {
    is_heresy_of = ROOT
}
</pre>
|Religion
|-
|is_heretic
!✓
|character/province
|bool
|
|
|Religion
|-
|is_holy_site
!✓
|title
|character/religion
|Checks if a barony is a holy site of the religion of specified character
|<pre>
is_holy_site = nestorian

any_realm_title = {
    is_holy_site = ROOT
}
</pre>
|Religion
|-
|is_ill
!✓
|character
|bool
|Checks for traits with <code>is_illness = yes</code>. Note that all symptom traits also have this flag.
|Health
|-
|is_immune_to_pruning
!✓
|character
|bool
|If yes, the character has been flagged with the set_immune_to_pruning command, or by the internal game logic, and will not be culled from AI courts or savegames to reduce file size/memory use.
|<code>is_immune_to_pruning = yes</code>
|Characters
|-
|is_important_character_to
!✓
|character
|character
|Checks if scoped character is marked as a special interest by the target character.
|<code>is_important_character_to = ROOT</code>
|Characters
|-
|is_in_same_unit_as
!✓
|character
|character
|Checks if the two characters are in the same unit. Does NOT check every unit on a side of a combat, unlike any/random_unit_leader.
|<code>is_in_same_unit_as = ROOT</code>
|Wars
|-
|is_in_society
!✓
|character
|bool
|Checks if a character is in a society
|<code>is_in_society = yes</code>
|Societies
|-
|is_incapable
!✓
|character
|bool
|Checks if the character is incapable. With the addition of <code>sick_incapable</code> in Reaper's Due, it's important to use this conditional instead of checking for <code>trait = incapable</code>.
|
|Health
|-
|is_indestructible
!✓
|artifact
|bool
|Checks if the artifact is indestructible (has <code>indestructible = yes</code>)
|<code>is_indestructible = yes</code>
|Artifacts
|-
|is_interested_in_any_society
!✓
|character
|bool
|Checks if character is currently showing interest in a society or not.
|<code>is_interested_in_any_society = yes</code>
|Societies
|-
|is_ironman
!✓
|character
|bool
|Used in achievements.txt
|
|Control
|-
|is_island
!✓
|province
|bool
|Checks if the province exists in island_region.txt.
|<code>is_island = yes</code>
|Provinces
|-
|is_land
!✓
|province
|bool
|Checks that province is not a sea province
|
|Provinces
|-
|is_landed
!✓
|character
|bool
|Checks that character owns a landed title. Note: landed characters are also rulers (<code>is_ruler = true)</code>.
|
|Characters
|-
|is_landed_title_being_created
!X
|title
|bool
|Purpose unknown
|<code>is_landed_title_being_created = yes</code>
|Titles
|-
|is_landed_title_allowed
!X
|character
|title
|Checks if the character fulfills the allow conditions of a particular title.
|<code>is_landed_title_allowed = e_hre</code>
|Characters
|-
|is_landless_type_title
!✓
|title
|bool
|
|
|Titles
|-
|is_liege_of
!✓
|character
|character/title/province
|Check if the scoped character is a liege of the right hand side character.
|<pre>
host = {
    is_liege_of = ROOT
}
</pre>
|Vassalage
|-
|is_liege_or_above
!✓
|character/province
|character/title/province
|
|<pre>owner = {
    is_liege_or_above = FROM
}
</pre>
|Vassalage
|-
|is_liege_or_above_of
!X
|character
|character
|Checks that scoped character is a superior to the right hand side character in the top liege's realm.
|<code>is_vassal_or_below_of = ROOT</code>
|Vassalage
|-
|is_local_human_observer
!✓
|any
|bool
|Checks if the local game is in observer mode
|<code>is_local_human_observer = yes</code>
|Control
|-
|is_located_in
!✓
|title
|character/title
|
|<pre>
crusade_target = {
    is_located_in = ROOT
}
</pre>
|Provinces
|-
|is_looting
!X
|character
|bool
|
|
|Wars
|-
|is_looting_in
!✓
|character
|province
|
|
|Wars
|-
|is_lover
!✓
|character
|bool/character
|Checks if this character is a lover of the given character
|<code>is_lover = ROOT</code>
|Marriage
|-
|is_lowborn
!✓
|character
|bool
|Checks if the character is lowborn. '''Fixed in 2.8.''' (In versions prior to 2.8, it worked backwards: setting it to no will pick out characters that are actually lowborn.) Equivalent to <code>dynasty = none</code>
|<code>is_lowborn = no</code>
|Characters
|-
|is_main_spouse
!✓
|character
|bool
|If yes, is primary wife. (Although written gender neutral, there are no multiple-husband polygamies in CK2.)
|
|Marriage
|-
|is_marriage_adult
!✓
|character
|bool
|Checks if the character is old enough to marry, based on <code>NDefines.NCharacter.AGE_OF_MARRIAGE_MALE</code> and <code>NDefines.NCharacter.AGE_OF_MARRIAGE_FEMALE</code>.
|
|Marriage
|-
|is_married
!✓
|character
|bool/character
|Yes, will only affect married characters
|
|Marriage
|-
|is_married_matrilineally
!✓
|character
|bool
|
|
|Marriage
|-
|is_merchant_republic
!✓
|character/title
|bool
|Checks if character is a patrician of at least duke tier or if title is a merchant republic.
|
|Government
|-
|is_mother
!✓
|character
|character
|
|<code>is_mother = ROOT</code>
|Family
|-
|is_multiplayer_host_character
!✓
|character
|bool
|Whether scoped character is the host in a multiplayer game.
|<code>is_multiplayer_host_character = yes</code>
|Control
|-
|is_name_randomized
!✓
|religion/culture
|bool
|Checks if the scoped religion/culture has a randomized name
|<pre>
true_religion_scope = {
     is_name_randomized = yes
}
</pre>
|Control
|-
|is_navy
!X
|unit
|bool
|Checks if a unit is a fleet.
|
|Units
|-
|is_neutral
!X
|character
|bool
|Checks if a character has no vice traits and no virtue traits
|
|Traits
|-
|is_nibling_of
!✓
|character
|character
|(2.8) Checks if the current scoped character is a niece/nephew of the target character (colloquially known by the gender-neutral [https://en.wiktionary.org/wiki/nibling "nibling"]).
|<code>is_nibling_of = ROOT</code>
|Characters
|-
|is_nomadic
!✓
|character
|bool
|Checks if character government is part of nomadic_governments group.
|<code>is_nomadic = yes</code>
|Government
|-
|is_occupied
!✓
|title/province
|bool
|Checks if a barony or county is occupied by enemy troops. Does not work on duchy or above.
|<pre>
any_demesne_title = {
    lower_tier_than = DUKE
    is_occupied = no
}
</pre>
|Wars
|-
|is_offmap_governor
!✓
|character
|bool/id
|Checks if this character is/is not a governor of an offmap power (bool), or of the specified offmap power (id).
|<pre>
is_offmap_governor = yes
is_offmap_governor = offmap_china
</pre>
|Offmap
|-
|is_offmap_ruler
!✓
|character
|bool
|Is this character the ruler of an offmap power?
|<code>is_offmap_ruler = no</code>
|Offmap
|-
|is_offmap_tag
!✓
|offmap
|id
|Checks if the current scoped offmap power is the offmap power with the specified ID.
|<code>is_offmap_tag = offmap_china</code>
|Offmap
|-
|is_offmap_tag_including_dead
!✓
|character
|id
|Whether this character is a current or former member of the offmap power with the specified ID. Used for Chinese clothing for portraits.
|<code>NOT = { is_offmap_tag_including_dead = offmap_china }</code>
|Portraits
|-
|is_older_than
!✓
|character
|character
| Checks if the scoped character is older than the target. Even works for twins and other characters with the same age. 
|<pre>
any_sibling = {
    is_older_than = ROOT
}
</pre>
|Characters
|-
|is_opposite_sex
!✓
|character
|character
|
|<code>is_opposite_sex = ROOT</code>
|Characters
|-
|is_or_was_offmap_power_ruler
!✓
|character
|bool
|Checks whether the scoped character is currently the ruler (holder) of the specified offmap power, or died while holding that title.
|<code>is_or_was_offmap_power_ruler = yes</code>
|Offmap
|-
|is_parent_religion
!✓
|character
|character/province/title
|
|<pre>
top_liege = {
    is_parent_religion = ROOT
}
</pre>
|Religion
|-
|is_powerful_vassal
!✓
|character
|bool
|Checks if a character is considered a [[Council#Powerful vassals|powerful vassal]]. If Conclave is enabled, these vassals have a raised fist icon and expect a seat on the council. The trigger works even without Conclave. Also see <code>among_most_powerful_vassals</code>.
|
|Realm
|-
|is_parent_of
!✓
|character
|character
|(2.8) Checks if the current scoped character is the mother or father of the target character.
|<code>is_parent_of = ROOT</code>
|Characters
|-
|is_patrician
!✓
|character
|bool
|Checks if a character is the head of a Merchant Republic patrician family (has a family palace holding). Can also be used as an event [[pre-trigger]]
|
|Government
|-
|is_pilgrim
!✓
|character
|bool
|Checks if a character has a pilgrim trait
|
|Characters
|-
|is_playable
!✓
|character
|bool
|Only affects playable characters (depending on the loaded DLCs)
|
|Characters
|-
|is_plot_active
!✓
|character
|bool
|In conjunction with leads_faction
|
|Objectives
|-
|is_plot_target_of
!✓
|character
|character
|
|<pre>
any_realm_lord = {
    is_plot_target_of = ROOT
}
</pre>
|Objectives
|-
|is_preferred_holding_type
!✓
|title
|character
|Checks preferred holding type of character, based on government. Uses de jure capital for titles above count-tier, uses county capital holding for titles above baron-tier.
|<pre>
defacto_liege_title = {
    is_preferred_holding_type = FROM
}
</pre>
|Rulers
|-
|is_pregnant
!✓
|character
|bool
|Evaluates true the moment a woman is pregnant (unlike the 2 month delay for the on_pregnancy action).
|
|Characters
|-
|is_preparing_crusade
!✓
|character/title/province/society/religion
|bool
|Checks if the scope's religion is preparing a new-style Crusade. Also see <code>has_crusade_war_started</code>.
|<code>is_preparing_crusade = yes</code>
|Wars
|-
|is_pretender
!✓
|character/title
|bool
|In title scope, checks vs ROOT character.
|<pre>
FROM = {
    is_pretender = yes
}
</pre>
|Titles
|-
|is_priest
!✓
|character
|bool
|Checks if character is either a Court Chaplain or landed with the [[Government#Theocracy|Theocracy government type]]
|
|Characters
|-
|is_primary_heir
!✓
|character
|bool/character
|Heir to primary title (regardless if same dynasty or not)
|<pre>
FROM = {
    is_primary_heir = ROOT
}
</pre>
|Titles
|-
|is_primary_holder_title
!✓
|title
|bool
|
|
|Rulers
|-
|is_primary_holder_title_tier
!✓
|title
|bool
|
|
|Tier
|-
|is_primary_type_title
!✓
|title
|bool
|Checks the flag ''primary'' of the title, for titles that cannot be held as secondary title. This covers mercenaries, the Pope, Holy Orders, etc.
|
|Titles
|-
|is_primary_war_attacker
!✓
|character
|bool
|
|
|Wars
|-
|is_primary_war_defender
!✓
|character
|bool
|
|<pre>
any_friend = {
    is_primary_war_defender = yes
}
</pre>
|Wars
|-
|is_quest_target
!✓
|character/title/province
|bool
|Checks if the current scope is being targeted by a quest.
|<code>is_quest_target = yes</code>
|Societies
|-
|is_quest_target_of
!✓
|character/title/province
|bool
|Checks if the current scope is being targeted by any quest the given character has.
|<code>is_quest_target_of = ROOT</code>
|Societies
|-
|is_random_world
!✓
|any
|bool
|Checks if the world is randomised. Also see <code>is_shattered_world</code> and <code>is_alternate_start</code>
|<code>is_random_world = yes</code>
|Control
|-
|is_recent_grant
!✓
|title
|bool
|
|<code>is_recent_grant = no</code>
|Titles
|-
|is_reformed_religion
!✓
|character/province
|bool/character
|Checks if the religion of character or province is a reformed pagan religion.
|
|Religion
|-
|is_reincarnated
!✓
|character
|bool
|
|<pre>
any_sibling = {
    is_reincarnated = yes
}
</pre>
|Family
|-
|is_religion_crusade_target
!✓
|Any with a religion
|bool
|Checks if religion of the current scope is being targeted by a new-style crusade
|<code>is_religion_crusade_target = yes</code>
|Religions
|-
|is_republic
!✓
|character/title
|bool
|Checks if government is part of republic_governments group.
|<code>is_republic = yes</code>
|Government
|-
|is_retreating
!X
|flank
|bool
|Checks if scoped flank is retreating from combat
|<code>is_retreating = yes</code>
|Wars
|-
|is_rival
!✓
|character
|character
|
|
|Relations
|-
|is_ruler
!✓
|character
|bool
|Yes, will only affect characters who have a title (who are a ruler). Note that the character may not necessarily be landed (<code>is_landed = false</code>) in case of mercenaries, holy orders, or adventurers.
|
|Rulers
|-
|is_save_game
!✓
|character
|bool
|Checks if is a saved game (used for startup events).
|<code>is_save_game = yes</code>
|Characters
|-
|is_seafarer
!✓
|character
|bool
|Checks if either the culture or religion have the seafarer flag set.
|<code>is_seafarer = yes</code>
|Characters
|-
|is_senior_consort_party
!✓
|character
|bool
|Checks if the scoped character has concubines/consorts rather than being someone's concubine/consort.
|<code>is_senior_consort_party = yes</code>
|Marriage
|-
|is_shattered_world
!✓
|any
|bool
|Checks if the world is shattered. Also see <code>is_random_world</code> and <code>is_alternate_start</code>
|<code>is_shattered_world = yes</code>
|Control
|-
|is_society
!✓
|society
|society
|Checks if the currently scoped society is the same as the given one.
|<code>is_society = the_satanists</code>
|Societies
|-
|is_society_discovered
!✓
|character
|bool
|Checks if the scoped character has been "revealed" as part of a secret society, whether they're actually a member of it or not.
|<code>is_society_discovered = yes</code>
|Societies
|-
|is_society_discovered_real
!X
|character
|bool
|Checks if the scoped character has been revealed as part of a secret society, and they are actually part of it.
|<code>is_society_discovered_real = yes</code>
|Societies
|-
|is_society_grandmaster
!✓
|character
|bool
|Checks if scope character is the grandmaster of their society.
|<code>is_society_grandmaster = yes</code>
|Societies
|-
|is_society_rank_full
!✓
|any
|clause
|Checks if named society's rank is full.
|<pre>
is_society_rank_full = {
    society = the_plaguebringers
    rank >= 1
}
</pre>
|Societies
|-
|is_sub_unit_leader
!X
|character
|bool
|Checks if the character is the leader of a subunit.
|<code>is_sub_unit_leader = yes</code>
|Wars
|-
|is_theocracy
!✓
|character/title
|bool
|Checks if government is part of theocracy_governments group.
|<code>is_theocracy = yes</code>
|Government
|-
|is_title_active
!✓
|any
|title
|Indicates whether the landed title is active. An inactive title cannot be [[Title_actions#Create|created]]. Titles are activated or inactivated using the <code>activate_title</code> command.

To check whether a title currently exists, use <code>has_holder = yes</code> instead.
|<pre>
is_title_active = d_knights_templar
is_title_active = THIS
</pre>
|Titles
|-
|is_titular
!✓
|title
|bool
|
|<pre>
any_demesne_title = {
    is_titular = no
}
</pre>
|Titles
|-
|is_tribal
!✓
|character/title(holding)
|bool
|Checks if government is part of tribal_governments group.
|<code>is_tribal = yes</code>
|Government
|-
|is_tribal_type_title
!✓
|title
|bool
|
|
|Titles
|-
|is_tributary
!✓
|character
|bool/clause
|Character is tributary to a suzerain. Type can specify what type of tribute they pay - if omitted, this will evaluate true for any type of tribute. suzerain can specify who they pay tribute to - if omitted, this will evaluate true if the character is a tributary of any suzerain.
|<pre>
is_tributary = yes

is_tributary = {
    type = imperial
    suzerain = FROM
}
</pre>
|Vassalage
|-
|is_twin_of
!X
|character
|character
|If yes, the scoped character is the target character's twin.
|<code>is_twin_of = ROOT</code>
|Characters
|-
|is_valid_attraction
!✓
|character
|character
|Checks if both characters are adults and not already married
|<pre>
any_courtier = {
    is_valid_attraction = ROOT
}
</pre>
|Marriage
|-
|is_valid_romance_target
!✓
|character
|character
|Checks if both characters are adults, not incapable, either homosexual or of different sex and that they are of divine blood religions or not close kin.
|<pre>
any_courtier = {
    is_valid_romance_target = ROOT
}
</pre>
|Marriage
|-
|is_valid_viking_invasion_target
!✓
|title
|character
|Checks that FROM holds the right amount of territory in the kingdom
|
|Wars
|-
|is_variable_equal
!✓
|character/province
|clause
|Checks if a variable has the exact value, instead of standard >= check. See [[variables]]. As of 2.8, <code>check_variable</code> has the same functionality, making this trigger obsolete.
|<pre>
is_variable_equal = {
    which = xxx
    value = xxx
}
</pre>
|Control
|-
|is_vassal_or_below
!✓
|character
|character
| Checks that scoped character is the liege of right hand side character. '''Warning''': the naming is not intuitive, reads from right to left!
|<code>is_vassal_or_below = ROOT #is ROOT my vassal?</code>
|Vassalage
|-
|is_vassal_or_below_of
!✓
|character
|character
| Checks that scoped character is the vassal of the right hand side character. Actually intuitive (literal opposite of <code>is_vassal_or_below</code>), reads from left to right.
|<code>is_vassal_or_below_of = ROOT #am I the vassal of ROOT?</code>
|Vassalage
|-
|is_vice_royalty
!✓
|title
|bool
|Checks for viceroyalty flag on title
|<code>is_vice_royalty = no</code>
|Titles
|-
|is_virtous
!✓
|character
|bool
|Checks if character has at least 1 virtue and no vices. Note the spelling error!
|<code>is_virtous = yes</code>
|Traits
|-
|is_voter
!✓
|character
|bool
|Checks if character votes on the council (i.e. holds a position or minor title with the flag <code>is_voter = yes</code>). Also see <code>has_position</code>.
|<pre>
any_vassal = {
    is_voter = yes
}
</pre>
|Council
|-
|is_wicked
!✓
|character
|bool
|Checks if character has at least 1 vice and no virtues
|<code>is_wicked = yes</code>
|Traits
|-
|is_winter
!✓
|province
|bool
|Checks whether a province is ''currently'' experiencing a winter. To check whether it could experience a winter at all, regardless of current condition, use <code>climate</code>.
|<pre>
location = {
    is_winter = yes
}
</pre>
|Provinces
|-
|is_within_diplo_range
!✓
|character
|character
|
|<code>is_within_diplo_range = FROM</code>
|Relations
|-
|leader_traits
!✓
|character
|int
|Number of traits with <code>leader = yes</code>.
|<code>leader_traits >= 1</code>
|Traits
|-
|leads_faction
!✓
|character
|bool/faction
|
|<code>leads_faction = faction_succ_seniority</code>
|Factions
|-
|learning
!✓
|character
|int
|A character's learning attribute. For state value, see <code>realm_learning</code>
|
|Characters
|-
|lifestyle_traits
!✓
|character
|int
|Number of traits with <code>lifestyle = yes</code>, normally 0 or 1 in vanilla.
|<code>lifestyle_traits < 1</code>
|Traits
|-
|liked_by_offmap
!✓
|character
|clause
|Checks whether the scoped character matches the current "like" of the offmap power of the specified ''type''.  If the "like" has a context, the ''context'' parameter must match to return true.  If the "like" has no context, the context parameter must be omitted to return true.
|<pre>
liked_by_offmap = {
    type = offmap_china
    context = eunuch
}
</pre>
|Offmap
|-
|likes_better_than
!✓
|character
|clause
|Equivalent to <code>opinion_diff</code> with <code>value >= 0</code>.
|<pre>
ROOT = {
    likes_better_than = {
	who = PREV
	than = PREVPREV
    }
}
</pre>
|Opinion
|-
|loot
!✓
|unit?
|int
|Used in unit_event achievement. 
|<code>loot >= 1000</code>
|Wars
|-
|lower_real_tier_than
!✓
|character
|character/tier
|Same as ''lower_tier_than'' but ignores temporary titles
|
|Tier
|-
|lower_tier_than
!✓
|character/title
|character/tier
|Yes, will only affect characters who are of a lower tier
|
|Tier
|-
|manpower_growth
!X
|character
|int
|Checks manpower growth of nomad ruler
|<code>manpower_growth >= 100</code>
|Character
|-
|martial
!✓
|character
|int/character
|A character's Martial attribute. For state value, see <code>realm_martial</code>
|
|Characters
|-
|max_manpower
!✓
|character
|int
|
|<code>max_manpower >= 500</code>
|Clans
|-
|max_population
!X
|character
|int
|
|<code>max_population >= 30000</code>
|Clans
|-
|max_population_and_manpower
!X
|character
|int
|
|<code>max_population_and_manpower >= 40000</code>
|Clans
|-
|max_realm_levy_diff
!X
|character
|clause
|Checks that the scope's maximum realm levies is at least value higher than who's maximum realm levies
|<pre>
max_realm_levy_diff = {
    who = ROOT
    value >= 3000
}
</pre>
|Warfare
|-
|mercenary
!✓
|character/title
|bool
|
|
|Titles
|-
|mercenary_siphon_factor
!✓
|title
|double
|Percentage of payment factor {{sup|?}}
|<code>mercenary_siphon_factor >= 0.05</code>
|Titles
|-
|month
!✓
|any
|int
|In-game month number. Ranges from 0 (January) to 11 (December). Will also evaluate to true if it is a later month, e.g. "10" will be true for both November and December in-game.
|
|Control
|-
|month_of_birth
!✓
|character
|int
|Checks if the month of the character's date of birth is at least this number (January is month 1)
|<code>month_of_birth >= 1</code>
|Characters
|-
|monthly_income
!✓
|character/title (holding)
|double
|
|
|Money
|-
|monthly_piety
!X
|character
|double
|Checks if the character's monthly piety is at least this amount.
|
|Characters
|-
|monthly_prestige
!X
|character
|double
|Checks if the character's monthly prestige is at least this amount.
|
|Characters
|-
|multiplayer
!✓
|any
|bool
|Checks whether the game is multiplayer or single-player.
|
|Control 
|-
|non_interference
!✓
|character
|character
|Checks whether the scoped character will not take hostile action against the target character. See [[Society_modding]] for details.
|<code>non_interference = FROM</code>
|Characters
|-
|num_culture_provinces
!✓
|any that have associated culture
|int
|Number of provinces in the world with the culture associated with the current scope.
|<pre>
norse = {
    num_culture_provinces < 10
}
</pre>
|Culture
|-
|num_culture_realm_provs
!✓
|character
|clause
|Checks the number of provinces with target culture in scoped character's realm.
|<pre>
num_culture_realm_provs = {
    culture = swedish/ROOT
    value >= 8
}
</pre>
|Culture
|-
|num_religion_provinces
!✓
|any that have associated religion
|int
|Number of provinces in the world with the religion associated with the current scope.
|<pre>
norse_pagan = {
    num_religion_provinces > 20
}
</pre>
|Religion
|-
|num_fitting_characters_for_title
!✓
|title
|int
|Checks how many characters in ones court that would fit for a specific title
|
|Title
|-
|num_of_artifacts
!✓
|character
|int
|Checks if if scoped character has at least the given number of artifacts.
|<code>num_of_artifacts >= 3</code>
|Artifacts
|-
|num_of_baron_titles
!X
|character
|int
|Checks how many baron-tier titles a character personally holds
|<code>num_of_baron_titles >= 3</code>
|Titles
|-
|num_of_baron_titles_in_realm
!X
|character
|int
|Checks how many baron-tier titles are held in a character's subrealm
|<code>num_of_baron_titles_in_realm < 5</code>
|Titles
|-
|num_of_buildings
!✓
|title
|int
|
|<pre>
any_demesne_title = {
    tier = BARON
    num_of_buildings >= 1
}
</pre>
|Holdings
|-
|num_of_children
!✓
|character
|int
|Note: Both living and deceased children are counted.
|
|Family
|-
|num_of_claims
!✓
|character
|int
|
|
|Claims
|-
|num_of_consorts
!✓
|character
|int
|Checks the number of consorts/concubines a character has.
|
|Marriage
|-
|num_of_count_titles
!✓
|character
|int
|
|
|Titles
|-
|num_of_count_titles_in_realm
!✓
|character
|int
|Checks the number of count titles in the scoped character's realm. Equivalent to counting the number of provinces in the scope's realm, assuming that there are no titular count titles (which are not properly supported in any case and should generally be avoided).
|<code>num_of_count_titles_in_realm >= 35</code>
|Titles
|-
|num_of_courtiers
!X
|character
|int
|Checks how many courtiers a ruler has
|<code>num_of_courtiers < 30</code>
|Rulers
|-
|num_of_demesne_castles
!X
|character
|int
|Checks how many castle holdings a character personally holds
|<code>num_of_demesne_castles >= 3</code>
|Rulers
|-
|num_of_demesne_cities
!X
|character
|int
|Checks how many city holdings a character personally holds
|<code>num_of_demesne_cities >= 3</code>
|Rulers
|-
|num_of_demesne_empty_provinces
!X
|character
|int
|Checks how many empty provinces a character personally holds
|<code>num_of_demesne_empty_provinces >= 3</code>
|Rulers
|-
|num_of_demesne_tribes
!X
|character
|int
|Checks how many tribal holdings a character personally holds
|<code>num_of_demesne_castles >= 3</code>
|Rulers
|-
|num_of_demesne_temples
!X
|character
|int
|Checks how many temple holdings a character personally holds
|<code>num_of_demesne_temples >= 3</code>
|Rulers
|-
|num_of_duke_titles
!✓
|character
|int
|Checks how many duke-tier titles a character personally holds
|<code>num_of_duke_titles >= 3</code>
|Titles
|-
|num_of_duke_titles_in_realm
!X
|character
|int
|Checks how many duke-tier titles are held in a character's subrealm
|<code>num_of_duke_titles_in_realm < 5</code>
|Titles
|-
|num_of_dynasty_members
!✓
|character
|int
|
|<code>num_of_dynasty_members >= 3</code>
|Family
|-
|num_of_emperor_titles
!✓
|character
|int
|
|
|Titles
|-
|num_of_empty_holdings
!✓
|province
|int
|Note: settlements under construction, do not count as empty.
|
|Provinces
|-
|num_of_extra_landed_titles
!✓
|character
|int
|
|<pre>
liege = {
    num_of_extra_landed_titles >= 1
}
</pre>
|Titles
|-
|num_of_faction_backers
!✓
|character
|clause
|Checks the number of supporters for a given faction
|<pre>
num_of_faction_backers = {
    faction = faction_increase_council_power
    value >= 0
}
</pre>
|Factions
|-
|num_of_feuds
!✓
|character
|int
|
|<code>num_of_feuds >= 3</code>
|Clans
|-
|num_of_forts
!X
|character
|int
|Checks number of forts the character controls
|
|Rulers
|-
|num_of_forts_diff
!X
|character
|clause
|Checks the difference in number of hospitals controlled between 2 characters
|
|Rulers
|-
|num_of_friends
!✓
|character
|int
|
|
|Relations
|-
|num_of_government_vassals
!✓
|character
|clause
|
|<pre>
num_of_government_vassals = {
    government = merchant_republic_government
    value >= 1
}</pre>
|Governments
|-
|num_of_holy_sites
!✓
|character
|int
|Number of holy sites of scope's religion controlled by scope
|
|Religion
|-
|num_of_hospitals
!X
|character
|int
|Number of hospitals the character controls
|
|Rulers
|-
|num_of_hospitals_diff
!X
|character
|clause
|Difference in number of hospitals controlled between 2 characters
|
|Rulers
|-
|num_of_king_titles
!✓
|character
|int
|Checks how many king-tier titles a character personally holds
|<code>num_of_king_titles >= 3</code>
|Titles
|-
|num_of_king_titles_in_realm
!X
|character
|int
|Checks how many king-tier titles are held in a character's subrealm
|<code>num_of_king_titles_in_realm < 5</code>
|Titles
|-
|num_of_lovers
!✓
|character
|int
|
|<code>num_of_lovers < 5</code>
|Marriage
|-
|num_of_max_settlements
!✓
|province
|int
|Checks the current number of constructed or constructible holding slots in a province
|<code>num_of_max_settlements < 7</code>
|Provinces
|-
|num_of_plot_backers
!✓
|character
|int
|
|<pre>
liege = {
     num_of_plot_backers >= 8
}
</pre>
|Objectives
|-
|num_of_prisoners
!✓
|character
|int
|
|<pre>
liege = {
    num_of_prisoners >= 1
}
</pre>
|Characters
|-
|num_of_quests
!X
|character
|int
|Checks how many quests a character has
|num_of_quests >= 1
|Characters
|-
|num_of_realm_counties
!✓
|character
|clause
|Scoped character controls at least N counties from specified title
|<pre>
num_of_realm_counties = {
    value = 6
    title = PREV
}
</pre>
|Rulers
|-
|num_of_rivals
!✓
|character
|int
|
|
|Relations
|-
|num_of_settlements
!✓
|province
|int
|Number of baronies the province has (maximum 7)
|
|Provinces
|-
|num_of_society_members
!✓
|character/society
|int
|(2.8) Number of members who are in the scoped society or scoped character's society.
|<code>num_of_society_members < 5</code>
|Societies 
|-
|num_of_subrealm_castles<br/>
num_of_subrealm_cities<br/>
num_of_subrealm_empty_provinces<br/>
num_of_subrealm_tribes<br/>
num_of_subrealm_temples
!✓<br/>✓<br/>X<br/>X<br/>X
|character
|int
|
|<pre>
num_of_subrealm_cities < 20
num_of_subrealm_castles >= 10
</pre>
|Rulers
|-
|num_of_spouses
!✓
|character
|int
|
|
|Marriage
|-
|num_of_symptoms
!✓
|character
|int
|Number of traits with <code>is_symptom = yes</code>
|<code>num_of_symptoms >= 1</code>
|Health
|-
|num_of_titles
!✓
|character
|int
|Number of titles directly held by the character. Note that for this condition each County title is worth 2 (it includes the capital barony) while Barony, Duchy, Kingdom and Empire-tier titles are worth 1 each.
|<code>num_of_titles < 2</code>
|Titles
|-
|num_of_titles_in_realm
!X
|character
|int
|Checks the number of titles held in the character's subrealm. Note that for this condition each County title is worth 2 (it includes the capital barony) while Barony, Duchy, Kingdom and Empire-tier titles are worth 1 each.
|<code>num_of_titles_in_realm > 120</code>
|Titles
|-
|num_of_trade_posts
!✓
|character
|int
|Number of trade posts
|
|Rulers
|-
|num_of_trade_post_diff
!✓
|character
|clause
|Difference of trade posts between 2 characters 
|<pre>
num_of_trade_post_diff = {
    character = ROOT
    value >= 10
}
</pre>
|Rulers
|-
|num_of_traits
!✓
|character
|int
|Number of traits
|
|Traits
|-
|num_of_unique_dynasty_vassals
!X
|character
|int
|Number of vassals of different dynasties (excluding the dynasty of scoped character). 
|
|Vassalage
|-
|num_of_vassals
!✓
|character
|int
|Number of direct vassals
|
|Vassalage
|-
|num_of_wonder_upgrades
!✓
|wonder
|int
|Checks if if scoped character has at least the given number of upgrades. Useful for say triggering any flavor based on qualified guesses in regards to the state of the wonder.
|<code>num_of_wonder_upgrades >= 2</code>
|Wonders
|-
|num_of_wonders
!✓
|province/character
|int
|Checks if the scoped character is listed as the owner of at least the given number of wonders (that have completed at least stage 1).  This could be used as a ""does wonder exist at all?"" check, as well as for counting.
|<code>num_of_wonders >= 1</code>
|Wonders
|-
|num_religion_realm_provs
!X
|title
|clause
|Checks number of provinces of target religion in scoped character's realm
|<pre>
num_religion_realm_provs = {
    religion = ROOT
    value >= 6
}
</pre>
|Rulers
|-
|num_title_realm_provs
!✓
|title
|clause
|Number of counties in ROOT's realm.
|<pre>
num_title_realm_provs = {
    who = ROOT
    value >= 6
}
</pre>
|Rulers
|-
|num_traits
!✓
|character
|int
|Alias of <code>num_of_traits</code>
|
|Traits
|-
|obedient
!✓
|character
|character
|Checks if the scoped character is obedient to the target character, e.g. has an opinion modifier with obedient = yes toward the target character.
|<pre>
ROOT = {
    obedient = FROM
}
</pre>
|Relations
|-
|offmap_has_dislike
!✓
|offmap
|string
|Checks whether the scoped offmap power has their current "dislike" assigned to the named scripted trigger. Note that in spite of "dislike" being negative, the vanilla triggers are shared between likes and dislikes, and therefore named in the positive (e.g., the current "''dis''like" may be "''likes'''_wealth" -- do not use "''dislikes''_wealth").
|<code>offmap_has_dislike = likes_wealth</code>
|Offmap
|-
|offmap_has_like
!✓
|offmap
|string
|Checks whether the scoped offmap power has their current "like" assigned to the named scripted trigger.
|<code>offmap_has_like = likes_concubines</code>
|Offmap
|-
|opinion
!✓
|character
|clause
|Checks if the scope's opinion of ''who'' is at least this value
|<pre>
opinion = {
    who = ROOT
    value >= 25
}
</pre>
|Opinion
|-
|opinion_diff
!✓
|character
|clause
|True if ''first'' target character has a higher opinion of the currently scoped character than ''second'' target character by at least ''value'' points.
<code>as_if_liege = yes</code> also applies the liege-vassal opinion modifiers (<code>vassal_opinion</code>, etc.) and is used in factions, to decide if a character would like someone better as liege than another one (and therefore would join a faction seeking to replace him).
|<pre>
opinion_diff = {
    first = liege
    second = FROM
    value >= 25
    as_if_liege = yes
}
</pre>
|Opinion
|-
|opinion_levy_raised_days
!✓
|character
|clause
|Should be called inside a vassal's scope, and <code>who</code> should be the vassal's liege. The condition is useless if the government/religion allows raising vassal troops without opinion penalties.
|<pre>
opinion_levy_raised_days = {
    who = ROOT
    days >= 30
}
</pre>
|Opinion
|-
|overlord_of
!✓
|character
|character
|Rarely used alias for <code>is_liege_of</code>. Generates no tooltip!
|<pre>
holder_scope = {
    overlord_of = FROM
}
</pre>
|Rulers
|-
|over_max_demesne_size
!✓
|character
|int
|
|<code>over_max_demesne_size >= 4</code>
|Rulers
|-
|over_vassal_limit
!✓
|character
|int
|
|<code>over_vassal_limit >= 6</code>
|Rulers
|-
|owed_favor_activated_by
!X
|character
|character/title/province
|Checks if the scoped character owed favor activated by target character. The reverse condition is <code>held_favor_activated_on</code>. Province scopes must be relative or saved event targets, since numbers are interpreted as character IDs.
|<pre>
liege = {
    owed_favor_activated_by = ROOT
}
</pre>
|
|-
|owes_favor_to
!✓
|character
|character
|Checks if a character owes a favor to another character. The reverse condition is <code>holds_favor_on</code>.
|<pre>
liege = {
    owes_favor_to = ROOT
}
</pre>
|
|-
|owned_by
!✓
|province
|character
| Checks if currently scoped province is owned by target character
|<code>owned_by = ROOT</code>
|Rulers
|-
|owns
!✓
|character
|title/province
|
|<pre>
owns = 333 # Rome
owns = PREVPREV
</pre>
|Rulers
|-
|owns_mercenary_units
!✓
|character
|bool
|Checks if character owns mercenary units
|<code>owns_mercenary_units = yes</code>
|
|-
|pacifist
!✓
|character
|bool
|
|<code>pacifist = yes</code>
|Characters
|-
|pays_tribute_to
!✓
|character
|character
|
|<code>pays_tribute_to = ROOT</code>
|Characters
|-
|personal_opinion
!✓
|character
|clause
|Similar to opinion, but does not take state diplomacy, laws or any other such state concerns into account
|<pre>
personal_opinion = {
    who = FROM
    value >= 0
}
</pre>
|Opinion
|-
|personal_opinion_diff
!✓
|character
|clause
|Similar to opinion_diff, but does not take state diplomacy, laws or any other such state concerns into account
|<pre>
personal_opinion_diff = {
    first = ROOT
    second = liege
    value >= 5
}
</pre>
|Opinion
|-
|personality_traits
!✓
|character
|int
|Number of traits with <code>personality = yes</code>
|<code>personality_traits <5</code>
|Traits
|-
|phase
!✓
|Combat
|skirmish/melee/pursuit
|Checks the current phase of the scoped combat flank
|<pre>
combat = {
    phase = melee
}
</pre>
|Characters
|-
|piety
!✓
|character
|int
|The amount of piety a character has.
|
|Characters
|-
|plot_is_known_by
!✓
|character
|character
|Tests if a plot is known by another character
|<code>plot_is_known_by = ROOT</code>
|Objectives
|-
|plot_months
!X
|character
|character
|Checks for how many months a character has been plotting
|<code>plot_months >= 12</code>
|Objectives
|-
|plot_power
!✓
|character
|double
|Typically ranges from 0.5 to 4.0 in vanilla
|
|Objectives
|-
|plot_power_contribution
!✓
|character
|clause
|
|<pre>
plot_power_contribution = {
    plotter = ROOT
    power >= 0.025
}
</pre>
|Objectives
|-
|population
!✓
|character
|int
|
|<code>population >= 10000</code>
|Clans
|-
|population_and_manpower
!✓
|character
|int
|
|<code>population_and_manpower >= 10000</code>
|Clans
|-
|population_and_manpower_growth
!X
|character
|int
|
|<code>population_and_manpower_growth >= 500</code>
|Clans
|-
|population_factor
!✓
|character
|double
|Percentage of maximum population.
|<code>population_factor >= 0.9 # 90% of max</code>
|Clans
|-
|population_growth
!X
|character
|int
|Checks population growth of nomad ruler
|<code>population_growth >= 200</code>
|Character
|-
|port
!✓
|province
|bool
|Checks if province is coastal
|
|Provinces
|-
|prev_policy
!✓
|offmap
|policy
|Checks if the scoped offmap power previously had the specified offmap policy.
|<code>has_policy = china_isolationist</code>
|Offmap
|-
|prev_policy_flag
!X
|offmap
|string
|Checks if the scoped offmap power previously had the specified flag in its previous offmap status modifier's <code>flags</code> list.
|<code>prev_policy_flag = disallow_troops</code>
|Offmap
|-
|prev_status
!✓
|offmap
|status
|Checks if the scoped offmap power previously had the specified offmap status modifier.
|<code>prev_status = china_plague</code>
|Offmap
|-
|prev_status_flag
!X
|offmap
|string
|Checks if the scoped offmap power previously had the specified flag in its previous offmap status modifier's <code>flags</code> list.
|<code>prev_status_flag = disallow_troops</code>
|Offmap
|-
|preparing_invasion
!✓
|character
|bool
|
|
|Wars
|-
|practical_age
!X
|character
|int
|Checks the apparent age of the character, taking immortality into account -- e.g., if the character became immortal at age 40, this will yield 40 rather than their true age.
|<code>practical_age > 40</code>
|Health
|-
|prestige
!✓
|character
|int
|The amount of prestige a character has.
|
|Characters
|-
|prisoner
!✓
|character
|bool
|If no, can't be applied to imprisoned characters. Can also be used as an event [[pre-trigger]].
|
|Characters
|-
|province
!✓
|province
|province/title
|Checks currently scoped province to be the same as another. For titles above count tier, uses its de jure capital province.
|<pre>
ROOT = {
    capital_scope = {
	province = PREVPREV
    }
}
</pre>
|Provinces
|-
|province_id
!✓
|province
|int
|Alias for <code>province</code>
|
|Provinces
|-
|quality
!✓
|artifact
|int
|Checks if the quality of the scoped artifact compares correctly to the given value.
|<code>quality == 4</code>
|Artifacts
|-
|race
!✓
|character
|culture/character
|Same as <code>culture</code> condition. Checks if a character's culture matches that of a specified culture or character. This is different from <code>graphical_culure</code>, i.e when comparing two cultures that have the same culturegfx, <code>race</code> still evaluates to false.
|<code>race = horse</code>
|Character
|-
|raised_manpower
!X
|character
|int
|Checks raised manpower of nomad ruler
|<code>raised_manpower >= 2000</code>
|Character
|-
|random
!✓
|any
|int
|Chance of success is (100-N)%!
|<code>random >= 85</code>
|Control 
|-
|real_day_of_year
!X
|any
|int
|Checks for actual IRL day of the month. Ranges from 0 to 30. Checks if the day is at least the specified number, so use two checks to narrow down a range.
|<code>real_day_of_year = 11 </code>
|Control 
|-
|real_month_of_year
!✓
|any
|int
|Checks for actual IRL month (contrary to <code>month</code> which checks it in-game). Ranges from 0 (January) to 11 (December). Checks if the month is at least the specified number, so use two checks to narrow down a range.
|<code>real_month_of_year = 11 </code>
|Control 
|-
|real_tier
!✓
|character/title
|character/title/tier
|Same as ''tier'' but ignores temporary titles
|
|Tier
|-
|realm_character_percent
!X
|character
|clause
|Returns true if the percentage of characters in the scoped character's realm fulfilling the condition is equal to or greater than the target.
|<pre>
realm_character_percent = {
    target = 0.05
    trait = genius
}
</pre>
|Rulers
|-
|realm_diplomacy
!✓
|character
|int
|State diplomacy. For personal attribute, see <code>diplomacy</code>.
|
|Rulers
|-
|realm_intrigue
!✓
|character
|int
|State intrigue. For personal attribute, see <code>intrigue</code>.
|
|Rulers
|-
|realm_learning
!X
|character
|int
|State learning. For personal attribute, see <code>learning</code>.
|
|Rulers
|-
|realm_levies
!✓
|character
|int
|
|<code>realm_levies < 6000</code>
|Warfare
|-
|realm_levy_diff
!✓
|character
|clause
|Checks that the scope's current realm levies is at least value higher than who's current realm levies
|<pre>
realm_levy_diff = {
    who = ROOT
    value >= 3000
}
</pre>
|Warfare
|-
|realm_martial
!✓
|character
|int
|State martial. For personal attribute, see <code>martial</code>.
|
|Rulers
|-
|realm_size
!✓
|character
|int
|Total number of landed titles in the realm
|<code>realm_size >= 180</code>
|Rulers
|-
|realm_stewardship
!✓
|character
|int
|State stewardship. For personal attribute, see <code>stewardship</code>.
|
|Rulers
|-
|rebel
!✓
|character/title
|bool
|
|
|Characters
|-
|region
!✓
|title,province
|region
|Checks if scope belongs to a geographical region.
|<code>region = world_africa_east</code>
|Province
|-
|regional_percentage
!✓
|any
|clause
|Checks if the percentage of provinces in a particular region meets a set of conditions
|<pre>
regional_percentage = {
    region = world_india
    percentage >= 0.50
    OR = {
	religion = hindu
	religion = jain
    }
}
</pre>
|Province
|-
|relative_income
!X
|character
|clause
|Compares the income of two characters (?). Syntax unknown, does not work as of at least version 3.3.2.
|
|Wealth
|-
|relative_income_to_liege
!✓
|character
|float
|Compares the income of character and of his liege. Does not work as of at least version 3.3.2.
|<code>relative_income_to_liege >= 0.5</code>
|Wealth
|-
|relative_power
!✓
|character
|clause
|Check that currently scoped character has at least ''power'' percentage of ''who'''s power.
|<pre>
relative_power = {
    who = FROM
    power >= 4.0
}
</pre>
|Rulers
|-
|relative_power_including_allies_attacker
!✓
|character
|clause
|Check that currently scoped character (plus its potential allies in an offensive war) have at least ''power'' percentage of ''who'''s power.
|<pre>
relative_power_including_allies_attacker = { 
    who = FROMFROM # Defender
    power >= 0.8
}
</pre>
|Rulers
|-
|relative_power_including_allies_defender
!✓
|character
|clause
|Check that currently scoped character (plus its potential allies in a defensive war) have at least ''power'' percentage of ''who'''s power.
|<pre>
relative_power_including_allies_defender = {
    who = FROM # Attacker
    power >= 2
}
</pre>
|Rulers
|-
|relative_power_to_liege
!✓
|character
|double
|
|<pre>
any_realm_lord = {
    relative_power_to_liege >= 0.1
}
</pre>
|Vassalage
|-
|relative_realm_size
!✓
|character
|clause
|(2.8) Compares the realm size of the scoped character with the character specified by ''who''.
|<pre>
relative_realm_size = {
    who = ROOT
    size < 1
}
</pre>
|Rulers
|-
|religion
!✓
|character/province/title/society/religion
|religion
|Checks if character/province has the given religion
|
|Religion
|-
|religion_allows_female_temple_holders
!✓
|character
|bool
|Checks religion flag allows_female_temple_holders
|<code>religion_allows_female_temple_holders = yes</code>
|Religion
|-
|religion_allows_male_temple_holders
!✓
|character
|bool
|Checks religion flag allows_male_temple_holders
|<code>religion_allows_male_temple_holders = yes</code>
|Religion
|-
|religion_authority
!✓
|character/province
|double
|Ranges from 0 to 1
|
|Religion
|-
|religion_distance
!X
|province/title
|character/province/title/society/religion
|Checks distance to closest province of target religion.
|<pre>
religion_distance = {
    target = ROOT
    value > 300
}
</pre>
|Religion
|-
|religion_group
!✓
|character/province/title/society/religion
|religion
|Checks if character's/province's religion belongs to the given religion group
|
|Religion
|-
|republic_total_num_of_trade_posts
!✓
|character
|int
|
|<code>republic_total_num_of_trade_posts >= 80</code>
|
|-
|reverse_clan_opinion
!✓
|character
|clause
|
|<pre>
reverse_clan_opinion = {
    who = FROM
    value >= 25
}
</pre>
|Opinion
|-
|reverse_clan_opinion_diff
!X
|character
|clause
|
|<pre>
reverse_clan_opinion_diff = {
    first = FROM
    second = PREV
    value >= 25
}
</pre>
|Opinion
|-
|reverse_combat_rating_diff
!X
|character
|clause
|
|<pre>
reverse_combat_rating_diff = {
    who = FROM
    value >= 25
}
</pre>
|Attribute
|-
|reverse_has_cb
!X
|character
|character
|Checks if target character can use any CB against scoped character
|<code>reverse_has_cb = FROM</code>
|Rulers
|-
|reverse_has_embargo 
!X
|character
|character
|Checks if the right-hand side character has an embargo on the scoped character
|<code>reverse_has_embargo = FROM</code>
|Character
|-
|reverse_has_opinion_modifier
!✓
|character
|clause
|Checks if 'who' character has the given [[modifiers|opinion modifier]] towards scoped character
|<pre>
reverse_has_opinion_modifier = {
    who = ROOT
    modifier = opinion_supported_pope
}
</pre>
|Opinion
|-
|reverse_has_truce
!✓
|character
|character
|
|<pre>
liege = {
    reverse_has_truce = ROOT
}
</pre>
|Wars
|-
|reverse_opinion_levy_raised_days
!X
|character
|clause
|Should be called inside inside the scope of a ruler with vassals, and <code>who</code> is any direct vassal. The condition is useless if the government/religion allows raising vassal troops without opinion penalties.
|<pre>
reverse_opinion_levy_raised_days = {
    who = ROOT
    days >= 30
}
</pre>
|Opinion
|-
|reverse_max_realm_levy_diff
!X
|character
|clause
|Checks who's maximum realm levies compared to the scoped character's maximum realm levies
|<pre>
reverse_max_realm_levy_diff = {
    who = ROOT
    value >= 3000
}
</pre>
|Warfare
|-
|reverse_opinion
!✓
|character/new
|clause
|Checks who's opinion of the scoped character. <code>new</code> can be used to reference the <code>new_character</code> scope.
|<pre>
reverse_opinion = {
    who = ROOT
    value >= 0
}
</pre>
|Opinion
|-
|reverse_opinion_diff
!X
|character/new
|clause
|Checks if 'first's opinion of scoped character is 'value' higher than 'first's opinion of 'second'
|<pre>
reverse_opinion_diff = {
    first = ROOT
    second = FROM
    value >= 0
}
</pre>
|Opinion
|-
|reverse_personal_opinion
!✓
|character
|clause
|Similar to reverse_opinion, but does not take state diplomacy, laws or any other such state concerns into account
|<pre>
reverse_personal_opinion = {
    who = FROM
    value >= 50
}
</pre>
|Opinion
|-
|reverse_personal_opinion_diff
!X
|character
|clause
|Checks if 'first's personal opinion of scoped character is 'value' higher than 'first's personal opinion of 'second'. Does not take state diplomacy, laws or any other such state concerns into account.
|<pre>
reverse_personal_opinion_diff = {
    first = ROOT
    second = FROM
    value >= 0
}
</pre>
|Opinion
|-
|reverse_realm_levy_diff
!X
|character
|clause
|Checks that who's current realm levies is value higher than the scope's current realm levies
|<pre>
reverse_realm_levy_diff = { 
    who = ROOT
    value >= 3000
}
</pre>
|Warfare
|-
|revolt_distance
!X
|character
|int
|
|<code>revolt_distance >= 100</code>
|Provinces (?)
|-
|revolt_risk
!✓
|province
|double
|
|<code>revolt_risk >= 0.02</code>
|Provinces
|-
|rightful_religious_head
!✓
|character
|character
|
|<pre>
any_independent_ruler = {
    rightful_religious_head = ROOT
}
</pre>
|Religion
|-
|risks_minor_clan_rising
!✓
|character
|bool
|
|<code>risks_minor_clan_rising = yes</code>
|Clans
|-
|ruled_years
!✓
|character/title
|int
|
|
|Rulers
|-
|same_guardian
!✓
|character
|character
|
|<pre>
any_courtier = {
    same_guardian = ROOT
}
</pre>
|Guardianship
|-
|same_liege
!✓
|character
|character
|
|<pre>
any_realm_lord = {
    same_liege = ROOT
}
</pre>
|Vassalage
|-
|same_realm
!✓
|character/title
|character
|
|<pre>
any_neighbor_province = {
    owner = {
	same_realm = ROOT
    }
}
</pre>
|Rulers
|-
|same_sex
!✓
|character
|character
|Checks if two characters have same sex.
|<code>same_sex = FROM</code>
|Characters
|-
|same_regnal_name
!X
|character
|character
|Checks if two characters have the same regnal name for numbering purposes. Regnal names are currently defined as having the same first first name (E.G., "Gustav" and "Gustav Adolf" are the same regnal name), or the same cultural first first name (E.G., "Alfr_Alf" and "Alf_Alf" are the same regnal name).
|
|Characters
|-
|same_society_as
!✓
|character
|character
|Checks if scope character is in the same society as target character.
|<code>same_society_as = ROOT</code>
|Societies
|-
|same_wonder_as
!X
|Wonder
|Wonder
|Checks if two wonders are of the same type
|<pre>
same_wonder_as = FROM 
same_wonder_as = event_target:saved_wonder
</pre>
|Societies
|-
|scaled_wealth
!✓
|character
|double/clause
|Check if character has the given wealth based on percentage of yearly income. Before 2.8, the clause syntax is not available.
|<pre>
scaled_wealth = 0.2

scaled_wealth = {
    value = 0.5
    min = 10
    max = 20
}
</pre>
|Money
|-
|score
!✓
|character
|int
|Current score of the player
|<code>score >= 100000</code>
|
|-
|secret_religion
!✓
|character
|Anything with a religion
|Checks if character secretly follows the given religion
|<pre>
secret_religion = catholic
secret_religion = FROM
</pre>
|Religion
|-
|secret_religion_group
!✓
|character
|religion (group)
|Checks if character secretly follows a religion in the given religion group
|<pre>
secret_religion_group = christian
secret_religion_group = ROOT
</pre>
|Religion
|-
|settlement_age
!X
|holding
|int
|Checks age of a holding. If pre-built in province history, a holding is considered built in 1.1.1)
|<code>settlement_age < 20</code>
|Religion
|-
|shares_any_bloodline_with
!✓
|character
|character
|Returns true is both characters have at least one bloodline in common
|
|Bloodlines
|-
|shares_realm_border_with
!✓
|character
|character
|(2.8) Checks if any province in your realm (everything under your titles) borders any province in their realm.
|
|Realm
|-
|sibling
!✓
|character
|character
|
|
|Family
|-
|society_can_rank_down
!X
|character
|bool
|Checks if the character can rank down within their society
|<code>society_can_rank_down = yes</code>
|Societies
|-
|society_can_rank_up
!✓
|character
|bool
|Checks if the character can rank up within their society
|<code>society_can_rank_up = yes</code>
|Societies
|-
|society_currency
!✓
|character
|society
|Checks if character has the given number of society points. Can add a scaled_by_influence parameter to scale by society influence, going from a 70% reduction when the society is at 100% influence and going linearly to a 0% reduction at 0% influence
|<code>society_currency >= 1000</code>
|Societies
|-
|society_has_active_progress
!✓
|society
|bool
|Checks if the society currently has an ongoing progress counter.
|<code>society_has_active_progress = yes</code>
|Societies
|-
|society_has_members
!✓
|society
|bool
|Checks if the society has any members.
|<code>society_has_members = yes</code>
|Societies
|-
|society_influence
!✓
|society/character/any
|int/clause
|Checks if a given society's influence compares to the given number. If no society name is given, it will use either the society in the current scope, or the society of the character in the current scope. If no society name is given, and the current scope is neither a society nor a character, it will always return false.
|<pre>
society_influence >= 70

society_influence = {
    society = the_assassins
    value >= 50
}
</pre>
|Societies
|-
|society_is_active
!X
|society
|bool
|Checks if the society's active trigger is true.
|<code>society_is_active = yes</code>
|Societies
|-
|society_is_criminal
!✓
|character
|bool
|Checks if character's society is criminal or not.
|<code>society_is_criminal = no</code>
|Societies
|-
|society_is_devil_worshiper
!✓
|character
|bool
|Checks if character's society is a devil worshiping society or not.
|<code>society_is_devil_worshiper = no</code>
|Societies
|-
|society_member_of
!✓
|character
|society
|Checks if character belongs to the given society
|<code>society_member_of = monastic_order_buddhist</code>
|Societies
|-
|society_progress
!✓
|society
|float
|Checks the society's current progress.
|<code>society_progress < 25</code>
|Societies
|-
|society_rank
!✓
|character/int/clause
|society
|Checks if character's rank compares correctly to the value or character given. Can use clause to additionally check if character belongs to named society.
|<pre>
society_rank == 2

society_rank = {
    society = the_assassins
    rank == 3
}
</pre>
|Societies
|-
|start_date
!✓
|any
|date
|Check the initial start date of current game.
|<code>start_date == 1066.9.15</code>
|Control
|-
|stewardship
!✓
|character
|int
|A character's Stewardship attribute. For state value, see <code>realm_stewardship</code>
|
|Characters
|-
|stored_token_trigger
!✓
|character
|Casus Belli
|The selected CB, in context of voting on war declaration. Available in <code>ROOT</code> and <code>FROM</code> scopes.
|
|Council voting
|-
|supply_limit
!X
|province
|clause
|Compares the supply in the province for a given character and their leader against a value. The leader defaults to the given character unless specified.
|<pre>
supply_limit = {
    for = ROOT
    leader = FROM
    value > 10
}
</pre>
|Wars
|-
|supported_checksum
!X
|any
|bool
|Checks to see if current checksum matches at least one supported checksum in the .mod files of any active mods (defined by <code>supported_checksums = { ABCD EFGH }</code> field). 
|
|Control
|-
|symptom
!X
|character
|trait (?)
|
|
|Health
|-
|TECH_INFANTRY

TECH_CAVALRY

TECH_SKIRMISH

TECH_MELEE

TECH_SIEGE_EQUIPMENT

TECH_RECRUITMENT

TECH_CASTLE_CONSTRUCTION

TECH_CITY_CONSTRUCTION

TECH_FORTIFICATIONS_CONSTRUCTION

TECH_TRADE_PRACTICES

TECH_CONSTRUCTION

TECH_NAVAL

TECH_NOBLE_CUSTOMS

TECH_POPULAR_CUSTOMS

TECH_RELIGIOUS_CUSTOMS

TECH_MAJESTY

TECH_CULTURE_FLEX

TECH_LEGALISM
!✓
|character/province/title/holding(baron title)
|int
|Check whether the current holding or province has at least this level of technology in a particular tech category.
|<code>TECH_POPULAR_CUSTOMS >= 3</code>
|Provinces
|-
|technology_can_spread
!✓
|province
|bool
|Check whether technology can spread in the province.
|<code>technology_can_spread = yes</code>
|Province
|-
|temporary
!✓
|title
|bool
|Check if title is temporary one (revolt, claimant adventurer, ...)
|
|Titles
|-
|terrain
!✓
|province
|terrain
|Values: forest, hills, mountain, plains, farmlands, steppe, desert, jungle, arctic
|
|Provinces
|-
|their_clan_opinion
!X
|character/clan title
|clause
|Alias for <code>reverse_clan_opinion</code>
|<pre>
their_opinion = {
    who = ROOT
    value >= 25
}
</pre>
|Opinion
|-
|their_opinion
!✓
|character
|clause
|Alias for <code>reverse_opinion</code>
|<pre>
their_opinion = {
    who = ROOT
    value >= 25
}
</pre>
|Opinion
|-
|tier
!✓
|character/title/offmap
|string
|Checks if the character's tier is exactly equivalent to the specified tier.  Does not permit the use of 2.8+ comparison operators!
- Values: BARON, COUNT, DUKE, KING, EMPEROR
|
|Tier
|-
|title
!✓
|character/title
|title/province
|
|<code>title = d_mesopotamia</code>
|Titles
|-
|total_claims
!✓
|character
|clause
|
|<pre>
total_claims = {
    who = FROM
    strong = yes
    value >= 2
}
</pre>
|Claims
|-
|total_manpower
!X
|character
|int
|Checks total manpower of nomad ruler
|<code>total_manpower >= 2000</code>
|Character
|-
|total_years_played
!✓
|Any
|int
|Number of years since beginning of current game
|<code>total_years_played >= 200</code>
|Control
|-
|trade_post_has_building
!✓
|province
|building
|Checks if a trade post has the specified building.
|<code>trade_post_has_building = tr_silk_road_3</code>
|Buildings
|-
|trade_post_has_any_building
!X
|province
|building
|Checks if a trade post has at least 1 building.
|
|Buildings
|-
|trade_route
!✓
|province
|trade route/province
|Checks if a province is on the specified trade route, or if two provinces share a trade route
|<pre>
trade_route = silk_road
trade_route = event_target:saved_province
</pre>
|Provinces
|-
|trade_route_control
!✓
|character
|clause
|(2.8) Checks the amount of control of the scoped character (others?) over the specified trade route's wealth, provinces, trade posts, or trade post locations.
{|class="wikitable"
!Parameter !! Type !! Description
|-
|trade_route || identifier || Required. Trade route to check against.
|-
|value || float || Required. Percentage of control required.
|-
|type || string || Optional. Type of comparison: "wealth", "provinces", "trade_posts", or "trade_post_locations". The latter two are restricted by the trade post trigger in the trade route definition. Defaults to wealth.
|-
|indirectly_owned || bool || Optional. Whether to include provinces in one's sub-realm that are owned by vassals. Defaults to yes.
|-
|}
|<pre>
trade_route_control = {
    trade_route = silk_road
    value > 0.1
    type = trade_post_locations
    indirectly_owned = no
}
</pre>
|Provinces
|-
|trait
!✓
|character
|string
|Checks if the character has this trait
|<code>trait = shy</code>
|Traits
|-
|treasury
!✓
|character
|double
|Alias for <code>wealth</code>
|<code>treasury >= 50</code>
|Money
|-
|true_religion
!✓
|character
|character/province/title/society
|If the character has a secret religion, checks if character secretly follows the given religion, otherwise checks if the character publicly follows the given religion
|<pre>
true_religion = catholic
true_religion = PREV
</pre>
|Religion
|-
|true_religion_group
!✓
|character
|Anything with a religion, religion group
|If the character has a secret religion, checks if character secretly follows a religion in the given religion group, otherwise checks if the character publicly follows a religion in the given religion group
|<pre>
true_religion_group = christian
true_religion_group = ROOT
</pre>
|Religion
|-
|troops
!✓
|siege
|clause
|
|<pre>
troops = {
    who = troops
    value >= 0.1
    enemy = yes
}
</pre>
|Wars
|-
|units_in_province
!X
|Province
|int
|Checks the number of armies/units in a province
|<code>units_in_province > 3</code>
|Units
|-
|unit_is_in_combat
!X
|unit
|bool
|Checks if the unit is in combat.
|
|Units
|-
|unused_manpower
!✓
|character
|int
|
|<code>unused_manpower >= 250</code>
|Clans
|-
|uses_decadence
!✓
|character
|bool
|Character has decadence mechanic via religion/government.
|<code>uses_decadence = yes</code>
|Characters
|-
|uses_new_crusade
!✓
|character
|bool
|Checks if character's religion uses new-style Crusades as set in religion definition
|<code>uses_new_crusade = yes</code>
|Characters
|-
|using_cb
!✓
|war
|casusBelli
|
|<pre>
any_war = {
    using_cb = crusade
}
</pre>
|Wars
|-
|vassal_of
!✓
|character
|character
|Check if the scoped character is a direct vassal of the right hand side character.
|<pre>
any_rival = {
    vassal_of = ROOT
}
</pre>
|Vassalage
|-
|war
!✓
|character
|bool
|Checks if the character is in war
|
|Wars
|-
|war_participation
!✓
|war
|double
|
|<pre>
any_war = {
    war_participation = {
	who = ROOT
	score >= 50
    }
}
</pre>
|Wars
|-
|war_score
!✓
|war
|double
|
|<pre>
any_war = {
    war_score >= 50
}
</pre>
|Wars
|-
|war_title
!✓
|war
|title/province
|
|<code>war_title = ROOT</code>
|Wars
|-
|war_with
!✓
|character
|character/title
|Returns true if people are hostile due to raiding or if their armies are hostile because of a personal, liege or third party war.<ref>[[forum:874495/page-17#post-20709564]]</ref>
|<pre>
liege = {
    NOT = { war_with = ROOT }
}
</pre>
|Wars
|-
|was_conceived_a_bastard
!✓
|character
|bool
|
|<code>was_conceived_a_bastard = yes</code>
|Family
|-
|wealth
!✓
|character
|int
|The minimum amount of gold this character should have
|
|Money
|-
|will_liege_enforce_peace
!✓
|character
|bool
|See also <code>has_liege_enforced_peace</code>
|<code>will_liege_enforce_peace = no</code>
|Realm
|-
|wonder
!X
|wonder
|scope
|Alias of <code>same_wonder_as</code>
|<pre>
wonder = FROM 
wonder = event_target:saved_wonder
</pre>
|Wonders
|-
|wonder_age
!✓
|wonder
|int
|Checks that the wonder is at least the given number years old.
|<code>wonder_age >= 150</code>
|Wonders
|-
|wonder_stage
!✓
|wonder
|int
|Checks which tier the wonder progress is at (not counting current construction, ie building the first tier puts your wonder at tier 0 (zero))
|<code>wonder_stage >= 1</code>
|Wonders
|-
|wonder_stage_age
!X
|wonder
|int
|Checks that the wonder has been at the current tier/stage at least the given number of years.
|<code>wonder_stage_age >= 15</code>
|Wonders
|-
|wonder_upgrade
!✓
|wonder_upgrade
|scope
|Checks exact ID of wonder upgrade
|<code>wonder_upgrade = event_target:my_saved_upgrade</code>
|Wonders
|-
|wonder_upgrade_age
!✓
|upgrade
|int
|Checks that the upgrade is at least the given number years old.
|<code>wonder_upgrade_age >= 200</code>
|Wonders
|-
|would_be_heir_under_law
!✓
|title
|clause
|
|<pre>
would_be_heir_under_law = {
    who = FROM
    law = seniority
}
</pre>
|Government
|-
|year
!✓
|any
|int
|Returns the current year.
|
|Control
|-
|year_of_birth
!X
|character
|int
|Checks if the character was born in this year or later
|<code>year_of_birth >= 1000</code>
|Characters
|-
|yearly_income
!✓
|character/title (holding)
|double
|
|<code>yearly_income >= 25</code>
|Money
|-
|}

==See also==

*[[Scopes]]
*[[Commands]]

==References==

<references/>

[[Category:模组制作]]
[[Category:列表]]
{{ModdingNavbox}}
[[en:Conditions]]