Scripted effect · Khans of the Steppe files

creating_kingdom_empire_title_effect

creating_kingdom_empire_title_effect = yes

game/common/scripted_effects/09_dlc_mpo_scripted_effects.txt, line 5 (50 lines). No parameters.

creating_kingdom_empire_title_effect is a scripted effect in Crusader Kings III, in the Khans of the Steppe files, written at line 5 of its file. It takes no parameters: creating_kingdom_empire_title_effect = yes. The game's script calls it in 1 place, among them migration_find_fitting_title_effect (scripted effect). Patch 1.20.1.2, from game/common/scripted_effects/09_dlc_mpo_scripted_effects.txt.

The comment above it in the file

Used in the Migration flow
Requires:
scope:actor - the character recieving the title
scope:target_title - the title in question

What it does

If
- scope:target_title.tier = tier_kingdom
Then
- create_dynamic_title = { tier = kingdom name = NEW_CREATED_TITLE_NAME }
Else if
- scope:target_title.tier = tier_empire
Then
- create_dynamic_title = { tier = empire name = NEW_CREATED_TITLE_NAME }
Every in list: Gains the … Title (old holder)
scope:new_title:
- The coat of arms changes
- set_color_from_title = scope:old_title
- set_capital_county = scope:old_title.title_capital_county
scope:old_holder:
- set_primary_title_to = scope:new_title

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

creating_kingdom_empire_title_effect = {
	save_scope_as = old_title

	if = {
		limit = {
			scope:target_title.tier = tier_kingdom
		}
		create_dynamic_title = {
			tier = kingdom
			name = NEW_CREATED_TITLE_NAME
		}
	}
	else_if = {
		limit = {
			scope:target_title.tier = tier_empire
		}
		create_dynamic_title = {
			tier = empire
			name = NEW_CREATED_TITLE_NAME
		}
	}

	create_title_and_vassal_change = {
		type = created
		save_scope_as = change
		add_claim_on_loss = no
	}

	scope:new_title = {
		add_to_list = creating_new_titles
	}

	every_in_list = {
		list = creating_new_titles
		change_title_holder = {
			holder = scope:old_holder
			change = scope:change
		}
	}

	resolve_title_and_vassal_change = scope:change

	scope:new_title = {
		set_coa = scope:old_title
		set_color_from_title = scope:old_title
		set_capital_county = scope:old_title.title_capital_county
	}

	scope:old_holder = { set_primary_title_to = scope:new_title }
}

As written in game/common/scripted_effects/09_dlc_mpo_scripted_effects.txt.

Where it is used

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

Scripted effects (1)

migration_find_fitting_title_effect

Source: game/common/scripted_effects/09_dlc_mpo_scripted_effects.txt and every file of common/, events/ and history/ that calls it, Crusader Kings III 1.20.1.2.