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

Interaction · Diplomatic actions

Designate Theocratic Heir

variesRenownfrom 150Prestigefrom 250PietyBy God AloneAccepted automatically

Designate the recipient as your preferred heir to your Theocratic Title

What you need

You

To send it

  • Is an Adult
  • You must first establish a Dynasty through the Establish a Dynasty Decision
  • … is already your Heir
  • is_valid_designated_heir = scope:recipient
  • If

    • You are not you

    Then

    • You › Your dynasty:
      • dynasty_prestige >= pam_designate_theocratic_heir_renown_cost_value
  • If

    • You are not you

    Then

    • You:
      • prestige >= pam_designate_theocratic_heir_prestige_cost_value
  • If

    • You are not you

    Then

    • You: You have 250 Piety

To see it in the menu

The character you target

To send it

  • Is an Adult
  • You cannot designate an heir that is older than you
  • … must not already be a landed Ruler
  • … does not share your Faith
  • Must match the Clerical Gender Doctrine of this Rite

To see it in the menu

  • One of these

    • Is a councillor of you
    • or

      Is a courtier of you
    • or

      root.house ?= house
    • or

      Is family of you

Designate Theocratic Heir is a diplomatic character interaction in Crusader Kings III. You need: Is an Adult and You must first establish a Dynasty through the Establish a Dynasty Decision. The character you target needs: Is an Adult, You cannot designate an heir that is older than you and Must match the Clerical Gender Doctrine of this Rite. Accepted automatically. It costs Renown (varies), Prestige (from 150), Piety (from 250). It needs By God Alone. Patch 1.20.1.2, from game/common/character_interactions/pam_interactions.txt.

for a guide, post or blog
Quick answers (3)
What are the requirements for Designate Theocratic Heir in CK3?
You: Is an Adult and You must first establish a Dynasty through the Establish a Dynasty Decision. The character you target: Is an Adult, You cannot designate an heir that is older than you and Must match the Clerical Gender Doctrine of this Rite. (patch 1.20.1.2)
Will the AI accept Designate Theocratic Heir?
Yes: it is accepted automatically.
How much does Designate Theocratic Heir cost?
Renown (varies), Prestige (from 150), Piety (from 250) (patch 1.20.1.2).

Will they accept?

The other character has no choice: the game accepts it automatically.

What happens

Effects

  • If

    • You are not you

    Then

    • You:
      • If designate theocratic heir renown cost more than 0 › Your dynasty:
        • add_dynasty_prestige = { … }
      • If designate theocratic heir prestige cost more than 0:
        • add_prestige = { … }
      • add_piety = { … }
  • If

    • The character you target: Is not a child of you

    Then

    • You:
      • adopt = scope:adoptee
      • The adoptee:
      • If

        Then

        • Every Courtly Vassal (…):
          • Where:
            • None of these

              • Their rite: The rite has Vassals and children who follow this Rite do not resent an adoption (-10 to -25 Opinion avoided)
          • vassal_stance = courtly
          • Opinion: Angry (-20)
      • If

        • Their faith:
          • faith_hostility_level = { target = scope:adoptee.faith value >= faith_evil_level }

        Then

        • Every Zealot Vassal (…):
          • Where:
            • None of these

              • Their rite: The rite has Vassals and children who follow this Rite do not resent an adoption (-10 to -25 Opinion avoided)
          • vassal_stance = zealot
          • Opinion: Angry (-25)

        Else if

        • Their faith:
          • faith_hostility_level = { target = scope:adoptee.faith value >= faith_hostile_level }

        Then

        • Every Zealot Vassal (…):
          • Where:
            • None of these

              • Their rite: The rite has Vassals and children who follow this Rite do not resent an adoption (-10 to -25 Opinion avoided)
          • vassal_stance = zealot
          • Opinion: Angry (-20)

        Else if

        • Their faith:
          • faith_hostility_level = { target = scope:adoptee.faith value >= faith_astray_level }

        Then

        • Every Zealot Vassal (…):
          • Where:
            • None of these

              • Their rite: The rite has Vassals and children who follow this Rite do not resent an adoption (-10 to -25 Opinion avoided)
          • vassal_stance = zealot
          • Opinion: Angry (-10)
      • If

        • One of these

          • Their faith:
            • faith_hostility_level = { target = scope:adoptee.faith value >= faith_astray_level }
          • or

            Their culture is not the same as that of adoptee

        Then

        • Every Minority Vassal (…):
          • Where:
            • None of these

              • Their rite: The rite has Vassals and children who follow this Rite do not resent an adoption (-10 to -25 Opinion avoided)
          • vassal_stance = minority
          • Opinion: Respect (+25)
      • Every Child who is not Content:
        • Where:
          • None of these

            • Is the adoptee
            • Has the Trait: Content
            • Their rite: The rite has Vassals and children who follow this Rite do not resent an adoption (-10 to -25 Opinion avoided)
        • Opinion: Angry (-20)
      • If

        • One of these

          • player_heir.age < scope:adoptee.age
          • or

            Their heir: Has the Trait: Ambitious
        • None of these

          • Their heir: Has the Trait: Humble
          • Their heir: Has the Trait: Content
          • Their heir: Has the Trait: Forgiving
          • Their heir:
            • One of these

              • has_personal_tenet = tenet_adoptionism
              • or

                Their rite: The rite has the tenet Adoptionism

        Then

        • Their heir:
          • If

            • The target char: Highest held Title is more than Barony Rank
            • One of these

              • Highest held Title is at most Barony Rank
              • or

                highest_held_title_tier <= { value = scope:target_char.highest_held_title_tier subtract = 3 }
            • None of these

              • Is family of the target char
              • Is the target char’s consort
              • Any heir title:
                • tier >= { value = scope:target_char.highest_held_title_tier subtract = 2 }

            Then

            • … (more in the script below)
          • … (more in the script below)
      • … (more in the script below)
    • … (more in the script below)
  • … (more in the script below)

When it is accepted automatically

Events it fires: char_interaction.0121

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

Who can use it and sees it (is_available, is_shown) (19 lines of game script)
is_available = has_pam_dlc_trigger = yes
is_shown = scope:puppet_or_actor ?= {
	has_realm_law = clerical_appointment_law
	NOT = {
		has_realm_law = theocratic_elective_succession_law
	}
	government_has_flag = government_is_theocracy
}
NOT = {
	scope:recipient = scope:puppet_or_actor
}
scope:recipient = {
	OR = {
		is_councillor_of = scope:puppet_or_actor
		is_courtier_of = scope:puppet_or_actor
		scope:puppet_or_actor.house ?= house
		is_close_or_extended_family_of = scope:puppet_or_actor
	}
}

As written in game/common/character_interactions/pam_interactions.txt.

Can be sent when (is_valid…) (69 lines of game script)
scope:puppet_or_actor = {
	is_adult = yes
	custom_tooltip = {
		text = designate_theocratic_heir_interaction_dynasty_tt
		exists = dynasty
	}
}
scope:recipient = {
	is_adult = yes
	custom_tooltip = {
		text = designate_theocratic_heir_interaction_older_tt
		birth_date >= scope:puppet_or_actor.birth_date
	}
	custom_tooltip = {
		text = designate_theocratic_heir_interaction_unlanded_tt
		is_ruler = no
	}
	custom_tooltip = {
		text = designate_theocratic_heir_interaction_faith_tt
		scope:puppet_or_actor.faith ?= faith
	}
	custom_tooltip = {
		text = pam_interaction_clerical_gender_tt
		trigger_if = {
			limit = {
				exists = scope:puppet_or_actor
			}
			can_be_granted_theocratic_titles_by = {
				RULER = scope:puppet_or_actor
			}
		}
	}
}
custom_tooltip = {
	text = designate_theocratic_heir_interaction_already_heir_tt
	NOR = {
		scope:puppet_or_actor.designated_heir ?= scope:recipient
		scope:puppet_or_actor.player_heir ?= scope:recipient
	}
}
scope:puppet_or_actor = {
	is_valid_designated_heir = scope:recipient
}
trigger_if = {
	limit = {
		scope:puppet_or_actor != scope:actor
	}
	scope:puppet_or_actor = {
		dynasty ?= {
			dynasty_prestige >= pam_designate_theocratic_heir_renown_cost_value
		}
	}
}
trigger_if = {
	limit = {
		scope:puppet_or_actor != scope:actor
	}
	scope:puppet_or_actor = {
		prestige >= pam_designate_theocratic_heir_prestige_cost_value
	}
}
trigger_if = {
	limit = {
		scope:puppet_or_actor != scope:actor
	}
	scope:puppet_or_actor = {
		piety >= major_piety_value
	}
}

As written in game/common/character_interactions/pam_interactions.txt.

Effects (on_send, on_accept, on_decline) (99 lines of game script)
on_accept = if = {
	limit = {
		scope:puppet_or_actor != scope:actor
	}
	scope:puppet_or_actor = {
		if = {
			limit = {
				pam_designate_theocratic_heir_renown_cost_value > 0
			}
			dynasty ?= {
				add_dynasty_prestige = {
					value = {
						add = pam_designate_theocratic_heir_renown_cost_value
						multiply = -1
					}
				}
			}
		}
		if = {
			limit = {
				pam_designate_theocratic_heir_prestige_cost_value > 0
			}
			add_prestige = {
				value = {
					add = pam_designate_theocratic_heir_prestige_cost_value
					max = prestige
					multiply = -1
				}
			}
		}
		add_piety = {
			value = {
				add = major_piety_value
				max = piety
				multiply = -1
			}
		}
	}
}
scope:puppet_or_actor = {
	send_interface_toast = {
		type = event_toast_effect_neutral
		title = designate_heir_interaction_notification
		left_icon = scope:puppet_or_actor
		right_icon = scope:recipient
		hidden_effect = {
			if = {
				limit = {
					scope:recipient = {
						NOT = {
							is_courtier_of = scope:puppet_or_actor
						}
					}
				}
				add_courtier = scope:recipient
			}
		}
		if = {
			limit = {
				scope:recipient = {
					NOT = {
						is_child_of = scope:puppet_or_actor
					}
				}
			}
			adopt_effect = {
				CHILD = scope:recipient
				ADOPTER = scope:puppet_or_actor
			}
		}
		primary_title = {
			change_appointment_investment = {
				target = scope:recipient
				investor = scope:puppet_or_actor
				value = {
					if = {
						limit = {
							exists = scope:puppet_or_actor.primary_title.current_heir
						}
						add = {
							value = scope:puppet_or_actor.primary_title.current_heir.appointment_candidate_score(scope:puppet_or_actor.primary_title)
							multiply = 1.1
						}
						subtract = scope:recipient.appointment_candidate_score(scope:puppet_or_actor.primary_title)
					}
					min = 4
				}
			}
		}
		set_designated_heir = scope:recipient
	}
}
notify_puppeteer_of_outcome_effect = {
	TYPE = event_toast_effect_neutral
	TITLE = designate_heir_interaction_notification_puppeteer
}
on_auto_accept = scope:recipient = {
	trigger_event = char_interaction.0121
}

As written in game/common/character_interactions/pam_interactions.txt.

Category
Diplomatic actions
Cost: Renown
varies
Cost: Prestige
from 150
Cost: Piety
from 250
DLC
By God Alone
In the menu
under More…
ID
designate_theocratic_heir_interaction

Source: game/common/character_interactions/pam_interactions.txt and the English localisation, Crusader Kings III 1.20.1.2. “You” is the character who sends it (scope:actor, or a puppet acting for you); “the character you target” is the recipient.

Spotted a mistake on this page?