List of scopes

本页面讲述的内容长期有效

This is a full list of scopes for scripting event triggers, decision prerequisites, and limits.

Scopes are used to change what an event, decision, or limit is looking at. For example, if you have a provincial event, and wish to look at a population within that province, you use a scope.

Country Scope: Triggers

any_core

Syntax:

any_core = { triggers... }

Scope:
Switches scope to all core provinces of the current country in scope.

any_greater_power

Syntax:

any_greater_power = { triggers... }

Scope:
Switches scope to any country which is currently a greater power.

any_neighbor_country

Syntax:

any_neighbor_country = { triggers… }

Scope:
Any country neighboring the current country.

any_owned_province

Syntax:

any_owned_province = { triggers… }

Scope:
Any owned province.

any_pop

Syntax:

any_pop = { triggers… }

Scope:
Any pop in the current country.

capital_scope

Syntax:

capital_scope = { triggers… }

Scope:
Changes the current scope to the country’s capital (thus changing it to province scope).

[country tag]

Syntax:

[tag] = { triggers… }

Scope:
Changes the current scope to the specified country.

cultural_union

Syntax:

cultural_union = { effects… }

Scope:
Changes the current scope to the cultural union of the nation in the previous scope.

overlord

Syntax:

overlord = { triggers...}

Scope:
Changes the scope for a vassal to its overlord country.

[region name]

Syntax:

[region name] = { triggers… }

Scope:
Changes the current scope to the specified region (the ones listed in map\regions.txt).

sphere_owner

Syntax:

sphere_owner = { triggers... }

Scope:
Changes the current scope to the sphere owner of the country.

Province Scope: Triggers

any_core

Syntax:

any_core = { triggers... }

Scope:
Switches to the country scope of any cores inside the target province. So if the province has cores for Austria and Bohemia, then both those countries would now be in scope (whether they exist or not).

any_neighbor_province

Syntax:

any_neighbor_province = { triggers… }

Scope:
Any province neighboring the current province. Note that this does not include empty provinces.

any_pop

Syntax:

any_pop = { triggers… }

Scope:
Any pop in the current province.

controller

Syntax:

controller = { triggers … }

Scope:
Changes the current scope to the province controller.

owner

Syntax:

owner = { triggers … }

Scope:
Changes the current scope to the owner of the province.

state_scope

Syntax:

state_scope = { triggers … }

Scope:
Changes the current scope to the state which the province is in.

Pop Scope: Triggers

location

Syntax:

location = { triggers … }

Scope:
Changes the current scope to the province which the pop is in.

country

Syntax:

country = { effects… }

Scope:
Changes the current scope to the country this pop is part of.

cultural_union

Syntax:

cultural_union = { effects… }

Scope:
Changes the current scope to the cultural union of the nation in the previous scope.

Country Scope: Effects

all_core

Syntax:

all_core = { effects... }

Scope:
Changes the current scope to all provinces that are core to the current country (whether the country exists or not).

any_country

Syntax:

any_country = { effects… }

Scope:
Changes the current scope to all the currently available countries.

NOTE: This scope works differently in decisions and events. In decisions, it automatically refers to any existing countries (in fact, it cannot be used to target non-existing countries) and does not target the current country in scope. In events, it automatically refers to all country tags whether they currently exist or not (and would need a limit to specify otherwise), as well as the current country in scope.

any_greater_power

Syntax:

any_greater_power = { effects... }

Scope:
Changes the current scope to all countries which are currently greater powers.

NOTE: For the tooltip, this handily does not display the text of the scope and its conditions but rather lists every greater power individually which would be affected. So, rather than printing "Any greater power that is... NOT.. etc. etc." it would list "Russia: {effect}", "Austria: {effect}" and so forth, whoever is covered by the scope. If you'd prefer to have the tooltip display all the conditions, you should use any_country instead and just include "is_greater_power = yes" in the triggers.

any_owned

Syntax:

any_owned = { effects… }

Scope:
Changes the current scope to every owned province.

any_neighbor_country

Syntax:

any_neighbor_country = { effects… }

Scope:
Changes the current scope to all the neighboring countries.

NOTE: For the tooltip, this handily does not display the text of the scope and its conditions but rather lists every country that would be affected. So, rather than printing "Any neighbor country that is... NOT.. etc. etc." it would list "Russia: {effect}", "Austria: {effect}" and so forth, whoever is covered by the scope. If you'd prefer to have the tooltip display all the conditions, you should use any_country instead and just include "neighbour = THIS" in the triggers.

any_state

Syntax:

any_state = { effects… }

Scope:
Changes the current scope to every owned state.

capital_scope

Syntax:

capital_scope = { effects… }

Scope:
Changes the current scope to the country’s capital.

[country tag]

Syntax:

[tag] = { effects… }

Scope:
Changes the current scope to the specified country.

cultural_union

Syntax:

cultural_union = { effects… }

Scope:
Changes the current scope to the cultural union of the nation in the previous scope.

from

Syntax:

from = { effects… }

Scope:
Changes the scope to the country that triggered the current event.

overlord

Syntax:

overlord = { triggers...}

Scope:
Changes the scope for a vassal to its overlord country.

random_country

Syntax:

random_country = { effects... }

Scope:
Changes the current scope to a random existing country.

random_owned

Syntax:

random_owned = { effects… }

Scope:
Changes the current scope to a random owned province.

random_pop

Syntax:

random_pop = { triggers … }

Scope:
Changes the current scope to a random pop in the country. Can be limited by location.

[region name]

Syntax:

[region name] = { effects… }

Scope:
Changes the current scope to the specified region.

sphere_owner

Syntax:

sphere_owner = { triggers... }

Scope:
Changes the current scope to the sphere owner of the country.

Province Scopes: Effects

any_neighbor_province

Syntax:

any_neighbor_province = { effects… }

Scope:
Changes the current scope to every neighboring province.

country

Syntax:

country = { effects… }

Scope:
Changes the current scope to the country to which this province belongs.

cultural_union

Syntax:

cultural_union = { effects… }

Scope:
Changes the current scope to the cultural union of the nation in the previous scope.

owner

Syntax:

owner = { effects… }

Scope:
Changes the current scope to the country to which this province belongs. Same as country scope from a province but more consistent with its corresponding trigger.

[province ID]

Syntax:

[province id] = { effects… }

Scope:
Changes the current scope to the specified province.

random_neighbor_province

Syntax:

random_neighbor_province = { effects… }

Scope:
Changes the current scope to a random neighbour province.

random_empty_neighbor_province

Syntax:

random_empty_neighbor_province = { effects… }

Scope:
Changes the current scope to random, empty neighbour province.

See also