Scripted trigger

should_notify_player_about_neighboring_rulers_wars_trigger

should_notify_player_about_neighboring_rulers_wars_trigger = { TARGET_CHARACTER = … }

game/common/scripted_triggers/00_distance_triggers.txt, line 12 (12 lines). Parameters: $TARGET_CHARACTER$ .

should_notify_player_about_neighboring_rulers_wars_trigger is a scripted trigger in Crusader Kings III, written at line 12 of its file. A call passes 1 parameter: TARGET_CHARACTER. The game's script calls it in 1 place, among them notify_players_about_neighboring_war_resolution_effect (scripted effect). Patch 1.20.1.2, from game/common/scripted_triggers/00_distance_triggers.txt.

What it checks

NOT = { target_is_liege_or_above = $TARGET_CHARACTER$ }
NOT = { target_is_vassal_or_below = $TARGET_CHARACTER$ }
character_realm_neighbors_target_trigger = { TARGET_CHARACTER = $TARGET_CHARACTER$ }
One of these
- $TARGET_CHARACTER$ = { top_liege = this }
- or
  liege = $TARGET_CHARACTER$.liege
- or
  top_liege = $TARGET_CHARACTER$.liege

• the game's own tooltip text · ◦ our reading of the script line · code the script where neither exists

“They” is whatever it runs on (the scope it is called in). The scripted triggers and effects it calls link to their own pages; $PARAMETERS$ stay as written: each call fills them in.

The script as written (12 lines of game script)

should_notify_player_about_neighboring_rulers_wars_trigger = {
	NOR = {
		target_is_liege_or_above = $TARGET_CHARACTER$ # We have separate toasts for this.
		target_is_vassal_or_below = $TARGET_CHARACTER$ # We are probably already aware of our vassal's wars (and likely involved in them in some fashion).
	}
	character_realm_neighbors_target_trigger = { TARGET_CHARACTER = $TARGET_CHARACTER$ }
	OR = {
		$TARGET_CHARACTER$ = { top_liege = this } # Independent rulers are always relevant.
		liege = $TARGET_CHARACTER$.liege # Rulers are also relevant if we have the same direct liege (We might be able to DoW them, or at least want to stay informed as to relative power level).
		top_liege = $TARGET_CHARACTER$.liege # Alternatively, if their direct liege is our top liege, we can still DoW them (If I am a Duke under a King under an Emperor, I might still want to DoW one of the Emperor's other King or Duke vassals.)
	}
}

As written in game/common/scripted_triggers/00_distance_triggers.txt.

Where it is used

Every place in common/, events/ and history/ that calls should_notify_player_about_neighboring_rulers_wars_trigger.

Scripted effects (1)

notify_players_about_neighboring_war_resolution_effect

Source: game/common/scripted_triggers/00_distance_triggers.txt and every file of common/, events/ and history/ that calls it, Crusader Kings III 1.20.1.2.