Scripted trigger

common_can_character_join_trigger

common_can_character_join_trigger = { FACTION_TARGET = … }

game/common/scripted_triggers/00_faction_triggers.txt, line 78 (40 lines). Parameters: $FACTION_TARGET$ .

common_can_character_join_trigger is a scripted trigger in Crusader Kings III, written at line 78 of its file. A call passes 1 parameter: FACTION_TARGET. The game's script calls it in 8 places, among them Ceremonial Claimant Faction (factions), Claimant Faction (factions) and Dissolution Faction (factions). Its body carries 1 text of the game's own for the player. Patch 1.20.1.2, from game/common/scripted_triggers/00_faction_triggers.txt.

What it checks

common_character_validity_trigger = { FACTION_TARGET = $FACTION_TARGET$ }
Is an Adult
NOT = { has_truce = $FACTION_TARGET$ }
$FACTION_TARGET$ = { … }
One of these
- Is played by a person
- or
  NOT = { has_relation_lover = $FACTION_TARGET$ }
- or
  NOT = { has_relation_friend = $FACTION_TARGET$ }
$FACTION_TARGET$.highest_held_title_tier > tier_county
If
- government_is_japanese_trigger = yes
- $FACTION_TARGET$ = { government_is_japanese_trigger = yes }
Then
- You cannot join a Faction against a member of your same Bloc Use the Leave House Bloc Character Interaction to attack them

• 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 (40 lines of game script)

common_can_character_join_trigger = {
	common_character_validity_trigger = {
		FACTION_TARGET = $FACTION_TARGET$
	}
	is_adult = yes
	NOT = { has_truce = $FACTION_TARGET$ }
	$FACTION_TARGET$ = {
		NOT = { has_strong_hook = root }
		NOT = { is_allied_to = root }
	}

	OR = {
		is_ai = no
		NOR = {
			has_relation_lover = $FACTION_TARGET$ 
			has_relation_friend = $FACTION_TARGET$ 
		}
	}

	$FACTION_TARGET$.highest_held_title_tier > tier_county

	custom_description = {
		text = character_has_faction_disabling_modifier
		character_has_faction_disabling_modifier_trigger = yes
	}
	
	# You cannot join a faction against your bloc members
	trigger_if = {
		limit = {
			government_is_japanese_trigger = yes
			$FACTION_TARGET$ = { government_is_japanese_trigger = yes }
			exists = house.house_confederation
			exists = $FACTION_TARGET$.house.house_confederation
		}
		custom_tooltip = {
			text = house_confederation_join_faction_blocker_tt
			house.house_confederation != $FACTION_TARGET$.house.house_confederation
		}
	}
}

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

Where it is used

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

Factions (8)

Ceremonial Claimant Faction
Claimant Faction
Dissolution Faction
Imperial Policy Faction
Independence Faction
Install Ruling Regent Faction

2 more

Liberty Faction
Restore Ceremonial Monarch Faction

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