Scopes

From Stellaris Wiki
(Redirected from Scope)
Jump to navigation Jump to search

Version

Outliner top.png
Please help with verifying or updating older sections of this article. At least some were last verified for version 2.6.

This article is for the PC version of Stellaris only.

Introduction[edit]

Most objects in the game provide a scope to access them through script. A planet will provide a planet scope and a pop will provide a pop scope. The relationship between objects also relates to their scopes. To access the planet which a pop is on is called a scope switch, as your code is switching from referring to the pop to referring to the planet. Most objects and their scopes form a tree-like relationship, with the global scope representing the entire game.

In code, scopes are written as the [scope_type] = { }, with all the script in the brackets referring to the specific object of the scope. For example:
pop = { unemploy_pop = yes } would cause the current pop to become unemployed. Scopes can be used in both trigger and effect blocks. Some triggers and effects will take a scope as an argument, and some apply to a specific scope despite what scope they are run. For example, years_passed < 50 always refers to global scope, no matter what the current scope is.

A list of all known scopes is available below.

System scopes[edit]

There are special system scopes that refer to relationships between scopes. These are THIS, PREV, ROOT, and FROM.

  • THIS – Refers to the current scope. It is useless as context switch, but sometimes is used as input for certain effects. If you are in a pop scope, this would refer to that pop.
  • PREV – Refers to the previous scope. If you are in a pop scope, and change to the planet scope, prev would refer back to the pop. pop = { planet = { habitability = { who = prev value > 0.6 } } } would check that the habitability of the current pop has over 60% habitability on its current planet. Sometimes you will want to refer back more than one scope step, in which case you can repeat prev up to four times, i.e. prevprev up to prevprevprevprev
  • FROM – Refers to the scope from which the current script was called. For example, if an event executed a planet event, the planet event could refer back to the objects in the first event using the fromscope. Just like PREV, up to four FROMs can be repeated to refer back multiple times.
  • ROOT – Refers to the main scope of the script. For events, this will be the object the event is called in. For example, in a planet_event, root will be the specific planet the event was called on. ROOT is usually the default scope for script blocks in the event, but is shorter and more clear than PREV to refer to when you have switched to other scopes. For example, in a pop event's immediate block, the pop is the default scope. But if you switch to the planet scope of the pop, and possibly to even more chained scopes, root will always refer back to the pop the event was called on. Note that in some scripts, such as scripted_effects and scripted_triggers, the default scope, this, is not necessarily the same as root.

In some contexts, these relationships aren't intuitive. For instance, on_actions will often override some of these system scopes to hold the objects the action refers to. For example, in events called from on_ship_disabled, this will refer to the disabled ship, and from will refer to the ship that disabled it. The vanilla on_actions.txt file has comments describing most of these, while others you will have to look at code to determine to which objects they refer.

Chaining scopes[edit]

To simplify code and increase readability, a . can be used to chain scopes together. For example, owner = { capital_scope = { solar_system = { … } } } is equivalent to owner.capital_scope.solar_system = { … }, and will take you to the solar system of the capital of the country that owns the current scope. Note that this does not work with the scope-changing triggers and effects referred to below. For the PREV and FROM system scopes, if you need more than four, you can chain them together as well: prevprevprevprev.prevprev.

Scope existence[edit]

Often times scripts expect certain scopes to exist, or to run in certain scopes. Sometimes, some scopes and relationships don't always exist. For example, if you scope to the owner of a planet (planet = { … owner = { … } }), and the planet isn't owned, the script will fail and produce an error in the error.log. As such, it is good practice to always check that a scope exists if there is any chance it might not. This is done using exists. Before changing the the scope, use exists = [scope]. If it doesn't exist, the following code won't run.
planet = { exists = owner owner = { … } }

Triggers and scopes[edit]

Most triggers can only be called within certain scopes. For instance, is_moon will only work in a planet scope. If you attempt to call a trigger in the wrong scope, it will produce an error in the error.log and often cause the rest of the code to fail or produce unintended results. The code will also error if you attempt to execute a trigger on a scope that doesn't exist.

Some triggers will also perform a scope change. These triggers usually begin with any_, and script in them will run in the implied scope. They will return yes if any object of that scope matches the criteria. For example, any_planet_within_border = { is_planet_class = pc_gaia } will return yes if the country it is called on has a Gaia planet in its borders. It will iterate through all planet scopes of the country and execute the trigger criteria in the scope. So all script within the trigger's braces will execute in planet scope, even though it was called from country scope.

A list of these scope-like triggers can be found on the Triggers page, or actually by using the console command trigger_docs to get the defined triggers for your version of the game.

Effects and scopes[edit]

Much like triggers, most effects only work in specific scopes. If you attempt to call a trigger in the wrong scope, it will produce an error in the error.log. However, executing an effect on a scope that doesn't exist will just cause nothing to happen with no error.

Some effects will also perform a scope change. These effects usually being with every_ or random_. every_ will apply the effect(s) within to every object of that scope, while random_ will apply the effect(s) within to a single random object of that scope. A limit = { … } statement can be used within these effects to narrow down the results. For example, every_owned_planet = { limit = { is_planet_type = pc_continental } … } is called from country scope, but would apply the enclosed effect(s) to every Continental planet the country owned. The effects within would all run in the planet scope of the continental planet, even though they were called from country scope.

A list of these scope-like effects can be found on the Effects page, or actually by using the console command effect_docs to get the defined effects for your version of the game.

Event target[edit]

Sometimes it's a good idea to save certain scopes as event targets to use in later events or projects in the same namespace, or to use globally.

Use the save_event_target_as = [name] to save the scope for later use in the namespace, or save_global_event_target_as = [name] to save the scope for later use anywhere. They can be scoped to using event_target:[name] = { … }, or used as a target for trigger or effect parameter. For example, if an event at the start of a war saved the war leader as save_event_target_as:war_leader, after the war you could refer to them again: planet.owner = { set_subject_of = { who = event_target:war_leader subject_type = vassal } } When you know you will no longer need a saved global event target, it is good practice to clear it: clear_global_event_target = [name].

Scope Types[edit]

Every scope is of a particular type of object. The type determines when it can be used. They can be checked with is_scope_type = (see Conditions). The following are types that apply in game:

Scope Type Scopes of this type Description
country owner, controller, space_owner, overlord, subject, last_created_country An empire. Some of these are unique. For instance, the Shroud is a country, all Tiyanki's are a members of the Tiyanki country, etc.
sector sector A sector in an empire
galactic_object AKA system solar_system, star An object on the galactic map.
megastructure megastructure A system object built by constructor ships. Note that habitats and ringworlds are converted to type planet after they are completed.
ambient_object ambient_object, last_created_ambient_object A point-of-interest in a galactic_object.
planet planet, capital_scope, orbit An entity within a galactic_object. Stars, asteroids, habitats, ringworlds and planets are all considered planet-type scopes. If a pop can live on it, it is a planet-type.
deposit deposit A planetary feature, including blockers. Some are exploitable by orbiting stations, others are exploitable by colonizing the planet.
tile ? Mostly deprecated, but still officially supported. Never used in Vanilla
archeaological_site archeaological_site A site of an archaeological dig, persists after it's completed.
army last_created_army An army.
pop pop, last_created_pop A pop.
species species, owner_species, last_created_species The specific pop (sub)species.
leader leader, ruler, last_created_leader A leader in a country. This includes the current ruler, as well as leaders in the hiring pool.
pop_faction pop_faction A political faction within a country.
ship starbase, last_created_ship An empire controlled entity in space. This includes starbases and defense platforms.
fleet fleet, last_created_fleet Every ship belongs to a fleet, even a lone ship. A starbase fleet includes its defense platforms.
design design, last_created_design A ship design
federation/alliance federation/alliance A federation. Other than localisation of triggers, federation and alliance alliance are interchangeable. Vanilla uses federation.
war - A two-sided diplomatic war between two or more empires

List of scopes[edit]

Scope name Scope type Can be scoped from
xxx = { owner = {…} }
Can scope to
owner = { xxx = {…} }
Description
owner country fleet, ship, planet, pop, leader, army, megastructure, sector, starbase capital_scope, ruler Scopes to the country that owns the object
controller country fleet, ship, planet, pop, leader, army, megastructure, sector, starbase capital_scope, ruler Scopes to the country that currently occupies the object
space_owner country solar_system capital_scope, ruler Scopes to the country that currently owns the galactic_object
last_created_country country any capital_scope, ruler Scopes to the last created country. Usually used after a create_country effect.
sector sector planet leader, owner A sector in a country
solar_system galactic_object planet, star, ship star, starbase, space_owner A solar system
star galactic_object? solar_system solar_system, starbase The star of the solar system. May consist of multiple planet-scope stars, though one is always considered the main star.
megastructure megastructure - planet, owner A megastructure
ambient_object ambient_object - solar_system A non-planet entity in a solar_system. Often a point-of-interest for a special project.
last_created_ambient_object ambient_object any solar_system The last created ambient object. Usually used after a create_ambient_object effect.
planet planet pop, deposit, leader, army, archeaological_site, planet (moon) solar_system, owner, controller A planet, star, or habitable structure.
capital_scope planet country solar_system, owner, controller The capital planet of the country.
orbit planet fleet, ship solar_system, owner, controller The planet-type object a fleet or ship is orbiting.
deposit deposit - planet A planetary feature, including blockers and space deposits.
archeaological_site archeaological_site planet planet, leader An archeaological_site on a planet.
army army ship ship, leader, owner, pop A defensive or offensive army.
last_created_army army any owner, pop The last created army, usually used with the create_army effect.
pop pop leader owner, planet A pop
last_created_pop pop any owner, planet The last created pop, usually used with the create_pop effect.
species species pop, leader, country - A specific pop species or subspecies
owner_species species country - The main species of a country. Usually the founder species, unless changed with change_dominant_species effect.
last_created_species species any - The last created species, usually used with the create_species effect, or the secondary species created by a player during empire creation.
leader leader fleet, sector, army species, owner A leader in a country, including potential leaders in the pool.
ruler leader country species, owner The leader that is the current ruler of a country,
last_created_leader leader any species, owner The last created leader, usually used with the create_leader effect.
pop_faction pop_faction - owner A political faction in an empire.
starbase ship star, solar_system orbit, owner An outpost or larger starbase that claims a system.
last_created_ship ship any orbit, leader, owner The last created ship, usually used with the create_ship effect.
fleet fleet ship orbit, leader, owner A fleet containing at least one ship-type object.
last_created_fleet fleet any orbit, leader, owner The last created fleet, usually used with the create_fleet effect.
design design - owner A ship design.
last_created_design design any orbit, leader, owner The last created design, usually used with the create_design effect.
federation/alliance federation/alliance country - A federation. Note that federation and alliance are seemingly interchangeable but vanilla uses federation.
war war - - A declared war.

Flat list of scopes[edit]

Flat list of trigger scopes (v2.7.2)
Scope Description From scope
text For 'desc={trigger={' use. Shows custom text all
custom_tooltip Replaces the tooltips for the enclosed triggers with a custom text all
if Evaluates the triggers if the display_triggers of the limit are met all
any_playable_country Iterate through all playable countries all
has_mission Checks if the observation post has a specific mission fleet
switch Switch case for a trigger all
num_fleets Checks the country's number of fleets country
num_ships Checks the country/fleet's number of ships country fleet
research_leader Checks if the country's researcher in a specific field meets the specified criteria country
has_fleet_order Checks if the ship/fleet has a specific fleet order ship fleet
closest_system Checks if any close-by systems meet the criteria all
any_owned_fleet Iterate through each fleet owned by the country country
has_orbital_station Checks if the planet has any kind of orbital station planet
any_orbital_station Checks if the planet's orbital station meets the specified criteria planet
else_if Evaluates the enclosed triggers if the display_triggers of the preceding `if` or `else_if` is not met and its own display_trigger of the limit is met all
happiness Checks the pop's happiness percentage pop
is_half_species Check if scoped species is half species of specific/any species species
faction_approval Checks the scoped faction's approval percentage pop_faction
has_designation Checks if the colony has a certain designation planet
colony_type Checks if the colony is of a certain type planet
num_favors Check amount of favors that scoped country can collect from target country: country
last_building_changed Checks if the last building queued/unqueued/built/demolished/upgraded was the specified building planet
empire_size Checks the empire's size country
empire_sprawl Checks the empire's size country
empire_sprawl_over_cap Checks how much the empire sprawl is over its admin capacity country
empire_sprawl_cap_fraction Checks the empire's sprawl compared to its admin level country
last_district_changed Checks if the last district queued/unqueued/built/demolished/upgraded was the specified district planet
has_ring Checks if the planet has a planetary ring planet
is_moon Checks if the planet is the moon of another planet planet
opinion Checks the country's opinion of the target country country
opinion_level Checks the country's opinion level of the target country (with support for comparison operators) country
envoy_opinion_change Checks the country's opinion of the target country has been changed by envoys country
ideal_planet_class Checks if the country's ideal planet class is a specific class country
ethos Checks the average ethics divergence on the planet planet
distance Checks the ship/fleet/planet/leader/pop/system's galaxy map distance to target in absolute units planet ship pop fleet galactic_object leader archaeological_site
is_pirate Checks if the country is a pirate country country
planet_size Checks the planet's size planet
gender Checks the leader's gender leader
any_planet_within_border Checks if any planets within the country's borders meet the specified criteria country
any_owned_ship Iterate through each ship in the fleet or owned by the country country fleet
any_ship Checks if any ships in the game meet the specified criteria all
pop_has_ethic Checks if the pop has a specific ethos pop
pop_has_trait Checks if the pop has a specific trait pop
has_observation_outpost Checks if the planet has an observation post planet
starting_system Checks if the system is the starting system for any country galactic_object
graphical_culture Checks if the country has specific graphical culture country
vassals Checks the country's number of vassals country
exists Checks if a target scope exists all
has_edict Checks if the country has a specific edict enabled country
is_designable Checks if the scoped ship design, ship or fleet (all ships) has a designable ship size. ship fleet design
is_in_cluster Checks if the planet/system belongs to a specific spawning cluster planet galactic_object
any_moon Checks if any of the planet's moons meet the specified criteria planet
num_empires Checks the number of regular empires in the galaxy country
leader_class Checks if the leader is of a specific class leader
leader_age Checks the scope leader's age leader
observation_outpost Checks if the planet's observation post meets the specified criteria planet
has_deposit Checks if the planet has any, or a specific, deposit planet deposit
is_same_value Checks if the current scope and the target scope are the same thing all
has_pop_faction_flag Checks if the pop faction has a specific flag pop pop_faction
num_communications Checks the country's number of established communications country
last_changed_policy Checks if the last policy changed by the country was a specific policy country
is_species Checks if the pop/country's founder species is of a specific pre-defined species pop leader species
last_increased_tech Checks if the country's last researched technology was a specific tech country
any_war Iterate through all wars the country is engaged in country
any_defender Checks if any of the defenders in the war meet the specified criteria war
any_attacker Checks if any attackers in the war meet the specified criteria war
original_owner Checks if the planet is still owned by its first colonizer planet
tech_unlocked_ratio Checks the relative amount of already-researched tech between the country and target country country
can_colonize Checks if the planet can be colonized by target country planet
has_special_project Checks if the country has a specific special project available country
has_completed_special_project Checks if the country has completed a specific special project as part of an in-progress event chain country
has_failed_special_project Checks if the country has failed, timed out or aborted a specific special project as part of an in-progress event chain country
is_subspecies Checks if the pop/country/species is a subspecies of the target pop/country/species country pop species
is_valid Checks to see if target scope is valid for the country/planet/army planet country army
check_pop_faction_parameter Checks if one of the faction's parameters is the same as target scope pop_faction
is_robot_pop Checks if the pop is a robot pop
num_fallen_empires Checks the number of fallen empires in the galaxy country
is_preferred_weapons Checks if the country's AI prefers weapons using this component tag country
has_access_fleet Checks if the target country is allowed to enter the system galactic_object
is_point_of_interest Checks if the planet/country/ship/system/ambient object has a specific point of interest for a specific event chain for a specific country planet country ship galactic_object ambient_object
terraformed_by Checks if planet is terraformed by country.
has_megastructure Checks if a country or star has a mega structure.
recently_lost_war Checks if the country is at war country
count_diplo_ties Checks the number of diplomatic in the scope that fulfill the specified criteria country
has_research_agreement Checks if two countries have a research agreement.
has_tributary Checks if two countries have a research agreement.
upgrade_days_left Checks a mega structure amount of upgrade days left. megastructure
has_any_megastructure Checks if the scope has a megastructure planet galactic_object
former_living_standard_type Compares the former living standard type with the given one. pop
former_citizenship_type Compares the former citizenship type with the given one. pop
former_military_service_type Compares the former military service type with the given one. pop
former_slavery_type Compares the former slavery type with the given one. pop
former_purge_type Compares the former purge type with the given one. pop
former_population_control_type Compares the former population control type with the given one. pop
former_migration_control_type Compares the former migration control type with the given one. pop
is_alliance_fleet Checks if the scoped fleet is an alliance fleet. fleet
is_researching_special_project Checks if the country is currently researching a specific special project country leader
last_activated_relic Checks if the specified relic was the last activated one country
any_system_planet Checks if any planet in the system meets the specified criteria galactic_object
is_scope_type Checks currently in the specified scope: all
is_robotic Check if the species in the scope is a robot species or not species
has_unlocked_all_traditions Checks if the country has unlocked all traditions country
has_potential_claims Checks if the country has any potential claims they can make. country
has_available_jobs Check that you have available job of a specific type planet
and all inside trigger must be true
or At least one entry inside the trigger must be true
not An inverted trigger
any_planet Checks if any planet ANYWHERE meets the specified criteria all
is_star Checks if the planet is a star planet
is_asteroid Checks if the planet is an asteroid planet
species_portrait Checks if the species (or pop/empire's dominant species) uses a certain portrait country pop species
is_neutral_to Checks if the country has a neutral attitude towards target country country
trust Checks the country's trust of the target country country
name_list_category Checks if a specific name list is used for the a species during empire creation
hidden_trigger Hides the tooltip for the triggers within all
has_district Checks if the planet has any, or a specific, district planet
free_district_slots Checks the planet's number of slots available for new constructions planet
diplomacy_weight Checks the countrys diplomacy weight country
has_owner Checks if the planet/system is colonized planet galactic_object
any_owned_planet Checks if any of the country's owned planets meet the specified criteria country
free_housing Checks the planet's available housing planet
any_controlled_planet Checks if any of the country's controlled planets meet the specified criteria country
is_ai Checks if the country is played by the AI country
always Sets trigger to be either always true or false all
has_trait Checks if a pop/leader/species/country's dominant species has a certain trait country pop leader species dlc_recommendation
has_ethic Checks if a country has a certain ethos country pop dlc_recommendation
is_owned_by Checks if the planet/system/army/ship is owned by the target country planet ship galactic_object army
pop_can_live_on_planet Checks if the pop's species is allowed to live on its planet pop
days_passed Checks the number of in-game days passed since the 2200.1.1 start all
free_amenities Checks the planet's available amenities planet
has_deficit Checks if the country has a deficit of the defined resource country
has_commercial_pact Check if the country has a commercial pact with target country country
is_being_assimilated Checks if the pop is being purged pop
num_guaranteed_colonies Checks the number of guaranteed colonies defined in setup all
num_owned_relics Checks the number of relics owned by the scoped country country
has_branch_office Check if the planet has a branch office owned by target country/any country/no country planet
is_same_species checks if the scoped object is of the same species as another object country ship pop leader army species
is_criminal_syndicate Checks if the country is a criminal syndicate country
is_blocker Checks if scoped deposit is a blocker-type deposit
is_same_empire Checks if the country is the same as another, target country country
free_branch_office_building_slots Checks the planet's number of branch office slots available for new constructions planet
branch_office_value Checks the planet's branch officevalue planet
free_jobs Checks the number of jobs compared to pops on the planet planet
is_planet_class Checks if the planet is of a certain class planet
has_strategic_resource Checks if the planet has any strategic resource planet
is_star_class Checks if the system/planet(star) is of a certain class planet galactic_object
has_technology Checks if the country has a technology (of at least a specific level) country
any_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure megastructure planet starbase
planet_devastation Checks the planet's devastation planet
is_pop_category Checks if the pop has the chosen pop category pop
won_the_game Checks if scoped country won the game country
planet_stability Compares the stability present on the planet with the given value planet
perc_communications_with_playable Checks the country's percentage of communications with playable empires country
planet_crime Compares the crime present on the planet with the given value planet
has_job Checks if the pop has a specific job, or any job if set to yes pop
has_planet_modifier Checks if the planet has a specific planet modifier planet
is_deposit_type Checks if deposit is specified type deposit
has_built_species Checks if country has a built species defined country
num_buildings Checks the number the planet has of any, or a specific, building planet
num_districts Checks the number the planet has of any, or a specific, district planet
num_free_districts Checks the number of available slots the planet has of any, or a specific, district planet
has_planet_flag Checks if the planet has a specific flag planet
has_federation_flag Checks if the federation has a specific flag federation
has_country_flag Checks if the empire has a specific flag country
has_fleet_flag Checks if the fleet has a specific flag fleet
has_ship_flag Checks if the ship has a specific flag ship
is_ship_class Checks if the ship/fleet/design is a specific class ship fleet design
is_ship_size Checks if the ship/fleet/design is a specific ship size ship fleet design
is_capital Checks if the planet is its owner's capital planet
has_ground_combat Checks if ground combat is taking place on the planet planet
is_at_war Checks if the country is at war country
num_owned_planets Checks the country's number of owned planets country
has_government Checks if the country has a specific government type, or any government at all country
num_pops Checks the number of pops on the planet/country/pop faction planet country pop_faction
is_primitive Checks if the country is a primitive, pre-FTL civilization country
is_archetype Checks if species has specified archetype: species
is_inside_nebula checks if the planet/ship/fleet/system is inside a nebula planet ship fleet galactic_object
is_in_frontier_space checks if the planet/ship/fleet/system is in frontier space planet ship fleet galactic_object
is_inside_border Checks if the planet/ship/fleet/system is inside the borders of the target country planet ship fleet galactic_object
any_country Iterate through all countries all
any_pop Checks if any of the planet/species/pop faction pops meet the specified criteria planet species pop_faction
is_overlord Checks if the country is the overlord of any subject countries country
is_at_war_with Checks if the country is at war with the target country country
their_opinion Checks target country's opinion value of the current country country
is_same_species_class Checks if the pop/country is of the same species class as another pop/country country pop
has_federation Checks if the country is in a federation country
is_colonizable Checks if the planet can theoretically be colonized planet
has_level Checks if the leader has a specific experience level leader
num_minerals Checks the planet's total amount of minerals planet
num_physics Checks the planet's total amount of physics research planet
num_society Checks the planet's total amount of society research planet
num_engineering Checks the planet's total amount of engineering research planet
num_modifiers Checks the planet's number of modifiers planet
has_any_strategic_resource Checks if the planet has any strategic resource planet
has_pop_flag Checks if the pop has a specific flag pop
is_occupied_flag Checks if the planet is under military occupation planet
is_damaged Checks if the ship is damaged ship
has_hp Checks the ship's hull points ship
is_surveyed Checks if the planet/system has been survey by target country planet galactic_object
has_global_flag Checks if a Global Flag has been set all
check_variable Checks a variable for the country/leader/planet/system/fleet megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector
is_colony Checks if the planet is colonized planet
habitability Checks the planet's habitability (0 to 1) for target pop/species planet
has_building Checks if the planet has any, or a specific, building planet
is_controlled_by Checks if the planet is controlled by the target country planet
is_terraformed Checks if the planet has ever been terraformed planet
is_terraforming Checks if the planet is currently being terraformed planet
is_federation_leader Checks if the country is the leader of their federation country
has_star_flag Checks if the solar system has a specific flag galactic_object dlc_recommendation
has_mining_station Checks if the planet has an orbital mining station planet
has_research_station Checks if the planet has an orbital researc station planet
any_research_station Checks if the planet's orbital research station meets the specified criteria planet
any_mining_station Checks if the planet's orbital mining station meets the specified criteria planet
army_type Checks the army's type army
has_army Checks if the planet has an army planet
is_advisor_active checks if a country has an advisor
count_pops Checks the number of pops in the scope that fulfill the specified criteria planet species pop_faction
is_enslaved Checks if the pop is a slave pop
is_being_purged Checks if the pop is being purged pop
income Checks the country's monthly energy credit income country
expenses Checks the country's monthly energy credit expenses country
produced_energy Checks the country's gross amount of produced energy credits country
num_uncleared_blockers Checks the planet's total amount of uncleared blockers planet
local_human_species_class Checks if local humans founder species is a specific species class all
num_envoys_to_federation Checks the country's number of envoys sent to its federation country
num_envoys_to_galcom Checks the country's number of envoys sent to the galactic community country
has_envoy_task Checks the scoped envoy's task. leader
has_envoy_cooldown Checks the scoped envoy currently has a cooldown on its status. leader
trade_income Checks the country's energy credits income from trade for the previous month country
trade_expenses Checks the country's energy credits expenses from trade for the previous month country
ship_maintenance Checks the country's total ship maintenance expenses for the previous month, in energy credits country
army_maintenance Checks the country's total army maintenance expenses for the previous month, in energy credits country
colony_maintenance Checks the country's total colony maintenance expenses for the previous month, in energy credits country
station_maintenance Checks the country's total orbital station maintenance expenses for the previous month, in energy credits country
construction_expenses Checks the country's construction expenses for the previous month country
federation_expenses Checks the country's federation expenses for the previous month country
has_anomaly Checks if the planet has an anomaly planet
stored_physics_points Checks the country's amount of stored physics research country
stored_society_points Checks the country's amount of stored society research country
stored_engineering_points Checks the country's amount of stored engineering research country
balance Checks the country's energy credit balance country
running_balance Checks the country's running energy credit balance country
is_planet Checks if the planet is the same as target planet planet
is_pop Checks if the pop is the same as target pop pop
is_ship Checks if the ship is the same as target ship planet
is_army Checks if the army is the same as target army army
is_country Checks if the country is the same as target country country
is_tutorial_level Checks the country's tutorial level (0 off, 1 limited, 2 full) country
is_multiplayer Checks if the game is running in multiplayer all
has_event_chain Checks if the country has a specific event chain country
is_species_class Checks if the pop/country's founder species is a specific species class country pop species dlc_recommendation
has_opinion_modifier Checks if the country has a specific opinion modifier towards target country or anyone country
has_established_contact Checks if the country has established contact with target country country
has_completed_event_chain_counter Checks if the country has completed a specific counter in an event chain country
has_planet_class Checks if the system has planet of specific class galactic_object
is_disabled Checks if the ship/fleet is disabled ship fleet country
has_resource Checks if the planet has a specific amount of a specific resource planet country deposit
has_building_construction Checks if the planet has any, or a specific, ongoing building construction planet
num_fallen_empires_setting Checks the number of fallen empires defined in setup all
any_deposit Checks if any deposits on the planet meet the criteria planet
free_building_slots Checks the planet's number of slots available for new constructions planet
has_relation_flag Checks if the country has a relation flag towards target country country
reverse_has_relation_flag Checks if the target country has a relation flag towards the country country
has_moon Checks if the planet has a moon planet
num_moons Checks the planet's number of moons planet
is_sapient Checks if the pop is sapient pop species
is_preventing_anomaly Checks if the planet is prevented from generating anomalies planet
has_deposit_for Checks if the planet has a deposit for a specific ship class planet
colony_age Checks the planet's (colony's) age in months planet
is_bottleneck_system Checks if the system is bottleneck within the range NDefines::NGameplay::SYSTEM_BOTTLENECK_RADIUSis_bottleneck_system = yes
is_rim_system Checks if the system is on the galactic rim galactic_object
any_rim_system Iterate through all rim systems all
is_country_type Checks if the country is a specific type country
has_modifier Checks if the country/planet/pop/system has a certain modifier megastructure planet country ship pop galactic_object pop_faction federation
any_ship_in_system Checks if any ships in the system meet the specified criteria galactic_object
mission_progress Checks if the observation post has achieved specific progress in a mission fleet
num_ethics Checks the country/pop's number of ethics country pop
num_traits Checks the country/pop/leader/species' number of traits country pop leader species
has_truce Checks if the country has a truce with target country country
has_system_trade_value Checks the system's trade value galactic_object
can_access_system Checks if the scoped fleet is able to enter the system. Note: Avoid overusing this, it is a performance-intensive trigger! fleet
is_ringworld Checks if the planet is a ringworld planet
member_of_faction Checks if the pop belongs to any, or a specific, faction pop
support Checks the faction's support level pop_faction
is_ideal_planet_class Checks if the planet is of the ideal class for target country planet
is_pop_faction_type Checks the faction's type pop_faction
intel_level Checks the country's intel level of target system country
is_researching_area Checks the scientist's field of research leader
any_owned_leader Checks if any of the country's leaders meet the specified criteria country
any_owned_pop Iterate through all owned pops planet country pop_faction
has_faction Checks if the country has any instance of target faction type country
count_owned_pops Count the number of owned pops in the country that fulfill the specified criteria planet country pop_faction
can_declare_war Checks if the country can declare war against target country country
is_hostile Checks if the country is hostile towards target country country
is_forced_neutral Checks if the country has been set to be neutral towards target country via set_faction_hostility country
is_forced_friendly Checks if the country has been set to be friendly towards target country via set_faction_hostility country
has_communications Checks if the country has established communications with target country country
has_country_resource Checks the country's amount of a specific stored resource country
has_leader_flag Checks if the leader has a specific flag leader
num_killed_ships Checks how many of target country's ships that the country has destroyed country
num_taken_planets Checks how many planets the country has taken from target country country
count_ships Checks the number of ships in the galaxy that meet the specified criteria all
leader_of_faction Checks if the leader is the leader of a faction leader
is_scope_valid Checks if the current scope is valid all
opposing_ethics_divergence Checks how far removed the country/pop's ethos is from target's country pop
is_war_leader Checks if the country leads in a war country pop_faction
is_in_federation_with Checks if the country is in a federation with target country country
can_change_policy Checks if the country can change a specific policy country
is_ironman Check if current game is running in ironman mode all
has_monthly_income Checks the country's monthly income of a specific resource country
else Evaluates the triggers if the display_triggers of preceding 'if' or 'else_if' is not met all
has_policy_flag Checks if the country has a specific policy country
count_deposits Checks the number of deposits on the planet that meet the specified criteria planet
has_tech_option Checks if the country has a tech research option currently available country
count_tech_options Checks the country's number available tech research options in a specific field country
has_point_of_interest Checks if the scoped country has a specific point of interest in its situation log planet country ship fleet galactic_object ambient_object
is_being_repaired Checks if the ship/fleet is being repaired ship fleet
any_ambient_object Checks if any ambient objects in the game meet the specified criteria all
any_system_ambient_object Checks if any ambient objects in the system meet the specified criteria galactic_object
has_ambient_object_flag Checks if the ambient object has a specific flag ambient_object
any_bordering_country Iterate through all bordering countries of a system galactic_object
galaxy_percentage Checks if the country has a specific percentage (0.00-1.00) of the galaxy within its borders country
custom_tooltip_fail Shows custom text only when the associated trigger fails all
count_armies Checks the number of armies on/in the planet/country that meet the specified criteria planet country
is_in_combat Checks if the ship/fleet is engaged in combat ship fleet
any_member Iterate through each member of the federation federation
is_guaranteeing Checks if the country is guaranteeing the independence of target country country
is_war_participant Checks if target country is participating in the war on the specified side war
is_homeworld Checks if the planet is its owner's homeworld planet
is_friendly_to Checks if the country has a friendly attitude towards target country country
is_hostile_to Checks if the country has a hostile attitude towards target country country
is_protective_to Checks if the country has a protective attitude towards target country country
is_threatened_to Checks if the country has a threatened attitude towards target country country
years_passed Checks the number of in-game years passed since the 2200 start all
mid_game_years_passed Checks the number of in-game years passed since the mid-game start date all
end_game_years_passed Checks the number of in-game years passed since the end-game start date all
is_dismissive_to Checks if the country has a dismissive attitude towards target country country
is_patronizing_to Checks if the country has a patronizing attitude towards target country country
is_angry_to Checks if the country has an angry attitude towards target country country
is_neighbor_of Checks if the country/planet is neighbors with target country planet country ship fleet galactic_object
is_rival Checks if the country has a rival attitude towards target country country
is_unfriendly_to Checks if the country has an unfriendly attitude towards target country country
is_loyal_to Checks if the country has a loyal attitude towards target country country
is_disloyal_to Checks if the country has a disloyal attitude towards target country country
is_cordial_to Checks if the country has a cordial attitude towards target country country
is_domineering_to Checks if the country has a domineering attitude towards target country country
fleet_power Checks the scope's total fleet power country fleet federation
has_election_type Checks if the country has a specific election type country
has_ai_personality Checks if an AI empire has a certain personality type country
has_ai_personality_behaviour Checks if a country has a certain AI personality behavior country
has_valid_ai_personality Checks if the country has a valid AI personality country
has_migration_access Checks if the country has migration access to target country country
logged_in_to_pdx_account Checks if the local human is logged in to a Pdx account. This WILL cause an out of sync if used for anything that can change the game state
would_join_war Checks if the country would join the side of target country in a hypothetical war country
can_be_subject Checks if the country can be a subject of a specific type under target country country
count_war_participants Checks the number of participants in the war on a specific side that meet the specified criteria war
count_potential_war_participants Checks the amount of potential war participants in a specific war that meet the specified criteria all
has_skill Checks if the leader has a specific experience level leader
has_experience Checks if the leader has a specific amount of experience leader
any_neighbor_system Checks if any of the system's neighboring systems meet the specified criteria galactic_object
is_under_colonization Checks if the planet is being colonized planet
has_colony_progress Checks the planet's progress towards completing colonization planet
distance_to_empire Checks the ship/fleet/planet/system's galaxy map distance to target empire planet ship fleet galactic_object
is_unemployed Checks if the pop is unemployed pop
years_of_peace Checks the number of in-game years country has been at peace, with optional parameter to delay from start of game country
is_within_borders_of Checks if the planet/system is within the borders of the target country planet galactic_object
num_marauder_empires_to_spawn Checks the number of marauder empires specified by the galaxy setup all
has_species_flag Checks if the species has a specific flag species
has_auto_move_target Checks if the fleet/ship has an active auto-move target set ship fleet
count_system_ships Checks the system's number of ships that meet the specified criteria galactic_object
count_starbase_modules Checks the number of starbase modules that are of the specified type starbase
is_belligerent_to Checks if the country has a belligerent attitude towards target country country
is_imperious_to Checks if the country has a imperious attitude towards target country country
is_arrogant_to Checks if the country has a arrogant attitude towards target country country
has_association_status Check if the country has federation association status with target country country
is_original_owner Checks if the target country is the planet's original owner planet
can_work_job Checks if the pop can work a job pop
subject_can_diplomacy Checks if the country is allowed by its overlord to take diplomatic action towards target country country
has_surveyed_class Checks if the country has surveyed any planet of a specific class country
fleet_size Checks the fleet's fleet size fleet
host_has_dlc Checks if the host has a specific DLC enabled
local_has_dlc Checks if the local player has a specific DLC enabled
num_rare_techs Checks the country's number of researched rare technologies country
has_mandate Checks if the leader has any, or a specific, mandate leader
nor An inverted OR trigger
nand An inverted AND trigger
num_energy Checks the planet's total amount of energy planet
num_armies Checks the country's number of armies country
has_war_goal Checks if a war goal is set. all
max_naval_capacity Checks the country's max naval capacity in absolute numbers country
used_naval_capacity_integer Checks the country's used naval capacity in absolute numbers country
used_naval_capacity_percent Checks the country's used naval capacity in relative terms (0.00-1.00) country
war_begun_num_fleets_gone_mia Checks amount of target country's fleets that went MIA when the war began war
custom_tooltip_success Shows custom text only when the associated trigger passes all
has_active_event Checks if country has active events: country
success_text For 'desc={trigger={' use. Shows custom text when the associated trigger passes. all
fail_text For 'desc={trigger={' use. Shows custom text when the associated trigger fails. all
is_subject_type Checks if the country is a specific type of subject country
has_defensive_pact Checks if the country has a defensive pact with target country country
calc_true_if Returns true if the specified number of sub-triggers return true all
is_researching_technology Checks if the country is currently researching a specific technology country
is_subject Checks if the country is a subject of any other country country
any_subject Checks if any of the country's subject states meet the specified criteria country
log Prints a message to game.log for debugging purposes all
is_enigmatic_to Checks if the country has a enigmatic attitude towards target country country
is_berserker_to Checks if the country has a berserker attitude towards target country country
has_same_ethos Checks if a country has the same ethos (complete set of ethics) as a country or pop country pop
is_majority_species checks if a planet/country has a particular species as its dominant species
has_closed_borders Check if the country has closed its borders to target country country
is_difficulty Checks the game's difficulty level (0 normal, 1 hard, 2 insane) all
is_exact_same_species Checks if the scoped object is originally of the same species, or currently of the exact same species instance, as another object country ship pop leader army species
can_control_access_for Checks if the country is allowed to control target country's border access to the country country
is_overlord_to Checks if the country has an overlord attitude towards target country country
is_improving_relations_with Checks if the country has an envoy sent to the target country to improve relations country
is_harming_relations_with Checks if the country has an envoy sent to the target country to improve relations country
distance_to_core_percent Checks the ship/fleet/planet/leader/pop/system's distance to the galactic core in percent, where center = 0 and galactic rim = 100 all
has_non_aggression_pact Check if the country has a non-aggression pact with target country country
happiness_planet Checks the average happiness on the planet planet
pre_ruler_leader_class Checks the rulers previous leader class leader
has_hp_percentage Checks a fleet or ship's hit points percentage ship fleet
can_join_factions Checks if scoped pop can join a faction
is_custodial_to Checks if the country has a custodial attitude towards target country country
has_valid_civic Checks if the current country has a certain civic and if its validated country
has_non_swapped_tradition Checks if a country has the given tradition and it is not swapped. country
has_swapped_tradition Checks if a country has the given swapped tradition. country
is_event_leader Checks if a leader is a special event leader (defined in create_leader) leader
is_crises_allowed Check if current game allows crises all
is_custom_capital_location Checks if the spatial object is its owner's custom capital location planet ship fleet galactic_object
resource_stockpile_compare Checks specific resource stockpile for the country scope: country
planet_resource_compare Checks specific resource value for province scope scope: planet
resource_income_compare Checks specific resource income value for the country scope: country
pop_percentage Checks the percentage of pops in the scope that fulfill the specified criteria planet country pop_faction
num_species Checks if the number of species on a planet, in an empire or in a pop faction is according to the argument. Does not count genetically modified species as unique. planet country pop_faction
num_unique_species Checks if the number of species on a planet, in an empire or in a pop faction is according to the argument. Counts genetically modified species as unique. planet country pop_faction
has_diplo_migration_treaty Checks if two countries have a migration treaty.
has_presence Checks if a system contains any fleets, stations, mega structures or colonized planets. galactic_object
is_megastructure_type is_megastructure_type = <name of type>. Compares the type of scope's mega structure to a type from the database
is_upgrading is_upgrading = <yes/no>. Checks if the scope's fleet or mega structure is currently upgrading
relative_power Compares relative power between two countries. relative_power = { who = <target country> category = <fleet/economy/technology/all> value ><= <pathetic/inferior/equivalent/superior/overwhelming>
has_tradition Checks if a country has the given tradition. country
any_relation Iterate through all relations country
has_megastructure_flag Checks if the mega structure has a specific flag megastructure
has_citizenship_type Checks if a species/pop/leader has a particular citizenship type in their country pop leader species
has_population_control Checks if the pop is prevented from reproducing pop
has_migration_control Checks if the pop is prevented from migrating pop
species_planet_slave_percentage Checks if a pop's planet has a specific percentage (0.00-1.00) of the same species enslaved pop
has_ascension_perk Checks if a country has the given ascension perk. country
num_ascension_perks Compares the number of AP points the country has spent with the given value country
pop_produces_resource Checks if a pop is currently producing a particular resource pop
has_military_service_type Checks if a species/pop/leader has a particular military service type in their country pop leader species
has_purge_type Checks if a species/pop/leader has a particular purge type in their country pop leader species
has_slavery_type Checks if a species/pop/leader has a particular slavery type in their country pop leader species
has_living_standard Checks if a species/pop/leader has a particular living standard in their country pop leader species
count_planets Checks the planets in system that meet the criteria galactic_object
num_ascension_perk_slots Compares the number of unlocked ascension perk slots of the scope with the given value country
is_fleet_idle Checks if the ship/fleet is idfle ship fleet
debug_break Trigger an assertion to stop the debugger when encountering this trigger; returns the value it is assigned all
has_civic Checks if the current country has the specified civic country dlc_recommendation
has_authority Checks if the current country has the specified government authority country dlc_recommendation
has_invalid_civic Checks if the current country has a certain civic and if its invalidated country
has_colonization_control Checks if the pop is prevented from migrating pop species
has_trade_route Checks if a system has trade route going through. galactic_object
trade_route_value Checks the trade value going through the system. galactic_object
trade_intercepted_percentage Checks the intercepted trade value ratio going through the system. galactic_object
trade_intercepted_value Checks the intercepted trade value going through the system. galactic_object
trade_protected_value Checks the protected trade value going through the system. galactic_object
trade_protected_percentage Checks the protected trade value ratio going through the system. galactic_object
num_trade_routes Counts the number trade routes in the empire. country
count_species Counts the number of species in the scope that fulfill the specified criteria, not counting sub-species as unique. planet country
count_exact_species Counts the number of species in the scope that fulfill the specified criteria, counting sub-species as unique. planet country
is_constructing Checks if the scoped construction ship is building the specified thing ship fleet
has_ruler_trait Checks if a leader has a certain ruler trait, even if they are not currently ruler leader
num_trait_points Checks the country/pop/leader/species' number of traits points spent country pop leader species
has_component Checks if a ship has a certain component ship
has_notification_modifier Checks if a country has a certain notification modifier country
pop_maintenance_cost Checks the maintenace costs of a pop pop
conditional_tooltip The enclosed trigger will be completely ignored if the condition in "trigger" isn't true. Useful to hide part of tooltips that are not relevant.
has_natural_wormhole Returns true if the scopes system contains at least one natural wormhole galactic_object
has_claim Checks if the country has claims on the given country or system. country
num_active_gateways Checks the number of active gateways in the galaxy all
attacker_war_exhaustion Checks the war exhaustion of the war's attackers war
defender_war_exhaustion Checks the war exhaustion of the war's defenders war
off_war_exhaustion_sum Checks the country's total war exhaustion for all offensive wars country
def_war_exhaustion_sum Checks the country's total war exhaustion for all defemsove wars country
has_starbase_module Checks if the starbase has a specific module starbase
has_starbase_building Checks if the starbase has a specific building starbase
has_starbase_size Compares the starbase ship size starbase
has_seen_any_bypass Checks the scoped country has ever encountered a bypass of a given type before country
has_seen_specific_bypass Checks the scoped country has encountered a specific bypass before country
owns_any_bypass Checks if the scoped country controls any system containing a bypass of a specific type country
has_casus_belli Checks if the country has a valid casus belli (any casus belli or a specific one) on the given country. country
num_starbases Counts the number of starbases owned by the scoped country country
num_owned_active_gateways Checks the number of active gateways owned by the scoped country country
using_war_goal Checks if a war has a specific war goal war
has_status Checks the current status of the scoped ship or fleet. ship fleet
valid_planet_killer_target Checks if the scoped fleet can target the given planet with its planet killer weapon fleet
has_orbital_bombardment Checks whether a planet is under bombardment planet
has_orbital_bombardment_stance Checks to what degree the planet is being bombarded planet
count_starbase_sizes Checks if the scoped country has a specified quantity of a starbase size country
command_limit Checks the country's command limit country
has_hyperlane_to Checks if the system has a hyperlane connection to target system galactic_object
is_bridge Checks if a system has the bridge flag or not. galactic_object
inverted_switch Switch case for a trigger treated as NOT. all
is_scope_set Checks if the scope is set for appropriate target planet country ship pop fleet
is_primary_star Checks if the planet is the system's primary star planet
uses_district_set Checks if the planet has the specified tag for district usage: planet
last_changed_species_rights_type Check if the last species rights type changed for the pop or leader is of type type pop leader
controlled_systems Checks the country's number of controlled systems country
exploitable_planets Checks the country has planets that are unexploited country
controlled_colonizable Checks the country controls planets that are colonizable country
ai_colonize_plans Checks how many plans the AI have for colonization (lighter than controlled_colonizable for AI) country
scientist_count Checks the countrys' number of scientists country
has_ai_expansion_plan Checks if the country AI has any plans to expand country
is_on_market Checks if resource is enabled on the Galactic Market all
highest_threat Checks the countrys' highest threat against it country
has_rival Checks if the target country is the country's rival country
has_overlord Checks if the target country is the country's overlord country
has_sector_type Checks if the sector has a specific type sector
num_sectors Counts the number of sectors owned by the scoped country country
has_deposit_category Checks if a deposit has specified category deposit
has_relic Checks if the scoped country has the specified relic country
caravaneers_enabled Checks if Caravaneers are enabled in game setup
xeno_compatibility_enabled Checks if Xeno Compatibility are enabled in game setup
num_housing Checks the planet's total housing planet
is_sector_capital Checks if the planet is its sector's capital planet
has_sector_focus Checks if the sector has a certain focus sector
is_site_last_die_result Compares the last dice roll. archaeological_site
is_current_stage_difficulty Compares the current stage difficulty. archaeological_site
is_site_at_stage Compares the current stage index. archaeological_site
is_current_stage_clues Compares the current stage clues. archaeological_site
is_site_days_to_next_die_roll Compares days to next die roll. archaeological_site
is_site_last_excavator Checks last excavating country. archaeological_site
is_site_type Checks the type of the site. archaeological_site
is_site_completed Checks if all stages has ben completed. archaeological_site
is_site_under_excavation Checks if the site is currently being excavated. archaeological_site
is_site_current_stage_score Compares the current stage discovery score. archaeological_site
is_site_current_stage_score_no_die Compares the current stage discovery score excluding the current die roll. archaeological_site
is_current_excavator_fleet Checks current excavator fleet. archaeological_site
federation_experience Checks experience of the federation. federation
federation_cohesion Checks cohesion of the federation. federation
federation_cohesion_growth Checks cohesion growth of the federation. federation
has_any_federation_law_in_category Checks if given law category has any active law federation
has_federation_law Checks if given law has been enacted in scoped federation federation
has_federation_perk Checks if given perk has been unlocked in scoped federation federation
has_federation_type Checks if federation has specific federation type federation
federation_level Checks federation level in comparison to given value in scoped federation federation
is_voting_on_resolution Checks if the Galactic Community is currently voting on any, or a specific, resolution all
is_proposing_resolution Checks if the scoped country is currently proposing any, or a specific, resolution country
is_years_since_community_formation Compare with number of years since the formation of the Galactic Community. NOTE: A negative value means it hasn't been formed yet! all
is_years_since_council_establishment Compares with number of years since the establishment of the Galactic Council. NOTE: A negative value means it hasn't been established yet! all
is_galactic_community_formed Checks if the Galactic Community has been formed all
is_galactic_council_established Checks if the Galactic Council has been established all
is_galactic_community_member Checks if scoped country is part of the Galactic Community country
is_part_of_galactic_council Checks if scoped country is part of the Galactic Council country
has_origin Checks if scoped country has specified origin country dlc_recommendation
is_last_lost_relic Checks whether the relic passed in parameter is the last relic lost by the country int the current scope. country
is_last_received_relic Checks whether the relic passed in parameter is the last relic received by the country int the current scope. country
is_active_resolution Checks if the provided Resolution is active in the Community all
is_in_breach_of_any Checks if an empire is in breach of any galactic resolution country
in_breach_of Checks if the scoped country is in breach of the specified resolution (or would be, were it to be enacted) country
num_council_positions Compares the number of council positions in the Galactic Community. all
galactic_community_rank Compares empire rank ( sorted by diplomatic weight ) in the Galactic Community. NOTE: If the scoped country isn't part of the community this returns -1. country
is_permanent_councillor Checks if an empire has a permanent seat on the Galactic Council country
has_federation_setting Checks if given setting is on for scoped federation federation
any_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria planet country
any_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria planet country
num_ai_empires_setting Checks the number of AI empires defined in setup all
galaxy_size Checks whether the galaxy size if of a certain type all
pop_has_happiness Checks if the current pop has happiness or not. pop
has_current_purge Checks if any pops are being purged on the current planet. planet
species_has_happiness_with_owner Checks if the current species has happiness or not when owned by a specified country. species
num_planets_in_system Checks the solar system's total number of planets galactic_object
any_owned_army Iterate through each army that is owned by the country country
count_owned_army Iterate through each army that is owned by the country country
any_planet_army Iterate through each defending army on a planet planet
count_planet_army Iterate through each defending army on a planet planet
count_country Iterate through all countries all
count_relation Iterate through all relations country
any_neighbor_country Iterate through all neighbor countries country
count_neighbor_country Iterate through all neighbor countries country
count_bordering_country Iterate through all bordering countries of a system galactic_object
any_rival_country Iterate through all countries rivalled by the scoped country country
count_rival_country Iterate through all countries rivalled by the scoped country country
any_federation_ally Iterate through all countries in a federation with the scoped country country
count_federation_ally Iterate through all countries in a federation with the scoped country country
count_playable_country Iterate through all playable countries all
any_federation Iterate through each federation all
count_federation Iterate through each federation all
any_combatant_fleet Iterate through each fleet this fleet is in combat with fleet
count_combatant_fleet Iterate through each fleet this fleet is in combat with fleet
any_fleet_in_system Iterate through each fleet in the current system galactic_object
count_fleet_in_system Iterate through each fleet in the current system galactic_object
count_owned_fleet Iterate through each fleet owned by the country country
count_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure megastructure planet starbase
any_recruited_leader Iterate through each leader that is owned by the country country
count_recruited_leader Iterate through each leader that is owned by the country country
any_pool_leader Iterate through each leader that is recruitable for the country country
count_pool_leader Iterate through each leader that is recruitable for the country country
any_envoy Iterate through each envoy available to the country country
count_envoy Iterate through each envoy available to the country country
any_megastructure Iterate through each megastructure all
count_megastructure Iterate through each megastructure all
any_owned_megastructure Iterate through each owned megastructure country
count_owned_megastructure Iterate through each owned megastructure country
any_system_megastructure Iterate through each megastructure in system all
count_system_megastructure Iterate through each megastructure in system all
count_owned_pop Iterate through all owned pops planet country pop_faction
any_pop_faction Iterate through all the country's pop factions country
count_pop_faction Iterate through all the country's pop factions country
any_owned_pop_species Iterate through each species of a country's owned pops country
count_owned_pop_species Iterate through each species of a country's owned pops country
any_galaxy_species Check if any species in the galaxy meet the specified criteria all
count_galaxy_species Check if any species in the galaxy meet the specified criteria all
count_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria planet country
count_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria planet country
any_owned_starbase Iterate through every owned starbase country
count_owned_starbase Iterate through every owned starbase country
any_system Iterate through all systems all
count_system Iterate through all systems all
count_rim_system Iterate through all rim systems all
any_system_within_border Iterate through all systems within the country's borders country
count_system_within_border Iterate through all systems within the country's borders country
any_war_participant Iterate through all war participants war
count_war_participant Iterate through all war participants war
count_war Iterate through all wars the country is engaged in country
any_sector Iterate through all sectors all
count_sector Iterate through all sectors all
any_owned_sector Iterate through every owned sector country
count_owned_sector Iterate through every owned sector country
count_member Iterate through each member of the federation federation
count_owned_ship Iterate through each ship in the fleet or owned by the country country fleet
Flat list of effect scopes (v2.7.2)
Scope Description From scope
tooltip Just a tooltip all
hidden_effect Prevents enclosed effects from being displayed in tooltip all
custom_tooltip Displays a specific localization string in tooltip all
if Executes enclosed effects if limit criteria are met all
end_all_treaties_with Ends all treaties with the target country
random_list Picks one random set of effects from a list, influenced by relative weight all
locked_random_list Picks one random set of effects from a list, influenced by relative weight once per event scope all
every_owned_planet Executes enclosed effects on every planet -owned by the scoped country- that meet the limit criteria country
random_owned_planet Executes enclosed effects on a planet -owned by the scoped country- that meets the limit criteria country
every_controlled_planet Executes enclosed effects on every planet -controlled by the scoped country- that meet the limit criteria country
random_controlled_planet Executes enclosed effects on a random planet -owned by the scoped country- that meets the limit criteria country
remove_deposit Remove resource deposit on the scoped planet or deposit, does not fire on_cleared if used on a blocker planet deposit
set_owner Instantly sets the owner of the scoped planet/fleet/army/starbase to target country planet fleet leader army starbase
unemploy_pop Fires scoped pop from its job pop
check_planet_employment Immediately runs a job evaluation on the planet, firing and employing pops as needed planet
change_species_portrait Changes the portrait of the species in scope. species
every_war_defender Executes enclosed effects on every defender that meets the limit criteria in the scoped country's war with a specific enemy country
clear_pop_category Resets category of a pop pop
every_war_attacker Executes enclosed effects on every attacker that meets the limit criteria in the scoped country's war with a specific enemy country
random_war_defender Executes enclosed effects on a random defender that meets the limit criteria in the scoped country's war with a specific enemy all
add_random_non_blocker_deposit Adds random non-blocker resource deposit to the scoped planet planet
random_war_attacker Executes enclosed effects on a random attacker that meets the limit criteria in the scoped country's war with a specific enemy all
remove_last_built_building Removes last built building from the scoped planet planet
remove_all_buildings Removes all buildings from the scoped planet planet
give_technology Instantly gives a specific tech to the scoped country country
add_building Begins construction of a specific building on the scoped planet planet
add_planet_devastation Instantly adds devastation to scoped planet planet
create_half_species Creates a new pop from a half-species on the planet all
calculate_modifier Forces target planet or country to calculate its internal modifier planet
establish_branch_office Establish branch office on scoped planet for target country planet
close_branch_office Close branch office on scoped planet planet
clear_blockers Removes all blockers from the scoped planet planet
set_built_species Changes the built species of the scoped object country
set_federation_flag Sets an arbitrarily-named flag on the scoped federation federation
set_country_flag Sets an arbitrarily-named flag on the scoped country country
set_planet_flag Sets an arbitrarily-named flag on the scoped planet planet
set_fleet_flag Sets an arbitrarily-named flag on the scoped fleet fleet
set_ship_flag Sets an arbitrarily-named flag on the scoped ship ship
remove_federation_flag Removes a flag from the scoped federation federation
remove_country_flag Removes a flag from the scoped country country
remove_planet_flag Removes a flag from the scoped planet planet
remove_fleet_flag Removes a flag from the scoped fleet fleet
remove_ship_flag Removes a flag from the scoped ship ship
every_owned_ship Iterate through each ship in the fleet or owned by the country country fleet
random_owned_ship Iterate through each ship in the fleet or owned by the country country fleet
create_species Creates a new species all
create_country Creates a new country all
create_fleet Creates a new fleet all
create_army Creates a new army planet
modify_army Modifies army with parameters: army
set_location Sets the fleet/ambient object's location, can be fine-tuned fleet ambient_object
create_ship Creates a new ship fleet starbase
set_primitive [DEPRECATED, USE SET_COUNTRY_TYPE] Sets the scoped country as primitive country
create_pop Creates a new pop on the scoped planet planet
create_colony Creates a colony on the scoped planet planet
set_capital Sets the scoped planet to be the capital of its owner country planet
change_pc Changes the class of the scoped planet planet
random_country Iterate through all countries all
random_pop Executes enclosed effects on a random pop that meets the limit criteria planet
kill_pop Instantly destroys the scoped pop pop
destroy_colony Destroys the colony on the scoped planet planet
add_experience Adds a sum of experience points to the scoped leader leader
set_ring Adds or removes a planetary ring around the scoped planet planet
create_mining_station Creates a mining station in orbit of the scoped planet planet
create_research_station Creates a research station in orbit of the scoped planet planet
set_pop_flag Sets an arbitrarily-named flag on the scoped country pop
remove_pop_flag Removes a flag from the scoped pop pop
every_owned_pop Iterate through all owned pops planet country pop_faction
set_name Sets the name of the scoped country/planet/ship/fleet/leader/army/system/pop faction megastructure planet country ship fleet galactic_object leader army pop_faction federation
random_planet Executes enclosed effects on a random planet that meets the limit criteria all
add_modifier Adds a specific modifier to the scoped planet/pop/country/fleet/ship/pop/system/faction for a set duration megastructure planet country ship pop fleet galactic_object pop_faction federation
reduce_hp Reduces the hull points of the scoped ship by a specific amount ship
reduce_hp_percent Reduces the hull points of the scoped ship by a relative amount ship
repair_ship Restores all hull points to the scoped ship ship
destroy_country Destroys the scoped country country
set_variable Sets or creates an arbitrarily-named variable with a specific value in the current scope megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector
remove_global_flag Removes a global flag all
set_global_flag Sets an arbitrarily-named global flag all
change_variable Increments a previously-set variable by a specific amount megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector
every_galaxy_pop Executes enclosed effects for every pop in the game that meet the limit criteria all
every_country Iterate through all countries all
every_playable_country Iterate through all playable countries all
random_playable_country Iterate through all playable countries all
every_ship Executes enclosed effects for every ship in the game that meet the limit criteria all
every_planet Executes enclosed effects for every planet in the game that meet the limit criteria all
set_event_locked Silently disables the scoped fleet to prevent player action, remember to unlock at the end of the event fleet
clear_orders Clears all fleet orders from the scoped fleet fleet
order_forced_return Forces scoped fleet to retreat to friendly territory fleet
declare_war Declares war between the scoped country and target country country
set_star_flag Sets an arbitrarily-named flag on the scoped system galactic_object
remove_star_flag Removes a flag from the scoped system galactic_object
set_spawn_system_batch Optimizes the calls for spawn_system effect. all
spawn_system Spawns a new system at a position relative to the scoped system/planet/ship. megastructure planet ship fleet galactic_object starbase no_scope
random_research_station Executes enclosed effects on a random orbital research station that meets the limit criteria planet
dismantle Dismantles the scoped orbital station (fleet) fleet
random_mining_station Executes enclosed effects on a random orbital mining station that meets the limit criteria planet
set_advisor_active Enables or disables the VIR window pop-in country
save_event_target_as Saves the current scope as an arbitrarily-named target to be referenced later in the (unbroken) event chain all
save_global_event_target_as Saves the current scope as an arbitrarily-named target to be referenced later, accessible globally until cleared all
clear_global_event_target Deletes the specified saved global target reference all
clear_global_event_targets Deletes all saved global target references all
break Prevents execution of subsequent effects in the same effect block, used with if-statements all
set_tutorial_level Changes the scoped country's tutorial level (0 none, 1 limited, 2 full) country
begin_event_chain Starts a situation log event chain for target country all
end_event_chain Ends a specific situation log event chain for the scoped country country
queue_actions Adds actions to the scoped fleet's action queue fleet
clear_fleet_actions Clears all queued fleet actions for target fleet fleet
destroy_fleet Destroys the target fleet (with death graphics) all
create_ambient_object Creates a new ambient object all
destroy_ambient_object Destroys target ambient object all
add_trait Adds a specific trait to the scoped leader leader
remove_trait Removes a specific trait from the scoped leader leader
modify_species Creates a new, modified species based on an already-extant species planet country pop leader species
add_opinion_modifier Adds a specific opinion modifier for the scoped country towards target country country
establish_contact Establishes first contact between the scoped country and target country at the set location country
set_faction_hostility Sets the aggro state of the scoped faction-type country country
set_market_leader Set scoped country as the current Galactic Market leader. set_market_leader = <yes/no>
random_system_planet Executes enclosed effects on a random planet within the scoped system that meets the limit criteria galactic_object
add_event_chain_counter Increments (or decrements with negative values) an event chain counter for the scoped country by a specific amount country
add_anomaly Adds a specific anomaly category to the scoped planet all
set_disable_at_health Sets the scoped ship to become disabled at a certain hull point percentage ship
remove_building Removes a specific building from the scoped planet planet
change_planet_size Increases or reduces the size of the scoped planet by a specified amount planet
every_deposit Executes on every deposit on planet
random_deposit Executes enclosed effects on a random deposit on the scoped planet that meets the limit criteria planet
create_point_of_interest Creates a point of interest for the scoped country at a specific location, associated with an event chain planet country ship pop
remove_point_of_interest Removes a specific point of interest from the scoped country's situation log country
set_relation_flag Sets a relation flag for the scoped country towards target country country
remove_relation_flag Removes a specific relation flag towards target country from the scoped country country
random_moon Executes enclosed effects on a random moon that meets the limit criteria planet
every_moon Executes enclosed effects on every moon that meets the limit criteria planet
kill_leader Kills the scoped leader or leader of the scoped country/fleet/ship/planet/army planet country ship fleet leader army
assign_leader Assigns target leader to the scoped country/fleet/army/pop faction/sector country fleet army pop_faction sector
country_add_ethic Adds a specific ethic to the scoped country country
country_remove_ethic Removes a specific ethic from the scoped country country
set_timed_federation_flag Sets an arbitrarily-named flag on the scoped federation for a set duration federation
set_timed_country_flag Sets an arbitrarily-named flag on the scoped country for a set duration country
set_timed_fleet_flag Sets an arbitrarily-named flag on the scoped fleet for a set duration fleet
set_timed_global_flag Sets an arbitrarily-named global flag for a set duration all
set_timed_planet_flag Sets an arbitrarily-named flag on the scoped planet for a set duration planet
set_timed_pop_flag Sets an arbitrarily-named flag on the scoped pop for a set duration pop
set_timed_relation_flag Sets an arbitrarily-named flag for the scoped country towards target country for a set duration country
set_timed_ship_flag Sets an arbitrarily-named flag on the scoped ship for a set duration ship
set_timed_star_flag Sets an arbitrarily-named flag on the scoped system for a set duration galactic_object
every_planet_within_border Executes enclosed effects on every planet within the scoped country's borders that meet the limit criteria country
every_rim_system Iterate through all rim systems all
random_rim_system Iterate through all rim systems all
remove_modifier Removes a specific modifier from the scopes planet/country/pop/system megastructure planet country ship pop fleet galactic_object pop_faction federation
add_ship_design Adds a specific ship design to the scoped country country
add_mission_progress Adds or subtracts progress to/from the scoped observation post's current mission fleet
create_army_transport Creates a new army in a new transport ship fleet
switch Executes the first appropriate effect set for a specific trigger all
set_pop_faction Sets the scoped pop to belong to a specific pop faction pop
set_graphical_culture Sets the scoped object's graphical culture megastructure country
set_formation_scale Scales the scoped fleet's formation's ship spacing, above and below 1.0 fleet
set_controller Instantly sets the planet/fleet's controller to target country planet fleet
force_faction_evaluation Forces target pop to immediately evaluate their attraction to various pop factions pop
enable_faction_of_type Forces scoped country to evaluate whether to create a specific faction type immediately, rather than monthly country
clear_uncharted_space Clears uncharted space from the galaxy map for the scoped country, in a radius around target system country
every_owned_leader Executes enclosed effects on every leader owned by scoped country that meets the limit criteria country
random_owned_leader Executes enclosed effects on a random leader owned by scoped country that meets the limit criteria country
establish_communications Establish communications between scoped country and target country country
add_monthly_resource_mult Adds a lump sum of a resource to the scoped country, defined as a multiple of the country's monthly income of that resource (clamped to max and min allowed values) country
set_leader_flag Sets an arbitrarily-named flag on the scoped leader leader
remove_leader_flag Removes a flag from the scoped leader leader
add_research_option Adds a tech research option to the scoped country's tech view list, permanent until researched country
set_heir Sets the target leader to be the scoped country's heir country
leave_alliance Removes scoped country from any alliances it is in country
random_owned_pop Iterate through all owned pops planet country pop_faction
set_policy Sets a policy to a specific option for the scoped country and specifies if policy cooldown should go into effect all
recruitable Sets scoped leader as non/recruitable leader
closest_system Executes enclosed effects on a system -within a specific number of jumps span- that meets the limit criteria. This completely ignores bypasses (wormholes and gateways) all
random_owned_fleet Iterate through each fleet owned by the country country
random_ambient_object Executes enclosed effects on a random ambient object in the game that meets the limit criteria all
random_system_ambient_object Executes enclosed effects on a random ambient object in the scoped system that meets the limit criteria galactic_object
every_ambient_object Executes enclosed effects on every ambient object in the game that meets the limit criteria all
every_system_ambient_object Executes enclosed effects on every ambient object in the scoped system that meets the limit criteria galactic_object
set_ambient_object_flag Sets an arbitrarily-named flag on the scoped ambient object ambient_object
set_timed_ambient_object_flag Sets an arbitrarily-named flag on the scoped ambient object for a set duration fleet
remove_ambient_object_flag Removes a flag from the scoped ambient object ambient_object
every_fleet_in_system Iterate through each fleet in the current system galactic_object
random_fleet_in_system Iterate through each fleet in the current system galactic_object
set_aggro_range Sets the scoped fleet/country's aggro range in intra-system units country fleet
set_fleet_stance Sets the stance of the scoped fleet fleet
add_favors Add <value> favors for scoped country to use on target country. add_favor = { country
remove_favors Remove <value/all> favors that scoped country have on target country: country
set_aggro_range_measure_from Determines whether the scoped fleet/country's aggro range is measured from the fleet's current position or its spawn location country fleet
establish_communications_no_message Silently establish communications between scoped country and target country country
remove_war_participant Removes a specified country from the war war
set_subject_of Sets the scoped country to be a specific subject of target country country
unassign_leader Unassigns scoped leader from their post or unassigns leader from the scoped planet/ship/fleet/army ship fleet leader army
exile_leader_as Exiles the scoped country/fleet/army/pop faction's leader and saves them with a custom name country fleet leader army pop_faction
set_leader Reinstates a previously-exiled leader to the scoped country/fleet/army/pop faction country fleet army pop_faction
add_skill Adds a sum of experience points to the scoped leader leader
set_skill Sets the scoped leader's level leader
every_neighbor_system Executes enclosed effects on every one of the scoped system's neighboring systems that meet the limit criteria galactic_object
random_neighbor_system Executes enclosed effects on a random system neigboring the scoped system that meets the limit criteria galactic_object
set_federation_leader Sets a country to lead a federation
add_colony_progress Adds to ongoing colonization progress on the scoped planet planet
start_colony Starts colonization of the scoped planet planet
subtract_variable Decrements a previously-set variable by a specific amount megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector
multiply_variable Multiplies a previously-set variable by a specific amount megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector
divide_variable Divides a previously-set variable by a specific amount megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector
play_sound Play the defined sound effect all
set_crisis_sound Sets the crisis ambient loop to the current effect all
stop_crisis_sound Stops the crisis ambient loop all
force_add_civic Adds civic to a goverment without checking the restrictions country
force_remove_civic Removes civic to a goverment without checking the restrictions country
set_is_female Sets the gender of the scoped leader leader
create_fleet_from_naval_cap Creates a new fleet from empire designs up to specified fraction of naval cap country
remove_opinion_modifier Removes a specific opinion modifier towards target country or any contry from the scoped country country
set_war_goal Sets a war goal to the scoped rebel country/war country war
change_country_flag Changes the scoped country's flag country
add_threat Adds diplomatic threat from target country planet country galactic_object
set_mission Sets the current mission of an observation station
change_dominant_species Changes the dominant species of the current Country, change_all also changes all usage of that species (Pops etc) in the empire country
end_rivalry Force-end rivalry with target country country
set_truce Force a truce with target country of a specified typ, or a war country
end_truce Force-end truce with target country country
set_species_flag Sets an arbitrarily-named flag on the scoped species species
set_timed_species_flag Sets an arbitrarily-named flag on the scoped species for a set duration species
remove_species_flag Removes a flag from the scoped species species
auto_move_to_planet Makes a fleet or ship auto-move to target planet ship fleet
remove_auto_move_target Makes a fleet or ship stop auto-moving ship fleet
auto_follow_fleet Makes a fleet or ship auto-move to target fleet and potentially attack it ship fleet
set_closed_borders Changes closed borders status between two countries
every_war_participant Iterate through all war participants war
repair_percentage Restores all hull points to the scoped ship ship fleet
endgame_telemetry Send endgame telemetry event
set_deposit Replaces resource deposit on the scoped planet planet
randomize_flag_symbol Randomizes a country's flag symbol within the selected category country
add_claims Adds claims on target system galactic_object
remove_claims Removes claims on target system galactic_object
create_military_fleet Creates a military fleet with the designs of a specified country.
guarantee_country Makes a country guarantee another country
every_owned_fleet Iterate through each fleet owned by the country country
every_subject switches Scope to and goes through all Subjects
random_subject Scopes to a random Subject
set_species_homeworld Defines a homeworld for the current species.
clear_resources Clears resources of a country
reroll_planet_modifiers Rebuild modifiers on target planet planet
reroll_deposits Rebuild resource deposits on target planet planet
delete_fleet Deletes the target fleet (no death graphics) all
add_trust Adds trust on scope country towards target country country
add_tradition Adds the specified tradition to the scoped country. add_tradition = <tradition_key>
join_war Joins wars on the side of target country country
add_global_ship_design Adds a specific global design to the game all
every_mining_station Executes enclosed effects on every orbital mining station in the game that meets the limit criteria planet country
every_research_station Executes enclosed effects on every orbital mining station in the game that meets the limit criteria planet country
set_timed_leader_flag Sets an arbitrarily-named flag on the scoped leader for a set duration leader
set_species_identity Sets the current species scopes identity to match the target scopes making them evaluate as the same species in is_same_species trigger.
pop_force_add_ethic Adds a specific ethic to the scoped pop regardless if pop-species allows ethic divergence or not. pop
set_empire_name Sets the name of the current Empire.
set_empire_flag Sets the flag of the current Empire.
set_planet_name Sets the name of the current planet.
set_fleet_formation Sets a custom fleet formation on a fleet. set_fleet_formation = { position = { x = 1 y = 1 } position = { x = 2 y = 1 } }
create_message Creates a message, can take multiple variables all
set_halted Sets the mega structure upgrade to halted status for n days megastructure
upgrade_megastructure_to Starts an upgrade process on a mega structure. upgrade_megastructure_to = <new_type>
set_planet_entity Change entity of a planet. planet
remove_planet Removes the planet from the scope planet
set_megastructure_flag Sets an arbitrarily-named flag on the scoped mega structure megastructure
set_timed_megastructure_flag Sets an arbitrarily-named flag on the scoped mega structure for a set duration megastructure
remove_megastructure_flag Removes a flag from the scoped mega structure megastructure
destroy_ship Destroys the target ship (with death graphics) all
delete_ship Deletes the target ship (no death graphics) all
change_species Changes the species of the scoped object country ship pop leader army
change_leader_portrait Changes the portrait of the leader in scope. leader
resettle_pop Instantly resettles pop all
set_citizenship_type Set citizenship type for scoped species/pop/leader pop leader species
set_military_service_type Set military service type for scoped species/pop/leader pop leader species
set_purge_type Set purge type for scoped species/pop/leader pop leader species
set_slavery_type Set slavery type for scoped species/pop/leader pop leader species
set_population_controls Set population control for scoped species/pop/leader pop leader species
set_migration_controls Set migration control for scoped species/pop/leader pop leader species
set_living_standard Set living standard for scoped species/pop/leader pop leader species
shift_ethic Shifts an empire towards a specific ethic, adjusting aferwards to keep number of ethics points consistent country
pop_change_ethic Changes scoped pop to chosen ethic pop
clear_ethos Clears all ethics of specified pop or country country pop
clear_planet_modifiers Clear modifiers on target planet planet
remove_all_armies Removes all armies on scoped planet planet
mutate_species Randomly mutate a species.
rename_species rename_species = { species
reset_years_of_peace Resets years of peace for a country.
add_ruler_trait Adds a specific ruler trait to the scoped leader, even if they are not currently ruler; it becomes active when they become ruler leader
remove_ruler_trait Removes a specific ruler trait from the scoped leader, even if they are not currently ruler; this is relevant if they ever become ruler leader
add_notification_modifier Add a notification modifier to the country country
remove_notification_modifier Remove a notification modifier to the country country
set_city_graphical_culture Sets the scoped country's city graphical culture country
set_player Assign the player of the target country to play the scoped country instead country
change_species_characteristics Changes the characteristics of a species species
copy_techs_from Copies all techs from the target country to the scoped country, except for some exceptions listed. Tech weights (and weight modifiers) are honoured, meaning that techs a country should not have will not be copied. country
create_bypass Creates a bypass in the parent SpatialObject (stored in FromFrom), of the type passed in "type".
activate_gateway Activates the gateway associated with a megastructure.
spawn_natural_wormhole Spawns a new natural wormhole in the scoped system. galactic_object
link_wormholes Link the wormhole from the scoped system to the wormhole in the target system. galactic_object
create_starbase Creates a starbase in orbit of the star of the scoped galactic object galactic_object
set_starbase_size Sets the ship size of a starbase starbase
set_starbase_module Sets a module in a slot on a starbase starbase
set_starbase_building Sets a building in a slot on a starbase starbase
add_casus_belli Adds a Casus Belli to the scoped country against the target country. country
get_galaxy_setup_value Copies a value from the galaxy setup into a variable, optionally scaling it by an int value all
finish_upgrade Finish the current upgrade of a Mega Structure. megastructure
effect_on_blob Executes an effect on systems with planets owned by the scoped country, starting at an origin, and until a certain percentage of owned planets matching the planet_limit has been covered. country
add_seen_bypass_type Makes the scoped country remember that it has encountered the bypass type country
add_seen_bypass Makes the scoped country remember that it has encountered the bypass country
set_fleet_bombardment_stance Sets the bombardment stance of the scoped fleet fleet
check_casus_belli_valid Re-evaluate the specified casus belli type with given target country country
copy_ethos_and_authority Makes the scoped country copy the ethos and government authority of the target country. country
clone_leader Clones the last created leader for the scoped country country
set_home_base Set the home base of the scoped fleet to the specified starbase fleet
add_hyperlane Adds a hyperlane between two systems all
remove_hyperlane Removes existing hyperlane between two systems all
else_if Executes enclosed effects if limit criteria of preceding 'if' or 'else_if' is not met, and its own limit is met all
create_saved_leader Creates a new saved leader for the scoped country with a lookup key country
remove_saved_leader Removes a saved leader for the scoped country with a lookup key country
activate_saved_leader Moves a saved leader to the active for the scoped country with a lookup key country
add_relic Adds the specified relic to the scoped country. add_relic = <relic_key>
remove_relic Removes the specified relic from the scoped country. remove_relic = <relic_key>
delete_megastructure Deletes the target mega structure (no death graphics) all
add_random_research_option Adds s random tech research option to the scoped country's tech view list, permanent until researched. if none applicable it runs fail_effects country
add_asteroid_belt Adds an asteroid belt at the distance in the scope. galactic_object
set_asteroid_belt Sets an asteroid belt at the distance in the scope. galactic_object
fleet_action_research_special_project Sends a fleet to research a special project fleet
remove_last_built_district Removes last built district from the scoped planet planet
remove_all_districts Removes all districts from the scoped planet planet
remove_district Removes a specific district from the scoped planet planet
add_district Begins construction of a specific district on the scoped planet planet
enable_on_market Enables a resource on the Galactic Market all
enable_galactic_market Enables the galactic market. enable_galactic_market = <yes/no>
add_timed_trait Adds a specific trait to the scoped leader for a specific duration leader
create_archaeological_site Creates a archaeological site associated with the scope object megastructure planet ship fleet galactic_object ambient_object starbase
destroy_archaeological_site Destroys a archaeological site in right hand site event target all
add_stage_clues Adds clues to the current stage of a archaeological site archaeological_site
add_expedition_log_entry Adds clues to the current stage of a archaeological site archaeological_site
reset_current_stage Resets the current stage archaeological_site
finish_current_stage Finish the current stage archaeological_site
finish_site Finish the whole archaeological site archaeological_site
set_site_progress_locked Locks or unlocks the progress of a site archaeological_site
custom_tooltip_with_params Displays a specific localization string with parameters in tooltip all
set_federation_law Sets the given law for the scoped federation federation
add_to_galactic_community Tries to add the scoped country to the Galactic Community country
remove_from_galactic_community Tries to remove the scoped country from the Galactic Community country
add_to_galactic_council Tries to add the scoped country to the Galactic Council country
remove_from_galactic_council Tries to remove the scoped country from the Galactic Council country
steal_relic Steal all/a random/a specific relic from a target country country
country_list_tooltip Prints a list of the countries that match the limit triggers in a tooltip, each separated by a line break. all
owned_planet_list_tooltip Prints a list of the country's planets that match the limit triggers in a tooltip, each separated by a line break. country
owned_pop_faction_list_tooltip Prints a list of the country's pop factions that match the limit triggers in a tooltip, each separated by a line break. country
owned_leader_list_tooltip Prints a list of the country's leaders that match the limit triggers in a tooltip, each separated by a line break. country
owned_fleet_list_tooltip Prints a list of the country's fleets that match the limit triggers in a tooltip, each separated by a line break. country
set_cooldown Locks the leader in its current role for the next X days. leader
add_federation_experience Adds experience to the scoped federation federation
set_federation_type Sets federation type to the scoped federation federation
set_federation_succession_type Sets federation succession type to the scoped federation federation
set_federation_succession_term Sets federation succession term to the scoped federation federation
set_only_leader_builds_fleets Sets exclusive right to build fleets by federation leader federation
set_allow_subjects_to_join Sets right for subjects to join federations federation
set_equal_voting_power Sets different voting weight federation
set_diplomacy_action_setting Sets diplomatic action custom setting federation
set_free_migration Sets unified migration flag for federation federation
set_federation_settings Sets diplomatic action custom setting federation
add_cohesion Add cohesion to the federation federation
set_council_size Sets the number of seats on the Galactic Council all
increase_council_size Increases the number of seats on the Galactic Council by 1 all
decrease_council_size Decreases the number of seats on the Galactic Council by 1 all
set_council_veto Sets whether council members can veto resolutions or not all
set_council_emergency_measures Sets whether council members can propose emergency measures or not all
add_permanent_councillor Gives provided country a permanent position on the Galactic Council country
remove_permanent_councillor Remove the provided country from their permanent council position country
set_sector_capital Sets the scoped planet to be the capital of the sector it is part of. If used in the capital sector, it will shift the empire capital. Warning: Experimental, may have unintended consequences. planet
set_sector_focus Sets the sector's focus sector
set_colony_type Sets the colony's designation type planet
complete_special_project Completes a specific special project for the country, firing the on complete effects country
validate_planet_buildings_and_districts Checks whether the planets and districts on the planet are valid (their potential triggers are fulfilled), removes or replaces them if not. planet
country_event Fires a country event for the scoped country, with optional DAYS and RANDOM delay country
planet_event Fires a planet event for the scoped planet, with optional DAYS and RANDOM delay planet
random All enclosed effects may or may not be executed depending on set chance all
create_ship_design Creates a new ship design for use with last_created_design target all
change_government Change the scoped country's government authority and/or civics country
ship_event Fires a ship event for the scoped ship, with optional DAYS and RANDOM delay ship
pop_event Fires a pop event for the scoped pop, with optional DAYS and RANDOM delay pop
enable_special_project Enables a specific special research project for target country at a specific location (should be same as the current scope where possible) all
add_resource Adds specific resource to the stockpile for the country scope: country
fleet_event Fires a fleet event for the scoped fleet, with optional DAYS and RANDOM delay fleet
random_planet_within_border Executes enclosed effects on a random planet within the scoped country's borders that meets the limit criteria country
pop_remove_ethic Removes a specific ethic from the scoped pop pop
create_rebels Creates a rebellion planet
cancel_terraformation Cancels terraformation of the scoped planet planet
set_primitive_age Sets a 'primitive age' for the scoped (primitive, pre-FTL) country country
while Repeats enclosed effects while limit criteria are met or until set iteration count is reached all
clear_blocker Clears scoped deposit blocker and fires its on_cleared effect deposit
every_system_in_cluster Executes enclosed effects on every system in the cluster that meet the limit criteria all
create_cluster Creates a cluster centered around the specified spatial object
remove_army Removes the scoped army army
prevent_anomaly Disables or enables anomaly generation for the scoped planet planet
observation_outpost Executes enclosed effects on every observation post in the game that meets the limit criteria planet country
add_deposit Adds resource deposit to the scoped planet planet
clear_deposits Removes all deposits from the scoped planet planet
set_country_type Changes the country type of the scoped country country
set_age Sets the age of the scoped leader leader
conquer Conquers the planet by setting its owner to target country and adding an unhappiness modifier planet
pop_faction_event Fires a pop faction event for the scoped pop faction, with optional DAYS and RANDOM delay pop_faction
set_pop_faction_flag Sets an arbitrarily-named flag on the scoped pop's faction/pop faction pop pop_faction
remove_pop_faction_flag Removes a flag from the scoped pop's faction/pop faction pop pop_faction
set_timed_pop_faction_flag Sets an arbitrarily-named flag on the scoped pop faction for a set duration pop pop_faction
add_tech_progress Gives percentage progress (0.0-1.0) in a specific tech to the scoped country country
abort_special_project Aborts a specific special project for the country, removing it from the situation log country
every_pop_faction Iterate through all the country's pop factions country
random_pop_faction Iterate through all the country's pop factions country
observer_event Fires an observer event for all observers.
set_custom_capital_location Sets a custom spatial object as custom country capital location.
spawn_planet Spawns a planet in a system.
spawn_megastructure Spawns a mega structure in a system.
remove_megastructure Removes a mega structure. all
trigger_megastructure_icon if a planet has trigger_megastructure_icon = yes then the map icon for the star will show a megastructure icon
run_ai_strategic_data Recomputes ALL strategic data for AI = yes
add_static_war_exhaustion Adds static war exhaustion, scaled with value_for_planet_destruction, to owner of the battle location country
set_planet_size Sets the planet size to a specified number planet
run_ai_strategic_war_data Recomputes strategic war ( attack / defense ) data for AI = yes
expire_site_event Manually flags an archaeological event as expired archaeological_site
pass_resolution Immediately passes the given resolution. NOTE: Does not support targeted resolutions! country
every_system_planet Executes enclosed effects on every planet within the scoped system that meets the limit criteria galactic_object
surveyed Sets the planet as un/surveyed by target country planet
join_alliance Join federation with target country
complete_tutorial_step Create and sends an telemetry event keeping track of the tutorial steps for the current game
create_leader Creates a new leader for the scoped country country
set_disabled Enables or disables the scoped ship ship
else Executes enclosed effects if limit criteria of preceding 'if' or 'else_if' is not met all
log Prints a message to game.log for debugging purposes.
debug_break Trigger an assertion to stop the debugger when encountering this effect; argument is ignored all
inverted_switch Executes the first appropriate effect set for a specific trigger treated as NOT. all
random_owned_army Iterate through each army that is owned by the country country
every_owned_army Iterate through each army that is owned by the country country
random_planet_army Iterate through each defending army on a planet planet
every_planet_army Iterate through each defending army on a planet planet
random_relation Iterate through all relations country
every_relation Iterate through all relations country
random_neighbor_country Iterate through all neighbor countries country
every_neighbor_country Iterate through all neighbor countries country
random_bordering_country Iterate through all bordering countries of a system galactic_object
every_bordering_country Iterate through all bordering countries of a system galactic_object
random_rival_country Iterate through all countries rivalled by the scoped country country
every_rival_country Iterate through all countries rivalled by the scoped country country
random_federation_ally Iterate through all countries in a federation with the scoped country country
every_federation_ally Iterate through all countries in a federation with the scoped country country
random_federation Iterate through each federation all
every_federation Iterate through each federation all
random_combatant_fleet Iterate through each fleet this fleet is in combat with fleet
every_combatant_fleet Iterate through each fleet this fleet is in combat with fleet
random_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure megastructure planet starbase
every_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure megastructure planet starbase
random_recruited_leader Iterate through each leader that is owned by the country country
every_recruited_leader Iterate through each leader that is owned by the country country
random_pool_leader Iterate through each leader that is recruitable for the country country
every_pool_leader Iterate through each leader that is recruitable for the country country
random_envoy Iterate through each envoy available to the country country
every_envoy Iterate through each envoy available to the country country
random_megastructure Iterate through each megastructure all
every_megastructure Iterate through each megastructure all
random_owned_megastructure Iterate through each owned megastructure country
every_owned_megastructure Iterate through each owned megastructure country
random_system_megastructure Iterate through each megastructure in system all
every_system_megastructure Iterate through each megastructure in system all
random_owned_pop_species Iterate through each species of a country's owned pops country
every_owned_pop_species Iterate through each species of a country's owned pops country
random_galaxy_species Check if any species in the galaxy meet the specified criteria all
every_galaxy_species Check if any species in the galaxy meet the specified criteria all
random_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria planet country
every_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria planet country
random_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria planet country
every_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria planet country
random_owned_starbase Iterate through every owned starbase country
every_owned_starbase Iterate through every owned starbase country
random_system Iterate through all systems all
every_system Iterate through all systems all
random_system_within_border Iterate through all systems within the country's borders country
every_system_within_border Iterate through all systems within the country's borders country
random_war_participant Iterate through all war participants war
random_war Iterate through all wars the country is engaged in country
every_war Iterate through all wars the country is engaged in country
random_sector Iterate through all sectors all
every_sector Iterate through all sectors all
random_owned_sector Iterate through every owned sector country
every_owned_sector Iterate through every owned sector country
random_member Iterate through each member of the federation federation
every_member Iterate through each member of the federation federation

For comparing old lists of Stellaris triggers, modifiers and effects for most game versions since launch, you can use the GitHub file history feature here (created by OldEnt).

References[edit]


Empire EmpireEthicsGovernments • Civics • OriginsMandatesAgendasTraditions • Ascension PerksEdictsPoliciesRelicsTechnologiesCustom Empires
Pops JobsFactions
Leaders LeadersLeader Traits
Species SpeciesSpecies Traits
Planets PlanetsPlanetary Feature • Orbital DepositBuildings • DistrictsPlanetary Decisions
Systems SystemsStarbasesMegastructuresBypassesMap
Fleets FleetsShips • Components
Land Warfare ArmiesBombardment Stance
Diplomacy Diplomacy • Federations • Galactic CommunityOpinion ModifiersCasus Belli • War Goals
Events EventsAnomaliesSpecial projectsArchaeological Sites
Gameplay GameplayDefinesResources • Economy
Dynamic modding Dynamic moddingEffectsConditionsScopesModifiersVariablesAI
Media/localisation Maya exporterGraphicsPortraitsFlagsEvent picturesInterfaceIconsMusicLocalisation
Other Console commandsSave-game editingSteam Workshop