编辑“触发器”（章节）

=== Limit blocks ===

The <code>limit</code> block is used for conditional effects and triggers.

==== if/else_if ====

The most common use of the <code>limit</code> block is with the <code>if</code>/<code>else_if</code> effects, to execute effects only if the <code>limit</code> block is true.

Ex: this effect adds gold to the current character scope if they are a player.
<pre>if = {
   limit = { is_ai = no }
   add_gold = 100
}</pre>

==== effect list-builders ====

Limit blocks are also commonly used to restrict effect list builders.

Ex: this effect adds gold to the current character scope's children if they are male
<pre>every_child = {
   limit = { is_male = yes }
   add_gold = 100
}</pre>

Note: the <code>any_X</code> list-builder does ''not'' use a <code>limit</code> block.

==== trigger_if/trigger_else_if/trigger_else ====

<code>trigger_if</code> can be used to check a trigger only if the <code>limit</code> block is true.

Ex: if the current character scope is not an ai, this trigger checks whether they are an independent ruler
<pre>trigger_if = {
   limit = { is_ai = no }
   is_independent_ruler = yes
}</pre>

Conditional triggers are often used in tooltipped trigger blocks both for legibility and to avoid errors, because when tooltipped, early-out does not apply.

Ex: this trigger, when tooltipped, would throw an error when <code>primary_spouse</code> does not exist.
<pre>trigger = {
   exists = primary_spouse
   culture = primary_spouse.culture
}</pre>
but this would not throw an error, because if the <code>limit</code> block is false, the trigger is not evaluated.
<pre>trigger_if = {
   limit = { exists = primary_spouse }
   culture = primary_spouse.culture
}</pre>