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

Scripted effect · Tours and Tournaments files

tour_distribute_control

tour_distribute_control = { CAPITAL = … HELD_AND_VASSAL_COUNTIES = … HELD_COUNTIES = … }

game/common/scripted_effects/04_dlc_ep2_tour_effects.txt, line 617 (76 lines). Parameters: $CAPITAL$, $HELD_AND_VASSAL_COUNTIES$, $HELD_COUNTIES$.

tour_distribute_control is a scripted effect in Crusader Kings III, in the Tours and Tournaments files, written at line 617 of its file. A call passes 3 parameters: CAPITAL, HELD_AND_VASSAL_COUNTIES and HELD_COUNTIES. The game's script calls it in 12 places, among them …'s Finest (event tour_grounds_events.3060), A Farmer's Pride (event tour_grounds_events.3090) and A Moment of Silence (event tour_grounds_events.3070). Patch 1.20.1.2, from game/common/scripted_effects/04_dlc_ep2_tour_effects.txt.

What it does

  • scope:activity › Activity log entry:
    • If

      • $CAPITAL$ > 0
      • NOT = { $CAPITAL$ = $HELD_COUNTIES$ }
      • NOT = { $CAPITAL$ = $HELD_AND_VASSAL_COUNTIES$ }

      Then

      • Your location’s county:
        • change_county_control = $CAPITAL$
    • If

      • $HELD_AND_VASSAL_COUNTIES$ > 0

      Then

      • If

        • $CAPITAL$ = $HELD_AND_VASSAL_COUNTIES$

        Then

        • Your location’s county’s holder › Every County title within … realm:
          • change_county_control = $HELD_AND_VASSAL_COUNTIES$

        Otherwise

        • Your location’s county’s holder › Every County title within … realm:
          • change_county_control = $HELD_AND_VASSAL_COUNTIES$

      Else if

      • $HELD_COUNTIES$ > 0

      Then

      • If

        • $CAPITAL$ = $HELD_COUNTIES$

        Then

        • Your location’s county’s holder › Every County title held by …:
          • title_tier = county
          • change_county_control = $HELD_COUNTIES$

        Otherwise

        • Your location’s county’s holder › Every County title held by …:
          • change_county_control = $HELD_COUNTIES$

• 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 (76 lines of game script)
tour_distribute_control = {
	scope:activity = {
		add_activity_log_entry = {
			key = increased_control_log
			tags = { good }
			character = scope:visiting_liege
			target = scope:stop_host_scope
			show_in_conclusion = yes
			if = {
				limit = {
					$CAPITAL$ > 0
					NOR = { # Do not apply if CAPITAL and HELD_COUNTIES are the same
						$CAPITAL$ = $HELD_COUNTIES$
						$CAPITAL$ = $HELD_AND_VASSAL_COUNTIES$
					}
				}
				root.location.county = { change_county_control = $CAPITAL$ }
			}
			if = { # County titles held by your vassal and their vassals
				limit = {
					$HELD_AND_VASSAL_COUNTIES$ > 0
				}
				if = {
					limit = {
						$CAPITAL$ = $HELD_AND_VASSAL_COUNTIES$ # Apply to capital if the values are the same
					}
					root.location.county.holder = {
						every_sub_realm_county = {
							custom = every_title_held_by_vassal_and_vassals
							change_county_control = $HELD_AND_VASSAL_COUNTIES$
						}
					}
				}
				else = {
					root.location.county.holder = {
						every_sub_realm_county = {
							custom = every_title_held_by_vassal_and_vassals
							limit = {
								this != root.location.county
							}
							change_county_control = $HELD_AND_VASSAL_COUNTIES$
						}
					}
				}
			}
			else_if = { # Only apply if HELD_AND_VASSAL_COUNTIES is not applied, prevent double tooltips
				limit = {
					$HELD_COUNTIES$ > 0
				}
				if = {
					limit = {
						$CAPITAL$ = $HELD_COUNTIES$ # Apply to capital if the values are the same
					}
					root.location.county.holder = {
						every_held_title = {
							custom = every_title_held_by_vassal
							title_tier = county
							change_county_control = $HELD_COUNTIES$
						}
					}
				}
				else = {
					root.location.county.holder = {
						every_held_title = {
							custom = every_title_held_by_vassal
							limit = {
								this != root.location.county
							}
							change_county_control = $HELD_COUNTIES$
						}
					}
				}
			}
		}
	}
}

As written in game/common/scripted_effects/04_dlc_ep2_tour_effects.txt.

Where it is used

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

Events (8)

2 more

Scripted effects inside an event file (4)

  • 3012_horrified_effect
  • 3012_impressed_effect
  • 3014_paid_tax_effect
  • 3019_liege_pay_tax_effect

Source: game/common/scripted_effects/04_dlc_ep2_tour_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?