Scopes

本頁面部分全部內容上次核對於3.0版本


Introduction[編輯 | 編輯原始碼]

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[編輯 | 編輯原始碼]

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[編輯 | 編輯原始碼]

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[編輯 | 編輯原始碼]

Oftentimes 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 scope, use exists = [scope]. If it doesn't exist, the following code won't run.
planet = { exists = owner owner = { … } }

Triggers and scopes[編輯 | 編輯原始碼]

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[編輯 | 編輯原始碼]

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[編輯 | 編輯原始碼]

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 } }

Event targets are used in localization by referencing directly the variable name:

"I have decided to release my vassal [target_leader.GetFullName]"

Or can be used in tooltips of the event in which they are saved (which is normally not possible, as tooltips are built before effects are executed).

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[編輯 | 編輯原始碼]

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, branch_office_owner 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 solar_system An object (solar system) 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, star 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[編輯 | 編輯原始碼]

Current scopes can be found in an scopes.log file in your local data folder's script_documentation (defaults to "%USERPROFILE%\Documents\Paradox Interactive\Stellaris\logs\script_documentation\")

Scope name Scope type Can be scoped from
xxx = { owner = {…} }[1]
Can scope to
owner = { xxx = {…} }
Description
owner country fleet, ship, planet, pop, leader, army, megastructure, sector, starbase capital_scope, ruler, species, owner_species Scopes to the country that owns the object
controller country fleet, ship, planet, pop, leader, army, megastructure, sector, starbase capital_scope, ruler, species, owner_species Scopes to the country that currently occupies the object
space_owner country galactic_object capital_scope, ruler, species, owner_species Scopes to the country that currently owns the galactic_object
last_created_country country any capital_scope, ruler, species, owner_species Scopes to the last created country. Usually used after a create_country effect.
sector sector planet leader, owner, leader A sector in a country
solar_system galactic_object planet, star, ship, leader star, starbase, owner, space_owner A solar system
last_created_system galactic_object any star, starbase, owner, space_owner The last created solar system. Usually used after a spawn_system effect.
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.
star planet galactic_object solar_system, starbase, owner, space_owner The star of the solar system. May consist of multiple planet-scope stars, though one is always considered the main star.
planet planet pop, deposit, leader, army, archeaological_site, planet (moon) solar_system, owner, planet_owner, space_owner, controller A planet, star, or habitable structure.
capital_scope planet country solar_system, owner, space_owner, controller The capital planet of the country.
home_planet planet leader, pop, species, country solar_system, owner, space_owner, controller The home planet of a species/country.
orbit planet fleet, ship, planet solar_system, owner, space_owner, controller The planet-type object a fleet, ship, or moon is orbiting.
deposit deposit planet A planetary feature, including blockers and space deposits.
archeaological_site archeaological_site planet planet, leader, (excavator_fleet) An archeaological_site on a planet.
army army ship (country, planet) ship, fleet, leader, owner, planet, pop, species A defensive or offensive army.
last_created_army army any fleet, leader, owner, planet, pop, species The last created army, usually used with the create_army effect.
pop pop leader, army (planet, country, pop_faction, sector, species) owner, planet, home_planet, species A pop
last_created_pop pop any country, planet, species The last created pop, usually used with the create_pop effect.
species species pop, leader, army, country, (planet) home_planet – (pop) A specific pop species or subspecies
owner_species species country home_planet – (pop) The main species of a country. Usually the founder species, unless changed with change_dominant_species effect.
last_created_species species any home_planet – (pop) 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, ship, sector, army, archeaological_site fleet, species, owner, ruler, sector, solar_system, home_planet A leader in a country, including potential leaders in the pool.
ruler leader country species, owner, ruler, sector, solar_system, home_planet The leader that is the current ruler of a country,
last_created_leader leader any fleet, species, owner, ruler, sector, solar_system, home_planet The last created leader, usually used with the create_leader effect.
pop_faction pop_faction country A political faction in an empire.
ship ship – (fleet) fleet, orbit, leader, owner, space_owner
last_created_ship ship any fleet, orbit, leader, owner, space_owner The last created ship, usually used with the create_ship effect.
starbase ship planet (star), galactic_object fleet, orbit, leader, owner, space_owner An outpost or larger starbase that claims a system.
fleet fleet ship, army (country, galactic_object) orbit, leader, owner, space_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.
excavator_fleet fleet – (archaeological_site?) orbit, leader, owner A excavator fleet of an archaeological site.
design design (owner) A ship design.
last_created_design design any (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 – (country) – (attacker, defender) A declared war.

You can get the latest version in-game by using the trigger_docs console command.

Flat list of scopes[編輯 | 編輯原始碼]

Flat list of trigger scopes (v3.0.3)
Scope trigger Description From scope
text For 'desc={trigger={' use. Shows custom text all
not An inverted trigger all
if Evaluates the triggers if the display_triggers of the limit are met all
any_playable_country Iterate through all playable countries - checks whether the enclosed triggers return true for any of them 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 Finds the closest system within the given hyperlane steps and limit = { <triggers> }. If this system does not exist, it returns false. If it does exist, it is checked against the triggers outside of the limit = {}. all
any_owned_fleet Iterate through each fleet owned by the country - checks whether the enclosed triggers return true for any of them 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. Identical to empire_spraw trigger. country
empire_sprawl Checks the empire's sprawl. Identical to empire_size trigger. 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 pop, species or country's ideal planet class is a specific class country pop species
ethos Checks the average ethics divergence on the planet, i.e. num of pops not of the country's ethics / total num of pops planet
distance Checks the ship/fleet/planet/leader/pop/system's galaxy map distance to target in absolute units megastructure planet ship pop fleet galactic_object leader ambient_object starbase deposit archaeological_site first_contact
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 Iterate through each planet within the current empire's borders - checks whether the enclosed triggers return true for any of them country
any_owned_ship Iterate through each ship in the fleet or owned by the country - checks whether the enclosed triggers return true for any of them country fleet
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 ship
is_civilian Checks if the scoped fleet or ship is civilian (as set in ship sizes). ship fleet
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 Iterate through each moon of the planet - checks whether the enclosed triggers return true for any of them 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
intel Checks the country's Intel on the target country country
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 country 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 - checks whether the enclosed triggers return true for any of them country
any_defender Iterate through all defenders in the current war - checks whether the enclosed triggers return true for any of them war
any_attacker Iterate through all attackers in the current war - checks whether the enclosed triggers return true for any of them 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_in_log Checks if the country has completed a specific special project as part of an in-progress event chain country
has_failed_special_project_in_log 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 species country pop leader 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. planet
has_megastructure Checks if a country or star has a mega structure. country galactic_object
recently_lost_war Checks if the country recently lost a war ('recently' meaning recent enough to have a truce) 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. country
has_tributary Checks if the target country is a tributary of the current scope. country
upgrade_days_left Checks how many days an upgrading megastructure will take to complete its upgrade. 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 Iterate through each planet in the current system - checks whether the enclosed triggers return true for any of them 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
is_galactic_custodian Checks if an empire is Custodian of the Galactic Council country
has_galactic_custodian Checks if the Galactic Community has named a Custodian all
is_galactic_emperor Checks if an empire is the Galactic Emperor country
has_galactic_emperor Checks if the Galactic Emperor has taken over all
imperial_authority Checks imperial authority. all
has_stage_modifier Checks if the espionage operation has a certain modifier specific for the current stage espionage_operation
galactic_defense_force_exists Checks if the Galactic Defense Force or Imperial Armada exists all
has_intel_level Checks the country's intel level on a category for the target country country
has_intel_report Checks if the country has intel report of at least the specified level on a category for the target country country
has_intel Checks if the specified intel is available for the target country (stale intel will not return true) country
has_stale_intel Checks if the specified intel is stale for the target country (available intel will not return true) country
and all inside trigger must be true 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 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 is colonized (in planet scope) or the system has an owner (in system scope) planet galactic_object
free_housing Checks the planet's available housing planet
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 megastructure planet ship pop fleet galactic_object leader army pop_faction starbase deposit sector archaeological_site first_contact spy_network espionage_operation
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
can_research_technology Checks whether the current country is allowed to have the specified technology, i.e. does it fulfil the potential = { } field for that tech, and for any prereq techs that tech has. country
can_copy_random_tech_from Checks whether the target country has a technology the current country can steal via copy_random_tech_from effect country
can_set_policy Checks if the country is allowed to set its policy to a specific one using set_policy effect country
any_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure - checks whether the enclosed triggers return true for any of them 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_first_contact_flag Checks if the first contact site has a specific flag first_contact
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
is_capital_system Checks if the solar system has its owner's capital galactic_object
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 or sector's number of owned planets country sector
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/sector planet country pop_faction sector
num_unemployed Checks the number of unemployed pops on the planet planet
would_work_job Checks if the pop will work a specific job if a vacancy becomes available (i.e. does it meet the requirements, would it have a higher job weight?) pop
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 - checks whether the enclosed triggers return true for any of them all
any_pop Checks if any of the planet/species/pop faction pops meet the specified criteria. Warning: deprecated, use any_owned_pop/any_species_pop 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 ship pop leader army species
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
is_variable_set Checks if the specified variable is set on the current scope. Use to avoid unset variables errors megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
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 first_contact
check_variable_arithmetic Checks a variable for the scope if a certain amount of arithmetic is done to it (note: the variable's value is not changed by this trigger) megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
check_modifier_value Checks the value of a specified modifier in the current scope against a value. megastructure planet country ship pop fleet galactic_object leader army species design pop_faction spy_network espionage_operation
check_galaxy_setup_value Checks the value for a specific option from the galaxy setup all
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
has_active_building Checks if the planet has a specific building, and that that building is not disabled or ruined. 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
is_mobile Checks if the scoped fleet can move. fleet
is_in_sensor_range Checks if the specified ship, fleet, planet or system is within sensor range of the scoped country. country
is_in_sensor_range_of_country Checks if the scoped ship, fleet, planet or system is within sensor range of the specified country. planet ship fleet galactic_object
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 research 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
is_defensive_army Checks if the army is defensive army
has_army Checks if the planet has an army planet
is_advisor_active checks if a country has an advisor 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
is_idle Checks if scoped leader is idle leader
income Checks the country's monthly energy credit income country
expenses Checks the country's monthly energy credit expenses 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
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 ship
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
has_existing_ship_design Checks if the country has a specific ship design available 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 Iterate through each deposit on the planet - checks whether the enclosed triggers return true for any of them 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 galactic_object
any_rim_system Iterate through all rim systems - checks whether the enclosed triggers return true for any of them all
is_country_type Checks if the country is a specific type country
has_modifier Checks if the scope object has a certain modifier megastructure planet country ship pop galactic_object pop_faction federation spy_network espionage_operation
any_ship_in_system Iterate through each ship in the current system - checks whether the enclosed triggers return true for any of them 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, species or pop 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 Iterate through each leader that is owned by the country - checks whether the enclosed triggers return true for any of them country
any_owned_pop Iterate through all owned pops - checks whether the enclosed triggers return true for any of them planet country pop_faction sector
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. Warning: deprecated, use count_owned_pop 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
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
compare_distance Checks whether the current scope is closer to a specified object than it is to a second specified object within the same solar system. megastructure planet ship pop fleet galactic_object leader ambient_object starbase deposit archaeological_site first_contact
any_ambient_object Iterate through every ambient object in the game - checks whether the enclosed triggers return true for any of them all
any_system_ambient_object Iterate through every ambient object in the solar system - checks whether the enclosed triggers return true for any of them galactic_object
has_ambient_object_flag Checks if the ambient object has a specific flag ambient_object
is_ambient_object_type Checks if the ambient object is a specific type. ambient_object
any_bordering_country Iterate through all bordering countries of a system - checks whether the enclosed triggers return true for any of them 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 - checks whether the enclosed triggers return true for any of them 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 country 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 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 Iterate through all a system's neigboring systems by hyperlane - checks whether the enclosed triggers return true for any of them 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/fleet/ship is within the borders of the target country planet ship fleet 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_starbase_modules Checks the number of starbase modules that are of the specified type or not 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 current country is allowed by its overlord to take diplomatic action 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 all
num_rare_techs Checks the country's number of researched rare technologies country
num_repeatable_techs Checks the country's number of researched repeatable technologies country
has_mandate Checks if the leader has any, or a specific, mandate leader
nor An inverted OR trigger all
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 Iterate through all subjects of the scoped country - checks whether the enclosed triggers return true for any of them 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 the specified species is the majority species on the current planet. planet
has_closed_borders Check if the country has closed its borders to target country country
is_difficulty Checks the game's difficulty level (0 to 5, with 0 as Cadet and 5 as Grand Admiral 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 harm 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 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. Also returns true if the tradition is swapped but has inherit_effects = yes (i.e. it's a cosmetic flavor swap). 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
allowed_crisis_type Checks which crisis is allowed to spawn in the current game 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 scoped planet: planet
resource_income_compare Checks specific resource income value for the country scope: country
market_resource_price Checks market price of a specific resource for the current country: country
pop_percentage Checks the percentage of pops in the scope that fulfill the specified criteria planet country pop_faction sector
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. 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 megastructure fleet
relative_power Compares relative power between two countries. relative_power = { who = <target country> category = <fleet/economy/technology/all> value ><= <pathetic/inferior/equivalent/superior/overwhelming> country
any_relation Iterate through all relations - checks whether the enclosed triggers return true for any of them 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
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. 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
is_total_war Checks if a war is a total war 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 or sector's number of owned systems country sector
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
can_buy_on_market Checks if the current country can buy the specified resource on the market or galactic market country
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 all
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 first_contact
is_current_stage_difficulty Compares the current stage difficulty. archaeological_site first_contact
is_site_at_stage Compares the current stage index. archaeological_site
is_current_stage_clues Compares the current stage clues. archaeological_site first_contact
is_site_days_to_next_die_roll Compares days to next die roll. archaeological_site first_contact
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 the site has been completed. archaeological_site first_contact
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 first_contact
is_site_current_stage_score_no_die Compares the current stage discovery score excluding the current die roll. archaeological_site first_contact
is_current_excavator_fleet Checks current excavator fleet. archaeological_site
is_artificial Checks if the planet is artificial (as set in planet_classes) planet
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
num_members Checks number of members in scoped federation federation
num_associates Checks number of associates in scoped federation federation
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 - checks whether the enclosed triggers return true for any of them planet country
any_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria - checks whether the enclosed triggers return true for any of them planet country
num_ai_empires_setting Checks the number of AI empires defined in setup all
num_defensive_pacts Checks the number of defensive pacts the current country has. country
num_support_independence Checks the number of empires the current country is supporting the independence of. country
num_guarantees Checks the number of empires the current country is guaranteeing. country
num_non_aggression_pacts Checks the number of non-aggression pacts the current country has. country
num_commercial_pacts Checks the number of commercial pacts the current country has. country
num_research_agreements Checks the number of research agreements a country has country
num_migration_pacts Checks the number of migration pacts a country has country
num_rivals Checks the number of rivalries a country has country
num_closed_borders Checks the number of countries the country has closed borders to country
num_truces Checks the number of truces country has country
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
num_assigned_jobs Checks the number of pops the planet or country has that work a specific job. planet country
has_active_first_contact_with Checks if the scoped country has an active First Contact site with the target country country
can_have_first_contact_site_with Checks if the scoped country is allowed to have a First Contact site with the target country country
is_current_first_contact_stage Checks if the scoped first contact is at the specified stage. first_contact
has_spynetwork Checks if scoped country has any spynetworks with a value > 0 country
has_espionage_asset Checks if the scope hold an asset of specified type spy_network espionage_operation
has_espionage_operation_flag Checks if the espionage operation has a specific flag espionage_operation
has_menace_perk Checks if a country has a specific Menace Perk unlocked. country
num_organic_pops_per_year Checks how many organic pops the planet expects to gain in a year on average (through growth and assembly) at the current rate. planet
num_artificial_pops_per_year Checks how many artificial pops the planet expects to assemble in a year on average at the current rate. planet
has_spy_power Compares the spy power of the network spy_network
has_available_spy_power Compares the available spy power of the network spy_network
has_espionage_category Checks if the scope is of a specific category espionage_operation
is_running_espionage_operation Checks if the scope is currently running an espionage operation country spy_network
has_espionage_type Checks if the scope is of a specific type espionage_operation
relative_encryption_decryption Divides the encryption value of the scope object with the decryption value of the target and compares with value. country spy_network espionage_operation
is_espionage_operation_days_to_next_die_roll Compares days to next die roll. espionage_operation
is_espionage_operation_chapter Compares the current espionage operation chapter index. espionage_operation
is_espionage_operation_difficulty Compares the espionage operation difficulty. espionage_operation
is_espionage_operation_score_no_die Compares the current espionage score excluding the current die roll. espionage_operation
is_espionage_operation_score Compares the current espionage score. espionage_operation
is_espionage_operation_last_die_result Compares the last dice roll. espionage_operation
num_espionage_assets Compares the number of assets associated with the scope object. spy_network espionage_operation
has_ship_owner_type Checks if the ship/fleet/design has a specific owner type (country/federation/galactic_community/global_ship_design) ship fleet design
has_crisis_level Checks if a country has a specific Crisis Level unlocked. country
has_spynetwork_value Compares spy network value of the scoped object spy_network
is_spynetwork_level Compares spy network level of the scoped object spy_network
is_counter_espionage Compares counter espionage of the scoped object country
has_embassy Check if the country has an embassy with the target country country
is_spynetwork_max_level Compares spy network max level of the scoped object spy_network
has_job_category Checks if the pop is currently working this strata job (worker, specialist, complex_drone, etc.) Returns false if unemployed. pop
count_ambient_object Iterate through every ambient object in the game - checks whether the enclosed triggers return true for X/all of them all
count_system_ambient_object Iterate through every ambient object in the solar system - checks whether the enclosed triggers return true for X/all of them galactic_object
any_owned_army Iterate through each army that is owned by the country - checks whether the enclosed triggers return true for any of them country
count_owned_army Iterate through each army that is owned by the country - checks whether the enclosed triggers return true for X/all of them country
any_planet_army Iterate through each army on the planet (not in ground combat) belonging to the planet owner - checks whether the enclosed triggers return true for any of them planet
count_planet_army Iterate through each army on the planet (not in ground combat) belonging to the planet owner - checks whether the enclosed triggers return true for X/all of them planet
any_ground_combat_defender Iterate through each army currently defending the planet in ground combat - checks whether the enclosed triggers return true for any of them planet
count_ground_combat_defender Iterate through each army currently defending the planet in ground combat - checks whether the enclosed triggers return true for X/all of them planet
any_ground_combat_attacker Iterate through each army currently attacking the planet in ground combat - checks whether the enclosed triggers return true for any of them planet
count_ground_combat_attacker Iterate through each army currently attacking the planet in ground combat - checks whether the enclosed triggers return true for X/all of them planet
count_country Iterate through all countries - checks whether the enclosed triggers return true for X/all of them all
count_relation Iterate through all relations - checks whether the enclosed triggers return true for X/all of them country
any_neighbor_country Iterate through all neighbor countries - checks whether the enclosed triggers return true for any of them country
count_neighbor_country Iterate through all neighbor countries - checks whether the enclosed triggers return true for X/all of them country
count_bordering_country Iterate through all bordering countries of a system - checks whether the enclosed triggers return true for X/all of them galactic_object
any_rival_country Iterate through all countries rivalled by the scoped country - checks whether the enclosed triggers return true for any of them country
count_rival_country Iterate through all countries rivalled by the scoped country - checks whether the enclosed triggers return true for X/all of them country
any_federation_ally Iterate through all countries in a federation with the scoped country - checks whether the enclosed triggers return true for any of them country
count_federation_ally Iterate through all countries in a federation with the scoped country - checks whether the enclosed triggers return true for X/all of them country
count_playable_country Iterate through all playable countries - checks whether the enclosed triggers return true for X/all of them all
count_subject Iterate through all subjects of the scoped country - checks whether the enclosed triggers return true for X/all of them country
any_spynetwork Iterate through each spynetwork - checks whether the enclosed triggers return true for any of them country no_scope
count_spynetwork Iterate through each spynetwork - checks whether the enclosed triggers return true for X/all of them country no_scope
any_espionage_operation Iterate through each espionage operation - checks whether the enclosed triggers return true for any of them country no_scope spy_network
count_espionage_operation Iterate through each espionage operation - checks whether the enclosed triggers return true for X/all of them country no_scope spy_network
any_espionage_asset Iterate through each espionage asset - checks whether the enclosed triggers return true for any of them no_scope spy_network espionage_operation
count_espionage_asset Iterate through each espionage asset - checks whether the enclosed triggers return true for X/all of them no_scope spy_network espionage_operation
any_federation Iterate through each federation - checks whether the enclosed triggers return true for any of them all
count_federation Iterate through each federation - checks whether the enclosed triggers return true for X/all of them all
any_first_contact Iterate through each first contact (both active and complete) that this country is engaging in - checks whether the enclosed triggers return true for any of them country
count_first_contact Iterate through each first contact (both active and complete) that this country is engaging in - checks whether the enclosed triggers return true for X/all of them country
any_active_first_contact Iterate through each active (non-completed) first contact that this country is engaging in - checks whether the enclosed triggers return true for any of them country
count_active_first_contact Iterate through each active (non-completed) first contact that this country is engaging in - checks whether the enclosed triggers return true for X/all of them country
any_galaxy_fleet Iterate through each fleet in the entire game - checks whether the enclosed triggers return true for any of them all
count_galaxy_fleet Iterate through each fleet in the entire game - checks whether the enclosed triggers return true for X/all of them all
any_combatant_fleet Iterate through each fleet this fleet is in combat with - checks whether the enclosed triggers return true for any of them fleet
count_combatant_fleet Iterate through each fleet this fleet is in combat with - checks whether the enclosed triggers return true for X/all of them fleet
any_fleet_in_system Iterate through each fleet in the current system - checks whether the enclosed triggers return true for any of them galactic_object
count_fleet_in_system Iterate through each fleet in the current system - checks whether the enclosed triggers return true for X/all of them galactic_object
count_owned_fleet Iterate through each fleet owned by the country - checks whether the enclosed triggers return true for X/all of them country
count_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure - checks whether the enclosed triggers return true for X/all of them megastructure planet starbase
count_owned_leader Iterate through each leader that is owned by the country - checks whether the enclosed triggers return true for X/all of them country
any_pool_leader Iterate through each leader that is recruitable for the country - checks whether the enclosed triggers return true for any of them country
count_pool_leader Iterate through each leader that is recruitable for the country - checks whether the enclosed triggers return true for X/all of them country
any_envoy Iterate through each envoy available to the country - checks whether the enclosed triggers return true for any of them country
count_envoy Iterate through each envoy available to the country - checks whether the enclosed triggers return true for X/all of them country
any_megastructure Iterate through each megastructure - checks whether the enclosed triggers return true for any of them all
count_megastructure Iterate through each megastructure - checks whether the enclosed triggers return true for X/all of them all
any_owned_megastructure Iterate through each owned megastructure - checks whether the enclosed triggers return true for any of them country
count_owned_megastructure Iterate through each owned megastructure - checks whether the enclosed triggers return true for X/all of them country
any_system_megastructure Iterate through each megastructure in system - checks whether the enclosed triggers return true for any of them all
count_system_megastructure Iterate through each megastructure in system - checks whether the enclosed triggers return true for X/all of them all
count_member Iterate through each member of the federation - checks whether the enclosed triggers return true for X/all of them federation
any_associate Iterate through each associate member of the federation - checks whether the enclosed triggers return true for any of them federation
count_associate Iterate through each associate member of the federation - checks whether the enclosed triggers return true for X/all of them federation
count_system_planet Iterate through each planet in the current system - checks whether the enclosed triggers return true for X/all of them galactic_object
count_planet_within_border Iterate through each planet within the current empire's borders - checks whether the enclosed triggers return true for X/all of them country
any_owned_planet Iterate through each inhabited planet owned by the current empire - checks whether the enclosed triggers return true for any of them country sector
count_owned_planet Iterate through each inhabited planet owned by the current empire - checks whether the enclosed triggers return true for X/all of them country sector
any_controlled_planet Iterate through each inhabited planet controlled by the current empire - checks whether the enclosed triggers return true for any of them country
count_controlled_planet Iterate through each inhabited planet controlled by the current empire - checks whether the enclosed triggers return true for X/all of them country
any_galaxy_planet Iterate through each planet ANYWHERE in the game; warning: resource intensive! - checks whether the enclosed triggers return true for any of them all
count_galaxy_planet Iterate through each planet ANYWHERE in the game; warning: resource intensive! - checks whether the enclosed triggers return true for X/all of them all
count_deposit Iterate through each deposit on the planet - checks whether the enclosed triggers return true for X/all of them planet
count_moon Iterate through each moon of the planet - checks whether the enclosed triggers return true for X/all of them planet
count_owned_pop Iterate through all owned pops - checks whether the enclosed triggers return true for X/all of them planet country pop_faction sector
any_species_pop Iterate through each pop that belongs to this species; warning: resource-intensive! - checks whether the enclosed triggers return true for any of them species
count_species_pop Iterate through each pop that belongs to this species; warning: resource-intensive! - checks whether the enclosed triggers return true for X/all of them species
any_pop_faction Iterate through all the country's pop factions - checks whether the enclosed triggers return true for any of them country
count_pop_faction Iterate through all the country's pop factions - checks whether the enclosed triggers return true for X/all of them country
any_galaxy_sector Iterate through all sectors in the game - checks whether the enclosed triggers return true for any of them all
count_galaxy_sector Iterate through all sectors in the game - checks whether the enclosed triggers return true for X/all of them all
any_owned_sector Iterate through every owned sector - checks whether the enclosed triggers return true for any of them country
count_owned_sector Iterate through every owned sector - checks whether the enclosed triggers return true for X/all of them country
count_owned_ship Iterate through each ship in the fleet or owned by the country - checks whether the enclosed triggers return true for X/all of them country fleet
count_ship_in_system Iterate through each ship in the current system - checks whether the enclosed triggers return true for X/all of them galactic_object
any_owned_pop_species Iterate through each species of a country's owned pops - checks whether the enclosed triggers return true for any of them country
count_owned_pop_species Iterate through each species of a country's owned pops - checks whether the enclosed triggers return true for X/all of them country
any_galaxy_species Check if any species in the galaxy meet the specified criteria - checks whether the enclosed triggers return true for any of them all
count_galaxy_species Check if any species in the galaxy meet the specified criteria - checks whether the enclosed triggers return true for X/all of them all
count_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria - checks whether the enclosed triggers return true for X/all of them planet country
count_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria - checks whether the enclosed triggers return true for X/all of them planet country
any_owned_starbase Iterate through every owned starbase - checks whether the enclosed triggers return true for any of them country
count_owned_starbase Iterate through every owned starbase - checks whether the enclosed triggers return true for X/all of them country
any_system Iterate through all systems - checks whether the enclosed triggers return true for any of them all
count_system Iterate through all systems - checks whether the enclosed triggers return true for X/all of them all
count_rim_system Iterate through all rim systems - checks whether the enclosed triggers return true for X/all of them all
any_system_within_border Iterate through all systems within the country's or sector's borders - checks whether the enclosed triggers return true for any of them country sector
count_system_within_border Iterate through all systems within the country's or sector's borders - checks whether the enclosed triggers return true for X/all of them country sector
count_neighbor_system Iterate through all a system's neigboring systems by hyperlane - checks whether the enclosed triggers return true for X/all of them galactic_object
any_neighbor_system_euclidean Iterate through all a system's neigboring systems (by closeness, not by hyperlanes) - checks whether the enclosed triggers return true for any of them galactic_object
count_neighbor_system_euclidean Iterate through all a system's neigboring systems (by closeness, not by hyperlanes) - checks whether the enclosed triggers return true for X/all of them galactic_object
any_war_participant Iterate through all war participants - checks whether the enclosed triggers return true for any of them war
count_war_participant Iterate through all war participants - checks whether the enclosed triggers return true for X/all of them war
count_attacker Iterate through all attackers in the current war - checks whether the enclosed triggers return true for X/all of them war
count_defender Iterate through all defenders in the current war - checks whether the enclosed triggers return true for X/all of them war
count_war Iterate through all wars the country is engaged in - checks whether the enclosed triggers return true for X/all of them country
Flat list of effect scopes (v3.0.3)
Scope effect Description From scope
tooltip Just a tooltip country
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
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 megastructure 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
clear_pop_category Resets category of a pop pop
add_random_non_blocker_deposit Adds random non-blocker resource deposit to the scoped planet planet
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_first_contact_flag Sets an arbitrarily-named flag on the scoped first contact site first_contact
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_first_contact_flag Removes a flag from the scoped first contact site first_contact
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 - executes the enclosed effects on all of them for which the limit triggers return true country fleet
random_owned_ship Iterate through each ship in the fleet or owned by the country - executes the enclosed effects on one of them for which the limit triggers return true 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
set_star_class Sets the star's star class, affecting system and galactic map graphics and potentially modifiers. Also changes the planet class of the system's primary star. galactic_object
random_country Iterate through all countries - executes the enclosed effects on one of them for which the limit triggers return true all
random_pop Executes enclosed effects on a random pop that meets the limit criteria. Warning: deprecated, use random_owned_pop 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 pop pop
remove_pop_flag Removes a flag from the scoped pop pop
every_owned_pop Iterate through all owned pops - executes the enclosed effects on all of them for which the limit triggers return true planet country pop_faction sector
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
set_adjective Sets the adjective of the scoped country country
set_ship_prefix Sets the ship prefix of the scoped country country
add_modifier Adds a specific modifier to the scoped object for a set duration megastructure planet country ship pop fleet galactic_object pop_faction federation spy_network espionage_operation
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
set_surveyed Sets the planet or system as un/surveyed by target country planet galactic_object
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 first_contact
clear_variable Clears a previously-set variable from the game. megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
round_variable Rounds a previously-set variable to the closest integer. megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
floor_variable Rounds a previously-set variable down to the previous integer. megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
ceiling_variable Rounds a previously-set variable up to the next integer. megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
export_modifier_to_variable Exports the value of a specified modifier in the current scope to a specified variable. megastructure planet country ship pop fleet galactic_object leader army species pop_faction
export_trigger_value_to_variable Exports the value of a specified simple value trigger (i.e. no { }, returns a number on the right hand side) to a specified variable. megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
export_resource_stockpile_to_variable Exports the value of the current country's stockpile of the specified resource to a variable. country
export_resource_income_to_variable Exports the value of the current country's monthly income of the specified resource to a variable. country
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 first_contact
every_galaxy_pop Executes enclosed effects for every pop in the game that meet the limit criteria all
every_country Iterate through all countries - executes the enclosed effects on all of them for which the limit triggers return true all
every_playable_country Iterate through all playable countries - executes the enclosed effects on all of them for which the limit triggers return true all
random_playable_country Iterate through all playable countries - executes the enclosed effects on one of them for which the limit triggers return true 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
destroy_and_spawn_debris_for Sets the current ship or fleet to be destroyed and spawn a debris project for the specified country. ship fleet
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_hostile Sets the target country as hostile. This will work on countries you don't have comms with, unlike set_faction_hostility. 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> 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 Iterate through each deposit on the planet - executes the enclosed effects on all of them for which the limit triggers return true planet
random_deposit Iterate through each deposit on the planet - executes the enclosed effects on one of them for which the limit triggers return true planet
set_policy_cooldown Sets the specified policy group to have a cooldown as if the policy had just been changed. planet country ship pop
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 Iterate through each moon of the planet - executes the enclosed effects on one of them for which the limit triggers return true planet
every_moon Iterate through each moon of the planet - executes the enclosed effects on all of them for which the limit triggers return true 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_first_contact_flag Sets an arbitrarily-named flag on the scoped first contact site for a set duration first_contact
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 Iterate through each planet within the current empire's borders - executes the enclosed effects on all of them for which the limit triggers return true country
every_rim_system Iterate through all rim systems - executes the enclosed effects on all of them for which the limit triggers return true all
random_rim_system Iterate through all rim systems - executes the enclosed effects on one of them for which the limit triggers return true all
remove_modifier Removes a specific modifier from the scope object megastructure planet country ship pop fleet galactic_object pop_faction federation spy_network espionage_operation
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 Iterate through each leader that is owned by the country - executes the enclosed effects on all of them for which the limit triggers return true country
random_owned_leader Iterate through each leader that is owned by the country - executes the enclosed effects on one of them for which the limit triggers return true 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 - executes the enclosed effects on one of them for which the limit triggers return true planet country pop_faction sector
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 - executes the enclosed effects on one of them for which the limit triggers return true country
random_ambient_object Iterate through every ambient object in the game - executes the enclosed effects on one of them for which the limit triggers return true all
random_system_ambient_object Iterate through every ambient object in the solar system - executes the enclosed effects on one of them for which the limit triggers return true galactic_object
every_ambient_object Iterate through every ambient object in the game - executes the enclosed effects on all of them for which the limit triggers return true all
every_system_ambient_object Iterate through every ambient object in the solar system - executes the enclosed effects on all of them for which the limit triggers return true 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 - executes the enclosed effects on all of them for which the limit triggers return true galactic_object
random_fleet_in_system Iterate through each fleet in the current system - executes the enclosed effects on one of them for which the limit triggers return true 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 Iterate through all a system's neigboring systems by hyperlane - executes the enclosed effects on all of them for which the limit triggers return true galactic_object
random_neighbor_system Iterate through all a system's neigboring systems by hyperlane - executes the enclosed effects on one of them for which the limit triggers return true galactic_object
set_federation_leader Sets a country to lead a federation country 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 first_contact
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 first_contact
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 first_contact
modulo_variable Modulos a previously-set variable by a specific amount i.e. X % Y megastructure planet country ship pop fleet galactic_object leader army species pop_faction war federation starbase sector first_contact
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 government without checking the restrictions country
force_remove_civic Removes civic from a government without checking the restrictions country
set_origin Sets the country's origin to a certain value. Note: This will not run effects executed during galaxy generation. 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 fleet
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 type, 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 country
every_war_participant Iterate through all war participants - executes the enclosed effects on all of them for which the limit triggers return true war
repair_percentage Restores a certain percentage of hull points to the scoped ship ship fleet
endgame_telemetry Send endgame telemetry event 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. all
guarantee_country Makes a country guarantee another country country
every_owned_fleet Iterate through each fleet owned by the country - executes the enclosed effects on all of them for which the limit triggers return true country
every_subject Iterate through all subjects of the scoped country - executes the enclosed effects on all of them for which the limit triggers return true country
random_subject Iterate through all subjects of the scoped country - executes the enclosed effects on one of them for which the limit triggers return true country
set_species_homeworld Defines a homeworld for the current species. species
clear_resources Clears resources of a country 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> 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. species
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. country
set_empire_flag Sets the flag of the current Empire. country
set_planet_name Sets the name of the current planet. planet
set_fleet_formation Sets a custom fleet formation on a fleet. fleet
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. megastructure
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_colonization_controls Set colonization 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. species
rename_species rename_species = { species
reset_years_of_peace Resets years of peace for a country. 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". megastructure
activate_gateway Activates the gateway associated with a megastructure. all
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
remove_starbase_module Removes a module from a certain slot or all slots on a starbase starbase
remove_starbase_building Remove a building from a certain slot or all slots 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> country
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
copy_random_tech_from Adds a random tech from the target country within the given category and tech area constraints. The country must be able to research said tech (weight > 0, fulfils potential trigger) 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> 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 an archaeological or first contact site archaeological_site first_contact
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 first_contact
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
add_to_galactic_community_no_message Tries to add the scoped country to the Galactic Community without producing member joining notifications. 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_associate_member Add specified country as an associate member federation
remove_associate_member Removes a specific associate member from the federation 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
set_government_cooldown Locks the country's government for a given period of days, the default cooldown, or unlocks it. country
change_colony_foundation_date Changes the colony foundation date (affecting on_colony_X_years pulses) by a specific number of days. Use with care, you can probably break things with this! planet
log_error Prints a message to error.log for debugging purposes. country
fire_on_action Fires a made-up on_action. all
set_first_contact_stage Sets the given stage for the scoped first contact first_contact
finish_current_operation_stage Finish the current operation phase espionage_operation
set_mia Sets the current fleet to go missing in action and return home. fleet
create_espionage_asset Creates espionage asset within a given spy network spy_network
destroy_espionage_asset Destroys espionage asset within a given spy network/operation spy_network espionage_operation
set_espionage_operation_progress_locked Locks or unlocks the progress of an espionage operation espionage_operation
unassign_espionage_asset Unassignes espionage asset from the scope operation to owning spy network espionage_operation
assign_espionage_asset Assigns espionage asset to the scope operation from owning spy network espionage_operation
set_espionage_operation_flag Sets an arbitrarily-named flag on the scoped espionage operation espionage_operation
remove_espionage_operation_flag Removes a flag from the scoped espionage operation espionage_operation
complete_crisis_objective Gives the player the reward for the specified crisis objective country
espionage_operation_event Fires a espionage event event for the scoped object, with optional DAYS and RANDOM delay espionage_operation
join_war_on_side Joins the war on the specified side. country
remove_random_starbase_building Remove a number of random building(s) matching/not matching a type from the starbase starbase
remove_random_starbase_module Remove a number of random module(s) matching/not matching a type from the starbase starbase
set_timed_espionage_operation_flag Sets an arbitrarily-named flag on the scoped espionage operation for a set duration espionage_operation
destroy_espionage_operation Destroys a espionage operation site in right hand site event target all
add_espionage_information Adds information to the current stage of an espionage operation espionage_operation
add_victory_score Adds victory score to a country country
store_galactic_community_leader_backup_data Stores a copy of the specified data of the Galactic Custodian/Emperor. The values default to 'no'. all
restore_galactic_community_leader_backup_data Retores backed up data to the Galactic Custodian/Emperor all
activate_crisis_progression Activates crisis progression for the country country
room_name_override Sets the room background of the empire. Provide an empty string to remove the override. country
set_ai_personality Sets the AI personality of a country to a new one country
add_custodian_term_days Increase the current Custodian term time all
set_custodian_term_days Set the current Custodian term time. -1 will make the Custodianship permanent. all
pass_targeted_resolution Immediately passes the first found (oldest) proposed/voting for/failed resolution OR a new resolution of this type that has the specified target. Ignores whether the target is valid or not. country
set_update_modifiers_batch Disables modifier system to do full updates between Begin and End. all
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 Iterate through each planet within the current empire's borders - executes the enclosed effects on one of them for which the limit triggers return true 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 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 - executes the enclosed effects on all of them for which the limit triggers return true country
random_pop_faction Iterate through all the country's pop factions - executes the enclosed effects on one of them for which the limit triggers return true country
observer_event Fires an observer event for all observers. country
spawn_planet Spawns a planet in a system. galactic_object
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 country
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 archaeological_site
pass_resolution Immediately passes the first found (oldest) proposed/voting for/failed resolution OR a new resolution of this type. country
pass_resolution_no_cooldown Immediately passes the first found (oldest) proposed/voting for/failed resolution OR a new resolution of this type. Skips the cooldown on the relevant category. country
first_contact_event Fires a first contact event for the scoped first contact site, with optional DAYS and RANDOM delay first_contact
finish_first_contact Ends the First Contact first_contact
set_galactic_custodian Sets whether or not the scoped country is the Galactic Custodian country
set_galactic_emperor Sets whether or not the scoped country is the Galactic Emperor country
add_imperial_authority Add imperial_authority all
add_stage_modifier Adds a specific modifier to the current espionage operation stage for a set duration or until stage is changed espionage_operation
remove_stage_modifier Removes a specific modifier from the espionage operation current stage espionage_operation
add_intel_report Adds the intel level for the category selected. Default duration (0) is forever. country
set_galactic_defense_force Sets whether the Galactic Defense force or Imperial Armada exists all
clear_intel_report Removes all the intel reports related to the provided category. country
starbase_event Fires a starbase event for the scoped starbase starbase
system_event Fires a system event for the scoped system galactic_object
leader_event Fires a leader event for the scoped leader leader
transfer_galactic_defense_force_fleets Moves all owned GDF fleets to the target. country
cancel_resolution Immediately cancels/removes the latest active/passed/proposed/voting for/failed resolution of this type country
add_spy_network_level Adds levels to the current Spy Network spy_network
every_system_planet Iterate through each planet in the current system - executes the enclosed effects on all of them for which the limit triggers return true galactic_object
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 all
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. 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 - executes the enclosed effects on one of them for which the limit triggers return true country
every_owned_army Iterate through each army that is owned by the country - executes the enclosed effects on all of them for which the limit triggers return true country
random_planet_army Iterate through each army on the planet (not in ground combat) belonging to the planet owner - executes the enclosed effects on one of them for which the limit triggers return true planet
every_planet_army Iterate through each army on the planet (not in ground combat) belonging to the planet owner - executes the enclosed effects on all of them for which the limit triggers return true planet
random_ground_combat_defender Iterate through each army currently defending the planet in ground combat - executes the enclosed effects on one of them for which the limit triggers return true planet
every_ground_combat_defender Iterate through each army currently defending the planet in ground combat - executes the enclosed effects on all of them for which the limit triggers return true planet
random_ground_combat_attacker Iterate through each army currently attacking the planet in ground combat - executes the enclosed effects on one of them for which the limit triggers return true planet
every_ground_combat_attacker Iterate through each army currently attacking the planet in ground combat - executes the enclosed effects on all of them for which the limit triggers return true planet
random_relation Iterate through all relations - executes the enclosed effects on one of them for which the limit triggers return true country
every_relation Iterate through all relations - executes the enclosed effects on all of them for which the limit triggers return true country
random_neighbor_country Iterate through all neighbor countries - executes the enclosed effects on one of them for which the limit triggers return true country
every_neighbor_country Iterate through all neighbor countries - executes the enclosed effects on all of them for which the limit triggers return true country
random_bordering_country Iterate through all bordering countries of a system - executes the enclosed effects on one of them for which the limit triggers return true galactic_object
every_bordering_country Iterate through all bordering countries of a system - executes the enclosed effects on all of them for which the limit triggers return true galactic_object
random_rival_country Iterate through all countries rivalled by the scoped country - executes the enclosed effects on one of them for which the limit triggers return true country
every_rival_country Iterate through all countries rivalled by the scoped country - executes the enclosed effects on all of them for which the limit triggers return true country
random_federation_ally Iterate through all countries in a federation with the scoped country - executes the enclosed effects on one of them for which the limit triggers return true country
every_federation_ally Iterate through all countries in a federation with the scoped country - executes the enclosed effects on all of them for which the limit triggers return true country
random_spynetwork Iterate through each spynetwork - executes the enclosed effects on one of them for which the limit triggers return true country no_scope
every_spynetwork Iterate through each spynetwork - executes the enclosed effects on all of them for which the limit triggers return true country no_scope
random_espionage_operation Iterate through each espionage operation - executes the enclosed effects on one of them for which the limit triggers return true country no_scope spy_network
every_espionage_operation Iterate through each espionage operation - executes the enclosed effects on all of them for which the limit triggers return true country no_scope spy_network
random_espionage_asset Iterate through each espionage asset - executes the enclosed effects on one of them for which the limit triggers return true no_scope spy_network espionage_operation
every_espionage_asset Iterate through each espionage asset - executes the enclosed effects on all of them for which the limit triggers return true no_scope spy_network espionage_operation
random_federation Iterate through each federation - executes the enclosed effects on one of them for which the limit triggers return true all
every_federation Iterate through each federation - executes the enclosed effects on all of them for which the limit triggers return true all
random_first_contact Iterate through each first contact (both active and complete) that this country is engaging in - executes the enclosed effects on one of them for which the limit triggers return true country
every_first_contact Iterate through each first contact (both active and complete) that this country is engaging in - executes the enclosed effects on all of them for which the limit triggers return true country
random_active_first_contact Iterate through each active (non-completed) first contact that this country is engaging in - executes the enclosed effects on one of them for which the limit triggers return true country
every_active_first_contact Iterate through each active (non-completed) first contact that this country is engaging in - executes the enclosed effects on all of them for which the limit triggers return true country
random_galaxy_fleet Iterate through each fleet in the entire game - executes the enclosed effects on one of them for which the limit triggers return true all
every_galaxy_fleet Iterate through each fleet in the entire game - executes the enclosed effects on all of them for which the limit triggers return true all
random_combatant_fleet Iterate through each fleet this fleet is in combat with - executes the enclosed effects on one of them for which the limit triggers return true fleet
every_combatant_fleet Iterate through each fleet this fleet is in combat with - executes the enclosed effects on all of them for which the limit triggers return true fleet
random_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure - executes the enclosed effects on one of them for which the limit triggers return true megastructure planet starbase
every_fleet_in_orbit Iterate through each fleet orbiting the current planet/starbase/megastructure - executes the enclosed effects on all of them for which the limit triggers return true megastructure planet starbase
random_pool_leader Iterate through each leader that is recruitable for the country - executes the enclosed effects on one of them for which the limit triggers return true country
every_pool_leader Iterate through each leader that is recruitable for the country - executes the enclosed effects on all of them for which the limit triggers return true country
random_envoy Iterate through each envoy available to the country - executes the enclosed effects on one of them for which the limit triggers return true country
every_envoy Iterate through each envoy available to the country - executes the enclosed effects on all of them for which the limit triggers return true country
random_megastructure Iterate through each megastructure - executes the enclosed effects on one of them for which the limit triggers return true all
every_megastructure Iterate through each megastructure - executes the enclosed effects on all of them for which the limit triggers return true all
random_owned_megastructure Iterate through each owned megastructure - executes the enclosed effects on one of them for which the limit triggers return true country
every_owned_megastructure Iterate through each owned megastructure - executes the enclosed effects on all of them for which the limit triggers return true country
random_system_megastructure Iterate through each megastructure in system - executes the enclosed effects on one of them for which the limit triggers return true all
every_system_megastructure Iterate through each megastructure in system - executes the enclosed effects on all of them for which the limit triggers return true all
random_member Iterate through each member of the federation - executes the enclosed effects on one of them for which the limit triggers return true federation
every_member Iterate through each member of the federation - executes the enclosed effects on all of them for which the limit triggers return true federation
random_associate Iterate through each associate member of the federation - executes the enclosed effects on one of them for which the limit triggers return true federation
every_associate Iterate through each associate member of the federation - executes the enclosed effects on all of them for which the limit triggers return true federation
random_owned_planet Iterate through each inhabited planet owned by the current empire - executes the enclosed effects on one of them for which the limit triggers return true country sector
every_owned_planet Iterate through each inhabited planet owned by the current empire - executes the enclosed effects on all of them for which the limit triggers return true country sector
random_controlled_planet Iterate through each inhabited planet controlled by the current empire - executes the enclosed effects on one of them for which the limit triggers return true country
every_controlled_planet Iterate through each inhabited planet controlled by the current empire - executes the enclosed effects on all of them for which the limit triggers return true country
random_galaxy_planet Iterate through each planet ANYWHERE in the game; warning: resource intensive! - executes the enclosed effects on one of them for which the limit triggers return true all
every_galaxy_planet Iterate through each planet ANYWHERE in the game; warning: resource intensive! - executes the enclosed effects on all of them for which the limit triggers return true all
random_species_pop Iterate through each pop that belongs to this species; warning: resource-intensive! - executes the enclosed effects on one of them for which the limit triggers return true species
every_species_pop Iterate through each pop that belongs to this species; warning: resource-intensive! - executes the enclosed effects on all of them for which the limit triggers return true species
random_galaxy_sector Iterate through all sectors in the game - executes the enclosed effects on one of them for which the limit triggers return true all
every_galaxy_sector Iterate through all sectors in the game - executes the enclosed effects on all of them for which the limit triggers return true all
random_owned_sector Iterate through every owned sector - executes the enclosed effects on one of them for which the limit triggers return true country
every_owned_sector Iterate through every owned sector - executes the enclosed effects on all of them for which the limit triggers return true country
random_ship_in_system Iterate through each ship in the current system - executes the enclosed effects on one of them for which the limit triggers return true galactic_object
every_ship_in_system Iterate through each ship in the current system - executes the enclosed effects on all of them for which the limit triggers return true galactic_object
random_owned_pop_species Iterate through each species of a country's owned pops - executes the enclosed effects on one of them for which the limit triggers return true country
every_owned_pop_species Iterate through each species of a country's owned pops - executes the enclosed effects on all of them for which the limit triggers return true country
random_galaxy_species Check if any species in the galaxy meet the specified criteria - executes the enclosed effects on one of them for which the limit triggers return true all
every_galaxy_species Check if any species in the galaxy meet the specified criteria - executes the enclosed effects on all of them for which the limit triggers return true all
random_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria - executes the enclosed effects on one of them for which the limit triggers return true planet country
every_owned_species Check if any of the species <on the planet/in the country> meet the specified criteria - executes the enclosed effects on all of them for which the limit triggers return true planet country
random_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria - executes the enclosed effects on one of them for which the limit triggers return true planet country
every_enslaved_species Check if any of the species with enslaved pops <on the planet/in the country> meet the specified criteria - executes the enclosed effects on all of them for which the limit triggers return true planet country
random_owned_starbase Iterate through every owned starbase - executes the enclosed effects on one of them for which the limit triggers return true country
every_owned_starbase Iterate through every owned starbase - executes the enclosed effects on all of them for which the limit triggers return true country
random_system Iterate through all systems - executes the enclosed effects on one of them for which the limit triggers return true all
every_system Iterate through all systems - executes the enclosed effects on all of them for which the limit triggers return true all
random_system_within_border Iterate through all systems within the country's or sector's borders - executes the enclosed effects on one of them for which the limit triggers return true country sector
every_system_within_border Iterate through all systems within the country's or sector's borders - executes the enclosed effects on all of them for which the limit triggers return true country sector
random_neighbor_system_euclidean Iterate through all a system's neigboring systems (by closeness, not by hyperlanes) - executes the enclosed effects on one of them for which the limit triggers return true galactic_object
every_neighbor_system_euclidean Iterate through all a system's neigboring systems (by closeness, not by hyperlanes) - executes the enclosed effects on all of them for which the limit triggers return true galactic_object
random_war_participant Iterate through all war participants - executes the enclosed effects on one of them for which the limit triggers return true war
random_attacker Iterate through all attackers in the current war - executes the enclosed effects on one of them for which the limit triggers return true war
every_attacker Iterate through all attackers in the current war - executes the enclosed effects on all of them for which the limit triggers return true war
random_defender Iterate through all defenders in the current war - executes the enclosed effects on one of them for which the limit triggers return true war
every_defender Iterate through all defenders in the current war - executes the enclosed effects on all of them for which the limit triggers return true war
random_war Iterate through all wars the country is engaged in - executes the enclosed effects on one of them for which the limit triggers return true country
every_war Iterate through all wars the country is engaged in - executes the enclosed effects on all of them for which the limit triggers return true country

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[編輯 | 編輯原始碼]

  1. Each scope should match the respective object in the other column (from/to). Scopes in brackets are only indirect (per extra command).
帝國 帝國思潮政府 • 國民理念 • 起源承諾議程傳統 • 飛升天賦法令政策遺珍科技自定義帝國
人口 崗位派系
領袖 領袖領袖特質
物種 物種物種特質
行星 行星行星特徵 • 軌道礦藏建築 • 區劃行星決議
星系 星系恆星基地巨型結構蟲洞 • 星門地圖
艦隊 艦隊艦船 • 部件
地面戰 陸軍轟炸姿態
外交 外交 • 聯邦 • 星海共同體評價修正宣戰理由 • 戰爭目標
事件 事件異常現象特殊項目考古遺址
遊玩 遊玩定義研究 • 經濟遊戲開局
動態修改 動態指令效果觸發條件作用域修正變量AI
媒體/本地化 Maya 導出器圖形肖像旗幟事件圖片界面圖標音樂本地化
Other 控制台命令存檔編輯Steam 創意工坊模組製作教程