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

Interaction · Vassal actions

Request Merchant Charter

from 150PrestigeSilk and SilverThe AI weighs it

Ask the recipient to grant a Charter to …

What you need

You

To send it

  • May only be requested from your Patron (…)
  • If

    • suzerain ?= { save_temporary_scope_as = patron_temp }
    • 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

    Then

    • … has already granted a Charter to …

    Otherwise

    • The character you target: … has already granted a Charter to another Client who has not abused its authority
  • 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

The character you target

To send it

To see it in the menu

  • Is landed

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.

for a guide, post or blog
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.

ReasonAmount
Base-40
Intimidated by you
when
  • The character you target:
    • has_dread_level_towards = { target = scope:actor level = 1 }
intimidated_external_reason_value
Terrified of you
when
  • The character you target:
    • has_dread_level_towards = { target = scope:actor level = 2 }
cowed_external_reason_value
Hook used
when
+60
Spending Gold
when
  • The option “gold send option” is chosen
+20
You … Accomplished Forger
when
+10
Their opinion of you × 0.4varies
Positive Special Relation with the recipient
when
  • One of these

    • One of these

      • Has the target as potential lover
      • or

        Has the target as crush
      • or

        Has the target as potential friend
      • or

        Has the target as guardian
      • or

        Has the target as ward
      • or

        Has the target as elder
      • or

        Has the target as disciple
    • or

      One of these

      • Has the target as lover
      • or

        Has the target as friend
+15
Negative Special Relation with the recipient
when
  • One of these

    • One of these

      • Has the target as potential rival
      • or

        Has the target as victim
      • or

        Has the target as bully
    • or

      Has the target as rival
-15
Your Level of Famevaries
The recipient's Culture is unrelated to yours
when
  • None of these

    • Your culture is the target’s
    • Your culture › Any parent culture or above:
      • this = scope:recipient.culture
    • The target’s culture › Any parent culture or above:
      • this = scope:actor.culture
    • Your culture:
      • has_same_culture_heritage = scope:recipient.culture
-20
Your Faith is …
when
  • The target’s faith:
    • faith_hostility_level = { target = scope:actor.faith value >= faith_astray_level }
varies
Company Size relative to Patron Rank
when
varies
Company Size relative to Patron Rank
when
varies
Company Size relative to Patron Rank
when
-25
Company Size relative to Patron Rank
when
  • Has the Trade Empire Law
  • scope:recipient.highest_held_title_tier <= tier_kingdom
varies
Company Size relative to Patron Rank
when
+25
Current Charter holder has abused its authority
when
  • The character you target › Any tributary:
    • suzerain ?= { save_temporary_scope_as = patron_temp }
    • 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
    • Charter abused patron is scope:recipient
varies
You … a Dealbreaker
when
  • One of these

-100
Size of forgiven Loan
when
  • The option “forgive loan” is chosen
varies
Forgiving Loan Strong Hook
when
  • The option “forgive loan” is chosen
+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
            • 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
    • 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
  • If

    • Is played by a person
    • Any character artifact:
      • Charter patron is scope:recipient
      • Charter house is scope:actor.house

    Then

  • 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

      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

      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

      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
  • 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
  • If

    Then

    • Use a Hook on 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).

Spotted a mistake on this page, or have an idea for the site?