Scripted effect · By God Alone files

pam_make_clerical_ruler_puppet_effect

pam_make_clerical_ruler_puppet_effect = { PUPPETEER = … }

game/common/scripted_effects/pam_effects.txt, line 13644 (29 lines). Parameters: $PUPPETEER$ .

pam_make_clerical_ruler_puppet_effect is a scripted effect in Crusader Kings III, in the By God Alone files, written at line 13644 of its file. A call passes 1 parameter: PUPPETEER. The game's script calls it in 2 places, among them Request Cardinalate for Court Chaplain (interaction) and on_title_gain (on action). Patch 1.20.1.2, from game/common/scripted_effects/pam_effects.txt.

The comment above it in the file

A Realm Priest Puppet who has grown into a titled cleric belongs in the Clerical Ruler Puppet slot,
which also frees the Realm Priest slot for whoever takes over the council seat.
ROOT = the puppet, $PUPPETEER$ = the ruler holding them.
No-op if the target slot is taken, or if they still hold the court chaplain seat.

What it does

If
- scope:pam_clerical_puppeteer:
  NOT = { cp:councillor_court_chaplain ?= scope:pam_clerical_ruler_puppet }
Then
- scope:pam_clerical_puppeteer:
  set_puppet = { target = scope:pam_clerical_ruler_puppet type = external_theological_agent_puppet }

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

pam_make_clerical_ruler_puppet_effect = {
	# Both scopes are saved up front because clear_puppet_status severs the puppeteer link
	save_temporary_scope_as = pam_clerical_ruler_puppet
	$PUPPETEER$ = { save_temporary_scope_as = pam_clerical_puppeteer }
	if = {
		limit = {
			scope:pam_clerical_puppeteer = {
				NOR = {
					exists = puppet:external_theological_agent_puppet
					cp:councillor_court_chaplain ?= scope:pam_clerical_ruler_puppet
				}
			}
		}
		# Silent: the slot they move into is what the player is told about, not the one they leave
		hidden_effect = { clear_puppet_status = yes }
		scope:pam_clerical_puppeteer = {
			send_interface_toast = {
				type = event_toast_effect_good
				title = make_external_clerical_puppet_on_action_notification
				left_icon = scope:pam_clerical_puppeteer
				right_icon = scope:pam_clerical_ruler_puppet
				set_puppet = {
					target = scope:pam_clerical_ruler_puppet
					type = external_theological_agent_puppet
				}
			}
		}
	}
}

As written in game/common/scripted_effects/pam_effects.txt.

Where it is used

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

Character interactions (1)

Request Cardinalate for Court Chaplain

On actions (the game's own hooks) (1)

on_title_gain

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