作用域

Scopes are used in scripting to select entities in order to check for conditions or apply commands.

瞄准镜右侧总有一个支架块：

<scope_name> = {

    #Stuff to execute in the scope.

}

但并非所有括号区块都是作用域：有些是函数区块 （option, trigger, mean_time_to_happen,...), operators (AND), flow control statements (if, limit), or clause for complex conditions or commands (create_character, ...).

脚本可以创建十种类型的范围：角色、头衔/持有、省份、战争、围城/侧翼、单位、宗教、文化、社会和神器。还有一个特别节目 portrait scope used for portrait rendering rules.

Scopes can be nested (see scope chain），通常相对于调用作用域的函数，除了那些全局且可以从“任意”作用域调用的函数。

只有在作用域存在时，触发器和效果才会被评估和执行。这可以用于 always = yes 用来检查触发器中是否存在瞄准镜，或者是否有你只想执行的效果，比如角色的宗教有宗教领袖。

Note that the condition tooltips within any_ 范围具有误导性，只显示该范围内某个特定、看似随机选择的事物是否满足条件，因此即使该范围本身被评估为真，也可能显示某些条件是假的。 这些函数最好用 custom_tooltip.

Condition vs command scopes

在条件块中使用时，作用域允许检查该范围是否匹配任何实体：

trigger = {

    <scope_name> = {

	#Conditions to be met by at least one entity in the scope for the trigger to evaluate to true

    }

}

在命令块中使用时，作用域允许对该范围匹配的每个实体应用命令：

effect = {

    <scope_name> = {

	limit = { #Optional limit block (valid only for any_* and random_* scopes)

	    #Further conditions to filter entities matched by the scope

	}

	#Commands to apply each entity in the scope

    }

}

有些示波器只在条件块中工作（这种情况很少见），有些则只在生效命令块中工作（所有random_*范围）。

Count

any_ scopes can use count = N.对于条件范围，只有当至少N项匹配时，范围才会被评估为真。对于效果范围，范围最多执行N个项目（not randomized).

Limit

Preferred limit

random_ scopes (except for random_quest_target) allow for one or multiple preferred_limit blocks in addition to the regular limit.使用优选极限时，将先使用至少一个目标满足的极限，作为该极限的补充。如果没有满足任何优选限制，则只使用基础限制。当你想选择更好的目标时非常有用。

以下例子会给一个随机的独立挪威人，如果存在少于1000金币的话。如果没有，它会给一个金币少于1000的随机独立北日耳曼人。如果没有，它会给任何文化中一个金币少于1000金币的随机独立统治者。

random_independent_ruler = {

    limit = { wealth < 1000 }

    preferred_limit = { culture = norwegian }

    preferred_limit = { culture_group = north_germanic }

    wealth = 1000 

}

Score value

any_ 通过指定 a 来缩小范围至最高得分者 score_value system:

	

any_society_member = {

    score_value = {

        value = 1

        additive_modifier = {

            society_rank == 4

            value = 1000

        }

        additive_modifier = {

            society_rank == 3

            value = 100

        }

    }

    count = 3

    add_trait = maimed

}

如果分数并列，则只有1分（或 count从得分最高的项目中选出，但选择为 not randomized. Set of modifiers can be defined in common/scripted_score_values/ for reuse.

Quickcard

The most important scopes are shown in this quickcard:

Legend:

• (!) CPU heavy, use with care
• (scope) deprecated variant, rarely used in vanilla
• * coming in some next patch^[1]

List of scopes

Character

Character 瞄准镜都是针对角色的瞄准镜。游戏中的大多数瞄准镜都是角色瞄准镜。“from scope”栏显示该项目可以调用的范围。

注意死字符很特殊：他们通常需要带后缀的瞄准镜 _even_if_dead to be scoped to (ex: father_even_if_dead，且有些瞄准镜在死角色瞄准镜内可能无法工作。

on_hajj = {

    NOR = {

	has_character_flag = hajj_arrived_in_mecca

	opinion = { who = ROOT value >= 0 }

    }

}

any_courtier_or_vassal = {

    has_minor_title = title_court_physician

    liege = { character = PREVPREV }

}

any_character = {

    independent = no

    liege = { character = PREVPREV }

}

any_opinion_modifier_target = {

    limit = {

	reverse_has_opinion_modifier = {

	    who = PREV

	    modifier = opinion_spying_on

	}

    }

    reverse_remove_opinion = {

	who = PREV

	modifier = opinion_spying_on

    }

}

any_plotter = {

    target = ROOT

    limit = {

	OR = {

	    has_plot = plot_kill_character

	    has_plot = plot_kill_spouse

	}

    }

    character_event = { id = CM.6001 }

}

best_fit_character_for_title = {

    title = PREV 

    perspective = ROOT

    index = 1 

    grant_title = PREV

}

Title

Title scopes are all scopes that target titles.

Title scopes of baron tier are also referred as holding scopes某些触发/命令只在持牌时生效（例如，add_building）。

额外的领地（贸易站、医院和堡垒）没有相应的领地/头衔范围，而是由其母省的范围管理^[4].

“from scope”栏显示该项目可以调用的范围。

Province

Province scopes are all scopes that target provinces.

额外的领地（贸易站、医院和堡垒）通过省份范围锁定，使用带有额外领地名称的条件/命令（has_fort, fort_has_building, etc.)^[5]

“from scope”栏显示该项目可以调用的范围。

Offmap power

地图外的功率范围允许对特定地图外国家进行瞄准，比如中国。

War

战争范围允许将视角视为持续中的战争。 战争范围中可用的触发器和效果非常少（using_cb , war_score, war_title, end_war, days_since_last_hostile_action).

Siege/Flank

围攻（或侧翼）瞄准镜允许瞄准正在进行的战斗。它们不同于单位瞄准镜。

Unit

单位范围允许将范围扩展到一支军队（非战斗/围城）或舰队。在原版中很少使用，而且在这些领域中有效的触发或效果非常少（loot, set_looting, set_can_toggle_looting).

Religion

注意：大多数在宗教范围中有效的范围/命令/条件也可以在角色范围内使用

Culture

Society

Artifact

Bloodline

Wonder

References