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

Interaction · Diplomatic actions

Trade a Hook

No costThe AI weighs it

Use your Hook on the recipient to call on their favor

What you need

You

To send it

  • Has a Hook on the target
  • You must select at least one option

To see it in the menu

The character you target

To send it

  • None of these

    • Is at war with you
    • Has you as rival
    • Has the opinion “Released from Prison” of you
    • Has the opinion “Ignored Expulsion” of you
    • All of these

      • exists = scope:actor.house
      • Their house:
        • NOT = { this = scope:actor.house }
      • Your House Relation is Feuding
  • Also needed: available (an adult, not imprisoned, not incapable)

To see it in the menu

  • Is not a courtier of you

Trade a Hook is a diplomatic character interaction in Crusader Kings III. You need: Has a Hook on the target and You must select at least one option. The character you target needs: Is available (an adult, not imprisoned, not incapable). The AI weighs it. Reasons the AI weighs include Requested a favor recently (-50), They is Bankrupt (+100), The recipient is poor (-30) and 17 more. Patch 1.21.0, from game/common/character_interactions/11_gdp_merchant_interactions.txt.

for a guide, post or blog
Quick answers (2)
What are the requirements for Trade a Hook in CK3?
You: Has a Hook on the target and You must select at least one option. The character you target: Is available (an adult, not imprisoned, not incapable). (patch 1.21.0)
How do I get the AI to accept Trade a Hook?
The AI weighs it. Its reasons: … Opinion of …, Requested a favor recently -50, They is Bankrupt +100, The recipient is poor -30, The recipient has little Prestige -30, The recipient has a Stewardship Education Trait +25, Your valid Charter +25, The recipient has relevant Lifestyle Focus +25, You have Flexible Truces +20, You … Forced Vassalage +15, Chains of Loyalty +15, Disgraced Level of Fame -10, Distinguished Level of Fame +5, Illustrious Level of Fame +10, Exalted Among Men Level of Fame +20, Legendary Figure Level of Fame +30, Distinguished Level of Fame +6, Illustrious Level of Fame +12, Exalted Among Men Level of Fame +24, Legendary Figure Level of Fame +36 and You … a Dealbreaker -100.

Will they accept?

The AI adds these up and accepts above zero. Reasons in italics are the script's, with no label in the game.

ReasonAmount
Base+50
… Opinion of …varies
Requested a favor recently
when
  • The character you target: Has the opinion “Used Me for Favors” of you
-50
Their personality (AI values: compassion -0.5, greed -0.5)varies
They is Bankrupt
when
  • The option “request gold” is chosen
  • The character you target: Gold less than 0
+100
The recipient is poor
when
  • The option “request gold” is chosen
  • The character you target:
    • gold < major_gold_value
-30
The recipient has little Prestige
when
  • The option “request prestige” is chosen
  • The character you target: Prestige less than 350
-30
The recipient has a Stewardship Education Trait
when
  • The option “request gold” is chosen
  • The character you target: Has the Trait: Students of Stewardship
+25
Your valid Charter
when
  • Granter of any Charter Artifact is …
  • If

    • flag:no = flag:yes

    Then

    • • Is currently equipped
  • If

    • flag:no = flag:no

    Then

    • • Is not a forgery
+25
The recipient has relevant Lifestyle Focus
when
  • The option “request marriage” is chosen
  • The character you target:
    • One of these

      • has_focus = diplomacy_family_focus
      • or

        has_focus = intrigue_temptation_focus
      • or

        has_focus = martial_chivalry_focus
+25
You have Flexible Truces
when
+20
You … Forced Vassalage
when
+15
Chains of Loyalty
when
+15
Disgraced Level of Fame
when
  • root.prestige_level = 0
-10
Distinguished Level of Fame
when
+5
Illustrious Level of Fame
when
+10
Exalted Among Men Level of Fame
when
+20
Legendary Figure Level of Fame
when
+30
Distinguished Level of Fame
when
+6
Illustrious Level of Fame
when
+12
Exalted Among Men Level of Fame
when
+24
Legendary Figure Level of Fame
when
+36
You … a Dealbreaker
when
  • One of these

-100
Acceptance (ai_accept) (186 lines of game script)
base = 50
opinion_modifier = {
	who = scope:recipient
	opinion_target = scope:actor
	multiplier = 0.5
	desc = AI_OPINION_REASON
}
modifier = {
	add = -50
	scope:recipient = {
		has_opinion_modifier = {
			modifier = laamp_used_contact_opinion
			target = scope:actor
		}
	}
	desc = contact_list_request_interaction.repeated_request
}
ai_value_modifier = {
	ai_compassion = -0.5
	ai_greed = -0.5
	min = -50
	max = 50
}
modifier = {
	add = 100
	desc = bankrupt_recipient_reason
	scope:request_gold ?= yes
	scope:recipient = {
		gold < 0
	}
}
modifier = {
	add = -30
	desc = contact_list_request_interaction.request_gold.poor_recipient
	scope:request_gold ?= yes
	scope:recipient = {
		gold < major_gold_value
	}
}
modifier = {
	add = -30
	desc = contact_list_request_interaction.request_prestige.poor_recipient
	scope:request_prestige ?= yes
	scope:recipient = {
		prestige < major_prestige_value
	}
}
modifier = {
	add = 25
	desc = contact_list_request_interaction.request_gold.stewardship
	scope:request_gold ?= yes
	scope:recipient = {
		has_trait = education_stewardship
	}
}
modifier = {
	add = 25
	desc = granted_charter_reason
	scope:actor = {
		merchant_has_charter_from_trigger = {
			PATRON = scope:recipient
			ONLY_EQUIPPED = no
			INCLUDE_FORGERIES = no
		}
	}
}
modifier = {
	add = 25
	desc = contact_list_request_interaction.relevant_focus
	scope:request_marriage ?= yes
	scope:recipient = {
		OR = {
			has_focus = diplomacy_family_focus
			has_focus = intrigue_temptation_focus
			has_focus = martial_chivalry_focus
		}
	}
}
modifier = {
	add = 20
	desc = contact_list_request_interaction.flexible_truces_perk
	scope:actor = {
		has_perk = flexible_truces_perk
	}
}
modifier = {
	add = 15
	desc = exclusive_contracts_perk_acceptance
	scope:actor = {
		has_perk = forced_vassalage_perk
	}
}
modifier = {
	add = 15
	desc = chains_of_loyalty_perk_merchant_acceptance
	scope:actor = {
		government_has_flag = government_is_merchant
		has_perk = chains_of_loyalty_perk
	}
}
modifier = {
	add = -10
	desc = AI_OPINION_PRESTIGE_LEVEL_DISGRACED
	scope:actor.prestige_level = 0
}
modifier = {
	add = 5
	desc = AI_OPINION_PRESTIGE_LEVEL_DISTINGUISHED
	scope:actor.prestige_level = 2
	scope:actor = {
		NOT = {
			has_perk = true_ruler_perk
		}
	}
}
modifier = {
	add = 10
	desc = AI_OPINION_PRESTIGE_LEVEL_ILLUSTRIOUS
	scope:actor.prestige_level = 3
	scope:actor = {
		NOT = {
			has_perk = true_ruler_perk
		}
	}
}
modifier = {
	add = 20
	desc = AI_OPINION_PRESTIGE_LEVEL_EXALTED
	scope:actor.prestige_level = 4
	scope:actor = {
		NOT = {
			has_perk = true_ruler_perk
		}
	}
}
modifier = {
	add = 30
	desc = AI_OPINION_PRESTIGE_LEVEL_LEGENDARY
	scope:actor.prestige_level = 5
	scope:actor = {
		NOT = {
			has_perk = true_ruler_perk
		}
	}
}
modifier = {
	add = 6
	desc = AI_OPINION_PRESTIGE_LEVEL_DISTINGUISHED
	scope:actor.prestige_level = 2
	scope:actor = {
		has_perk = true_ruler_perk
	}
}
modifier = {
	add = 12
	desc = AI_OPINION_PRESTIGE_LEVEL_ILLUSTRIOUS
	scope:actor.prestige_level = 3
	scope:actor = {
		has_perk = true_ruler_perk
	}
}
modifier = {
	add = 24
	desc = AI_OPINION_PRESTIGE_LEVEL_EXALTED
	scope:actor.prestige_level = 4
	scope:actor = {
		has_perk = true_ruler_perk
	}
}
modifier = {
	add = 36
	desc = AI_OPINION_PRESTIGE_LEVEL_LEGENDARY
	scope:actor.prestige_level = 5
	scope:actor = {
		has_perk = true_ruler_perk
	}
}
modifier = {
	add = -100
	desc = AI_OPINION_DEALBREAKER_ACTOR
	scope:actor = {
		is_known_dealbreaker_trigger = {
			KNOWER = scope:recipient
		}
	}
}

As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.

What happens

If they accept

  • Use a Hook on the target
  • Your hook is used automatically
  • Depending on yes:
    • When yes is scope:request prestige:
      • If

        Then

        • The character you target:
          • add_prestige = { value = minor_prestige_gain multiply = -1 }
        • You:
          • add_prestige = { value = scope:recipient.medium_prestige_gain multiply = 2 }

        Otherwise

        • The character you target:
          • add_prestige = { value = minor_prestige_gain multiply = -1 }
        • You:
          • add_prestige = { value = scope:recipient.medium_prestige_gain }
      • The character you target › If played by the AI: Opinion: Used Me for Favors (-10)
    • When yes is scope:request competitiveness:
      • If

        Then

        • The local market:
          • add_competitiveness_modifier_for_character = { character = scope:actor modifier = gdp_trade_privileges_hook_double_modifier years = 10 }

        Otherwise

        • The local market:
          • add_competitiveness_modifier_for_character = { character = scope:actor modifier = gdp_trade_privileges_hook_modifier years = 10 }
      • The character you target › If played by the AI: Opinion: Used Me for Favors (-10)
    • In any other case:
      • If

        • The character you target:
          • Has “merchant ransom hook payer” (a variable the game's script sets)
          • Merchant ransom hook payer is scope:actor
          • Has “merchant ransom hook gold” (a variable the game's script sets)

        Then

        • The character you target: Pay gold to you

        Else if

        • The character you target:
          • Has “merchant sponsor hook payer” (a variable the game's script sets)
          • Merchant sponsor hook payer is scope:actor
          • Has “merchant sponsor hook gold” (a variable the game's script sets)

        Then

        • The character you target: Pay gold to you

        Else if

        Then

        • The character you target: Pay gold to you

        Otherwise

        • The character you target: Pay gold to you
      • The character you target › If played by the AI: Opinion: Used Me for Favors (-10)

If they refuse

  • The character you target › If played by the AI: Opinion: Annoyed (-10)

• 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) (7 lines of game script)
is_available = government_has_flag = government_is_merchant
is_shown = scope:actor != scope:recipient
scope:recipient = {
	NOT = {
		is_courtier_of = scope:actor
	}
}

As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.

Can be sent when (is_valid…) (42 lines of game script)
scope:actor = {
	has_hook = scope:recipient
}
scope:recipient = {
	is_available_quick = {
		adult = yes
		imprisoned = no
		incapable = no
	}
	NOR = {
		is_at_war_with = scope:actor
		has_relation_rival = scope:actor
		has_opinion_modifier = {
			target = scope:actor
			modifier = released_from_prison
		}
		has_opinion_modifier = {
			target = scope:actor
			modifier = eviction_ignored_opinion
		}
		house_has_feud_relation_with_trigger = {
			TARGET = scope:actor
		}
	}
}
scope:actor = {
	custom_description = {
		text = character_interactions_hostile_actions_disabled_delay
		NOT = {
			has_character_flag = flag_hostile_actions_disabled_delay
		}
	}
}
custom_tooltip = {
	text = interactions_general.tt.must_select_one_option
	calc_true_if = {
		amount = 1
		scope:request_gold = yes
		scope:request_prestige = yes
		scope:request_competitiveness = yes
	}
}

As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.

Effects (on_send, on_accept, on_decline) (223 lines of game script)
on_accept = scope:recipient.capital_province.barony.trade_market = {
	save_scope_as = local_market
}
scope:actor = {
	use_hook = scope:recipient
	custom_tooltip = contact_list_request_interaction.tt.hook_auto_used
	switch = {
		trigger = yes
		scope:request_prestige ?= {
			send_interface_toast = {
				type = event_toast_effect_good
				title = contact_list_request_interaction.request_prestige_tt
				left_icon = scope:actor
				right_icon = scope:recipient
				if = {
					limit = {
						scope:actor = {
							has_perk = golden_obligations_perk
						}
					}
					scope:recipient = {
						add_prestige = {
							value = minor_prestige_gain
							multiply = -1
						}
					}
					scope:actor = {
						add_prestige = {
							value = scope:recipient.medium_prestige_gain
							multiply = 2
						}
					}
				}
				else = {
					scope:recipient = {
						add_prestige = {
							value = minor_prestige_gain
							multiply = -1
						}
					}
					scope:actor = {
						add_prestige = {
							value = scope:recipient.medium_prestige_gain
						}
					}
				}
				scope:recipient = {
					if = {
						limit = {
							is_ai = yes
						}
						add_opinion = {
							modifier = laamp_used_contact_opinion
							target = scope:actor
							opinion = -10
						}
					}
				}
			}
		}
		scope:request_competitiveness ?= {
			send_interface_toast = {
				type = event_toast_effect_good
				title = contact_list_request_interaction.request_competitiveness_tt
				left_icon = scope:actor
				right_icon = scope:recipient
				if = {
					limit = {
						scope:actor = {
							has_perk = golden_obligations_perk
						}
					}
					scope:local_market = {
						add_competitiveness_modifier_for_character = {
							character = scope:actor
							modifier = gdp_trade_privileges_hook_double_modifier
							years = 10
						}
					}
				}
				else = {
					scope:local_market = {
						add_competitiveness_modifier_for_character = {
							character = scope:actor
							modifier = gdp_trade_privileges_hook_modifier
							years = 10
						}
					}
				}
				scope:recipient = {
					if = {
						limit = {
							is_ai = yes
						}
						add_opinion = {
							modifier = laamp_used_contact_opinion
							target = scope:actor
							opinion = -10
						}
					}
				}
			}
		}
		fallback = {
			send_interface_toast = {
				type = event_toast_effect_good
				title = contact_list_request_interaction.request_gold_tt
				left_icon = scope:actor
				right_icon = scope:recipient
				if = {
					limit = {
						merchant_trade_hook_from_ransom_trigger = yes
					}
					scope:recipient = {
						pay_short_term_gold = {
							gold = merchant_trade_hook_ransom_repayment_value
							target = scope:actor
						}
					}
				}
				else_if = {
					limit = {
						merchant_trade_hook_from_sponsor_trigger = yes
					}
					scope:recipient = {
						pay_short_term_gold = {
							gold = merchant_trade_hook_sponsor_repayment_value
							target = scope:actor
						}
					}
				}
				else_if = {
					limit = {
						scope:actor = {
							has_perk = golden_obligations_perk
						}
					}
					scope:recipient = {
						pay_short_term_gold = {
							gold = medium_gold_value_twice
							target = scope:actor
						}
					}
				}
				else = {
					scope:recipient = {
						pay_short_term_gold = {
							gold = medium_gold_value
							target = scope:actor
						}
					}
				}
				scope:recipient = {
					if = {
						limit = {
							is_ai = yes
						}
						add_opinion = {
							modifier = laamp_used_contact_opinion
							target = scope:actor
							opinion = -10
						}
					}
				}
			}
		}
	}
	hidden_effect = {
		if = {
			limit = {
				merchant_trade_hook_from_ransom_trigger = yes
				OR = {
					scope:request_gold ?= yes
					NOT = {
						scope:actor = {
							has_hook = scope:recipient
						}
					}
				}
			}
			scope:recipient = {
				remove_variable = merchant_ransom_hook_payer
				remove_variable = merchant_ransom_hook_gold
			}
		}
		if = {
			limit = {
				merchant_trade_hook_from_sponsor_trigger = yes
				OR = {
					scope:request_gold ?= yes
					NOT = {
						scope:actor = {
							has_hook = scope:recipient
						}
					}
				}
			}
			scope:recipient = {
				remove_variable = merchant_sponsor_hook_payer
				remove_variable = merchant_sponsor_hook_gold
			}
		}
	}
}
on_decline = scope:actor = {
	send_interface_toast = {
		type = event_toast_effect_bad
		title = patron_request_interaction_decline_toast
		right_icon = scope:recipient
		scope:recipient = {
			if = {
				limit = {
					is_ai = yes
				}
				add_opinion = {
					target = scope:actor
					modifier = annoyed_opinion
					opinion = -10
				}
			}
		}
	}
}

As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.

Category
Diplomatic actions
Again on the same character
after 5 years
In the menu
main list
ID
merchant_trade_hook_interaction

Source: game/common/character_interactions/11_gdp_merchant_interactions.txt and the English localisation, Crusader Kings III 1.21.0. “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, or have an idea for the site?