Interaction · Diplomatic actions
Trade a Hook
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
- Your Government is Merchant
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.
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.
| Reason | Amount |
|---|---|
| Base | +50 |
| … Opinion of … | varies |
Requested a favor recentlywhen
| -50 |
| Their personality (AI values: compassion -0.5, greed -0.5) | varies |
They is Bankruptwhen
| +100 |
The recipient is poorwhen
| -30 |
The recipient has little Prestigewhen
| -30 |
The recipient has a Stewardship Education Traitwhen
| +25 |
| Your valid Charter | +25 |
The recipient has relevant Lifestyle Focuswhen
| +25 |
You have Flexible Truceswhen
| +20 |
You … Forced Vassalagewhen
| +15 |
Chains of Loyaltywhen
| +15 |
Disgraced Level of Famewhen
| -10 |
Distinguished Level of Famewhen
| +5 |
Illustrious Level of Famewhen
| +10 |
Exalted Among Men Level of Famewhen
| +20 |
Legendary Figure Level of Famewhen
| +30 |
Distinguished Level of Famewhen
| +6 |
Illustrious Level of Famewhen
| +12 |
Exalted Among Men Level of Famewhen
| +24 |
Legendary Figure Level of Famewhen
| +36 |
You … a Dealbreakerwhen
| -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
- You: Has the Golden Obligations Perk
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
- You: Has the Golden Obligations Perk
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
Otherwise
- The character you target: Pay gold to you
- The character you target:
- The character you target › If played by the AI: Opinion: Used Me for Favors (-10)
- When yes is scope:request prestige:
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.