Interaction · Vassal actions
Request Merchant Charter
Ask the recipient to grant a Charter to …
What you need
You
To send it
- May only be requested from your Patron (…)
If
suzerain ?= { highest_held_title_tier >= tier_empire }
Then
Else if
suzerain ?= { highest_held_title_tier >= tier_kingdom }
Then
Else if
suzerain ?= { highest_held_title_tier >= tier_duchy }
Then
Otherwise
always = yes
To see it in the menu
- Your Government is Merchant
Request Merchant Charter is a vassal character interaction in Crusader Kings III. You need: May only be requested from your Patron (…). The character you target needs: Is landed and Highest held Title is at least Duchy Rank. The AI weighs it. Reasons the AI weighs include Hook used (+60), Spending Gold (+20), You … Accomplished Forger (+10) and 7 more. It costs Prestige (from 150). It needs Silk and Silver. Patch 1.21.0, from game/common/character_interactions/11_gdp_merchant_interactions.txt.
Quick answers (3)
- What are the requirements for Request Merchant Charter in CK3?
- You: May only be requested from your Patron (…). The character you target: Is landed and Highest held Title is at least Duchy Rank. (patch 1.21.0)
- How do I get the AI to accept Request Merchant Charter?
- The AI weighs it. Its reasons: Intimidated by you, Terrified of you, Hook used +60, Spending Gold +20, You … Accomplished Forger +10, Positive Special Relation with the recipient +15, Negative Special Relation with the recipient -15, Your Level of Fame, The recipient's Culture is unrelated to yours -20, Your Faith is …, Company Size relative to Patron Rank, Company Size relative to Patron Rank, Company Size relative to Patron Rank -25, Company Size relative to Patron Rank, Company Size relative to Patron Rank +25, Current Charter holder has abused its authority, You … a Dealbreaker -100, Size of forgiven Loan and Forgiving Loan Strong Hook +160.
- How much does Request Merchant Charter cost?
- Prestige (from 150) (patch 1.21.0).
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 | -40 |
Intimidated by youwhen
| intimidated_external_reason_value |
Terrified of youwhen
| cowed_external_reason_value |
Hook usedwhen
| +60 |
Spending Goldwhen
| +20 |
You … Accomplished Forgerwhen
| +10 |
| Their opinion of you × 0.4 | varies |
Positive Special Relation with the recipientwhen
| +15 |
Negative Special Relation with the recipientwhen
| -15 |
| Your Level of Fame | varies |
The recipient's Culture is unrelated to yourswhen
| -20 |
Your Faith is …when
| varies |
Company Size relative to Patron Rankwhen
| varies |
Company Size relative to Patron Rankwhen
| varies |
Company Size relative to Patron Rankwhen
| -25 |
Company Size relative to Patron Rankwhen
| varies |
Company Size relative to Patron Rankwhen
| +25 |
| Current Charter holder has abused its authority | varies |
You … a Dealbreakerwhen
| -100 |
Size of forgiven Loanwhen
| varies |
Forgiving Loan Strong Hookwhen
| +160 |
Acceptance (ai_accept) (242 lines of game script)
base = -40
modifier = {
scope:recipient = {
has_dread_level_towards = {
target = scope:actor
level = 1
}
}
add = intimidated_external_reason_value
desc = INTIMIDATED_REASON
}
modifier = {
scope:recipient = {
has_dread_level_towards = {
target = scope:actor
level = 2
}
}
add = cowed_external_reason_value
desc = COWED_REASON
}
modifier = {
scope:hook ?= yes
add = 60
desc = LEGEND_HOOK_USED
}
modifier = {
scope:gold_send_option ?= yes
add = 20
desc = GOLD_INTERACTION_ACCEPTANCE_SEND_OPTION
}
modifier = {
scope:actor = {
has_perk = accomplished_forger_perk
}
add = 10
desc = master_of_seals_perk_acceptance
}
opinion_modifier = {
opinion_target = scope:actor
who = scope:recipient
multiplier = 0.4
}
modifier = {
scope:actor = {
has_any_good_relationship_with_character_trigger = {
CHARACTER = scope:recipient
}
}
add = 15
desc = POSITIVE_RELATIONSHIP_RECIPIENT_REASON
}
modifier = {
scope:actor = {
has_any_bad_relationship_with_character_trigger = {
CHARACTER = scope:recipient
}
}
add = -15
desc = NEGATIVE_RELATIONSHIP_RECIPIENT_REASON
}
modifier = {
add = {
value = -3
add = scope:actor.prestige_level
multiply = 5
}
desc = ACTOR_PRESTIGE_LEVEL_REASON
}
modifier = {
NOR = {
scope:actor.culture = scope:recipient.culture
scope:actor.culture = {
any_parent_culture_or_above = {
this = scope:recipient.culture
}
}
scope:recipient.culture = {
any_parent_culture_or_above = {
this = scope:actor.culture
}
}
scope:actor.culture = {
has_same_culture_heritage = scope:recipient.culture
}
}
add = -20
desc = DIFFERENT_CULTURE_REASON
}
modifier = {
scope:recipient.faith = {
faith_hostility_level = {
target = scope:actor.faith
value >= faith_astray_level
}
}
add = {
value = faith.faith_hostility_level(scope:actor.faith)
multiply = -10
}
desc = FAITH_HOSTILITY_LEVEL
}
modifier = {
scope:actor = {
has_realm_law = company_size_small
}
scope:recipient.highest_held_title_tier >= tier_kingdom
add = {
value = -25
if = {
limit = {
scope:recipient.highest_held_title_tier >= tier_empire
}
add = -25
}
if = {
limit = {
scope:recipient.highest_held_title_tier >= tier_hegemony
}
add = -25
}
}
desc = COMPANY_TOO_SMALL_FOR_TIER_REASON
}
modifier = {
scope:actor = {
has_realm_law = company_size_medium
}
scope:recipient.highest_held_title_tier >= tier_empire
add = {
value = -25
if = {
limit = {
scope:recipient.highest_held_title_tier >= tier_hegemony
}
add = -25
}
}
desc = COMPANY_TOO_SMALL_FOR_TIER_REASON
}
modifier = {
scope:actor = {
has_realm_law = company_size_large
}
scope:recipient.highest_held_title_tier >= tier_hegemony
add = -25
desc = COMPANY_TOO_SMALL_FOR_TIER_REASON
}
modifier = {
scope:actor = {
has_realm_law = company_size_huge
}
scope:recipient.highest_held_title_tier <= tier_kingdom
add = {
value = 25
if = {
limit = {
scope:recipient.highest_held_title_tier <= tier_duchy
}
add = 25
}
}
desc = COMPANY_LARGE_FOR_TIER_REASON
}
modifier = {
scope:actor = {
has_realm_law = company_size_large
}
scope:recipient.highest_held_title_tier <= tier_duchy
add = 25
desc = COMPANY_LARGE_FOR_TIER_REASON
}
modifier = {
scope:recipient = {
any_tributary = {
merchant_has_charter_from_patron_trigger = {
EQUIPPED = no
INCLUDE_FORGERIES = no
}
merchant_has_abused_charter_from_patron_trigger = {
PATRON = scope:recipient
}
}
}
add = {
value = 0
scope:recipient = {
every_tributary = {
limit = {
merchant_has_charter_from_patron_trigger = {
EQUIPPED = no
INCLUDE_FORGERIES = no
}
merchant_has_abused_charter_from_patron_trigger = {
PATRON = scope:recipient
}
}
add = {
value = merchant_charter_abuse_stance_level_value
min = 1
}
}
}
multiply = 10
max = 50
}
desc = CHARTER_HOLDER_ABUSED_CHARTER_REASON
}
modifier = {
add = -100
desc = AI_OPINION_DEALBREAKER_ACTOR
scope:actor = {
is_known_dealbreaker_trigger = {
KNOWER = scope:recipient
}
}
}
modifier = {
scope:forgive_loan = yes
add = {
value = 0
scope:recipient = {
ordered_owned_story = {
limit = {
story_type = story_cycle_loan
var:lender = scope:actor
}
order_by = var:years_since
add = {
value = var:amount_owed
divide = 5
}
}
}
}
desc = FORGIVE_LOAN_GOLD_REASON
}
modifier = {
scope:forgive_loan = yes
add = 160
desc = FORGIVE_LOAN_HOOK_REASON
}As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.
What happens
If they accept
- The character you target:
If
- The option “forgive loan” is chosen
Then
- One owned story, picked in order:
- Where:
story_type = story_cycle_loan- Lender is scope:actor
- They will forgive … Loan (…)
var:lender:If
None of these
- The debtor temp › Any owned story:
story_type = story_cycle_loan- Lender is scope:lender temp
- Is not the loan temp
- The debtor temp › Any owned story:
One of these
has_hook_of_type = { target = scope:debtor_temp type = strong_loan_hook }or
has_hook_of_type = { target = scope:debtor_temp type = weak_loan_hook }
Then
If
has_hook_of_type = { target = scope:debtor_temp type = strong_loan_hook }
Then
remove_hook = { target = scope:debtor_temp type = strong_loan_hook }
Otherwise
remove_hook = { target = scope:debtor_temp type = weak_loan_hook }
gdp_update_usury_reputation_effect = { }
end_story = yes
- Where:
- Every tributary:
- Only some of them (the filter is in the script below)
- The merchant temp › Every character artifact:
- Where: Charter patron is scope:patron temp
- The merchant temp › The patron temp › The patron temp:
destroy_artifact = scope:destroyed_charter_temp
- If played by the AI: Opinion: Revoked my Charter
- The merchant: “… Company Charter” Artifact is created
If
scope:patron.highest_held_title_tier >= tier_empire
Then
- The created charter:
set_artifact_name = merchant_charter_artifact_title_imperial
Else if
scope:patron.highest_held_title_tier = tier_kingdom
Then
- The created charter:
set_artifact_name = merchant_charter_artifact_title_royal
- The created charter:
If
rarity = common
Then
- 1 of 2 things will happen:
- 57%:
add_artifact_modifier = artifact_monthly_prestige_1_modifier
- 43%:
add_artifact_modifier = artifact_monthly_prestige_2_modifier
- 57%:
Else if
rarity = masterwork
Then
- 1 of 2 things will happen:
- 57%:
add_artifact_modifier = artifact_monthly_prestige_3_modifier
- 43%:
add_artifact_modifier = artifact_monthly_prestige_4_modifier
- 57%:
Else if
rarity = famed
Then
- 1 of 2 things will happen:
- 57%:
add_artifact_modifier = artifact_monthly_prestige_5_modifier
- 43%:
add_artifact_modifier = artifact_monthly_prestige_6_modifier
- 57%:
Else if
rarity = illustrious
Then
- 1 of 2 things will happen:
- 57%:
add_artifact_modifier = artifact_monthly_prestige_7_modifier
- 43%:
add_artifact_modifier = artifact_monthly_prestige_8_modifier
- 57%:
- Characters bearing Charters get access to: Abuse Charter Authority Decision · Direct Local Investment Decision · Leverage Patron's Authority Interaction
If
- The option “gold send option” is chosen
Then
- Pay gold to the target
Options when sending
- Use a Hook
- Send Gold
- Forgive a LoanOffer to forgive the recipient's Loan from you
• 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) (5 lines of game script)
is_available = has_gdp_dlc_trigger = yes
government_has_flag = government_is_merchant
is_shown = scope:recipient = {
is_landed = yes
}As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.
Can be sent when (is_valid…) (43 lines of game script)
scope:recipient = {
is_landed = yes
highest_held_title_tier >= tier_duchy
}
scope:actor = {
custom_tooltip = {
text = request_merchant_charter_patron_requirement_tt
suzerain ?= scope:recipient
}
trigger_if = {
limit = {
merchant_has_charter_from_patron_trigger = {
EQUIPPED = no
INCLUDE_FORGERIES = no
}
}
custom_tooltip = {
text = merchant_charter_request_single_charter_same_tt
always = no
}
}
trigger_else = {
scope:recipient = {
custom_tooltip = {
text = merchant_charter_request_single_charter_tt
NOT = {
any_tributary = {
merchant_has_charter_from_patron_trigger = {
EQUIPPED = no
INCLUDE_FORGERIES = no
}
NOT = {
merchant_has_abused_charter_from_patron_trigger = {
PATRON = scope:recipient
}
}
}
}
}
}
}
suzerain_tier_to_company_size_shared_valid_trigger = yes
}As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.
Effects (on_send, on_accept, on_decline) (137 lines of game script)
on_accept = scope:recipient = {
if = {
limit = {
scope:forgive_loan = yes
}
ordered_owned_story = {
limit = {
story_type = story_cycle_loan
var:lender = scope:actor
}
order_by = var:years_since
forgive_loan_effect = yes
}
}
every_tributary = {
limit = {
this != scope:actor
merchant_has_charter_from_patron_trigger = {
EQUIPPED = no
INCLUDE_FORGERIES = no
}
merchant_has_abused_charter_from_patron_trigger = {
PATRON = scope:recipient
}
}
merchant_charter_destroy_held_charters_effect = {
MERCHANT = this
PATRON = scope:recipient
}
if = {
limit = {
has_opinion_modifier = {
modifier = granted_charter_opinion
target = scope:recipient
}
}
hidden_effect = {
remove_opinion = {
modifier = granted_charter_opinion
target = scope:recipient
}
}
}
if = {
limit = {
is_ai = yes
}
add_opinion = {
modifier = revoked_my_charter_opinion
target = scope:recipient
}
}
}
}
scope:actor = {
if = {
limit = {
is_ai = no
any_character_artifact = {
var:charter_patron = scope:recipient
var:charter_house = scope:actor.house
exists = var:forger
}
}
custom_tooltip = merchant_charter_forgeries_destroyed_tt
}
create_merchant_charter_artifact_effect = {
PATRON = scope:recipient
MERCHANT = scope:actor
}
play_sound_effect = event:/DLC/EP5/SFX/Stingers/ep5_mx_sting_obtaining_charter
hidden_effect = {
send_interface_toast = {
type = event_toast_effect_good
title = merchant_charter_granted_title
left_icon = scope:recipient
right_icon = scope:created_charter
every_character_artifact = {
limit = {
var:charter_patron ?= scope:recipient
var:charter_house ?= scope:actor.house
exists = var:forger
}
save_temporary_scope_as = forgery_temp
scope:actor = {
destroy_artifact = scope:forgery_temp
}
}
show_as_tooltip = {
scope:created_charter ?= {
set_owner = scope:actor
}
}
}
}
custom_tooltip = merchant_charter_unlocks_tt
if = {
limit = {
scope:gold_send_option = yes
}
pay_short_term_gold = {
target = scope:recipient
gold = scope:recipient.major_gold_value
}
}
if = {
limit = {
scope:hook = yes
}
use_hook = scope:recipient
}
}
scope:recipient = {
hidden_effect = {
send_interface_toast = {
type = event_toast_effect_neutral
title = merchant_charter_granted_title
left_icon = scope:actor
right_icon = scope:created_charter
show_as_tooltip = {
scope:created_charter ?= {
set_owner = scope:recipient
}
}
}
}
add_character_flag = {
flag = merchant_charter_recently_granted
years = 2
}
}
on_decline = scope:recipient = {
add_character_flag = {
flag = merchant_charter_recently_granted
years = 4
}
}As written in game/common/character_interactions/11_gdp_merchant_interactions.txt.
- Category
- Vassal actions
- Cost: Prestige
- from 150
- Again on the same character
- after 10 years
- DLC
- Silk and Silver
- In the menu
- main list
- ID
request_merchant_charter_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. “…” marks words the game fills in at play time (a name, a title).