CK3 DatabaseCrusader Kings III · 1.20.1.2 “Crozier” · unofficial
Silk & Silverout Tue, Nov 17What's free, what needs the DLC, price →

Scripted effect

grant_suitable_title_to_candidate_effect

grant_suitable_title_to_candidate_effect = yes

game/common/scripted_effects/00_mongol_invasion_effects.txt, line 10536 (263 lines). No parameters.

grant_suitable_title_to_candidate_effect is a scripted effect in Crusader Kings III, written at line 10536 of its file. It takes no parameters: grant_suitable_title_to_candidate_effect = yes. The game's script calls it in 1 place, among them break_up_mongol_empire_effect (scripted effect). Patch 1.20.1.2, from game/common/scripted_effects/00_mongol_invasion_effects.txt.

What it does

• 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 (120 lines of game script)
grant_suitable_title_to_candidate_effect = {
	save_temporary_scope_as = candidate
	
	# Runs through available titles and grants an available one
	random_list = {
		# Ilkhanate
		1 = {
			trigger = {
				exists = global_var:creatable_ilkhanate
				NOT = { exists = global_var:ilkhanate_handed_out }
				NOT = { exists = title:e_ilkhanate.holder }
			}
			# Weight the chance by how much territory you hold there
			modifier = {
				add = {
					every_sub_realm_county = {
						limit = {
							title_province = {
								geographical_region = special_mongol_empire_ilkhanate_region
							}
						}
						add = 50
					}
				}
				always = yes
			}
			grant_ilkhanate_effect = yes
		}
		# Golden Horde
		1 = {
			trigger = {
				exists = global_var:creatable_golden_horde
				NOT = { exists = global_var:golden_horde_handed_out }
				NOT = { exists = title:e_golden_horde.holder }
			}
			# Weight the chance by how much territory you hold there
			modifier = {
				add = {
					every_sub_realm_county = {
						limit = {
							title_province = {
								geographical_region = special_mongol_empire_golden_horde_region
							}
						}
						add = 50
					}
				}
				always = yes
			}
			grant_golden_horde_effect = yes
		}
		# Chagatai
		1 = {
			trigger = {
				exists = global_var:creatable_chagatai
				NOT = { exists = global_var:chagatai_handed_out }
				NOT = { exists = title:e_chagatai.holder }
			}
			# Weight the chance by how much territory you hold there
			modifier = {
				add = {
					every_sub_realm_county = {
						limit = {
							title_province = {
								geographical_region = special_mongol_empire_chagatai_region
							}
						}
						add = 50
					}
				}
				always = yes
			}
			grant_chagatai_effect = yes
		}
		# Great Yuan
		1 = {
			trigger = {
				exists = global_var:creatable_great_yuan
				NOT = { exists = global_var:great_yuan_handed_out }
				NOT = { exists = title:e_great_yuan.holder }
			}
			# Weight the chance by how much territory you hold there
			modifier = {
				add = {
					every_sub_realm_county = {
						limit = {
							title_province = {
								geographical_region = special_mongol_empire_great_yuan_region
							}
						}
						add = 50
					}
				}
				always = yes
			}
			grant_great_yuan_effect = yes
		}
		# Red Horde
		1 = {
			trigger = {
				exists = global_var:creatable_red_horde
				NOT = { exists = global_var:red_horde_handed_out }
				NOT = { exists = title:e_red_horde.holder }
			}
			# Weight the chance by how much territory you hold there
			modifier = {
				add = {
					every_sub_realm_county = {
						limit = {
							title_province = {
								geographical_region = special_mongol_empire_red_horde_region
							}
						}
						add = 50
					}
				}
				always = yes
			}
			grant_red_horde_effect = yes
		}

As written in game/common/scripted_effects/00_mongol_invasion_effects.txt.

The first 120 of its 263 lines; the rest is in game/common/scripted_effects/00_mongol_invasion_effects.txt from line 10536.

Where it is used

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

Scripted effects (1)

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

Spotted a mistake on this page?