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

Grant Merchant Charter

variesPrestige25GoldThe AI weighs it

Give the recipient a Charter for …

What you need

You

To send it

To see it in the menu

The character you target

To send it

  • 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

    • You have already granted a Charter to …

    Otherwise

    • You:
      • One of these

        • Any tributary:
          • All of these

            • suzerain ?= { save_temporary_scope_as = patron_temp }
            • All of these

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

          always = yes
      • You have already granted a Charter to …

To see it in the menu

  • Government is Merchant
  • suzerain ?= scope:actor

Grant Merchant Charter is a diplomatic character interaction in Crusader Kings III. You need: Is an Independent Ruler, Highest held Title is at least Duchy Rank and Is not at war with the target. The AI weighs it. Reasons the AI weighs include Plans to abuse Charter (+40), Company Size relative to Patron Rank (+25) and Company Size relative to Patron Rank (-25). It costs Prestige (varies), 25 Gold. 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 Grant Merchant Charter in CK3?
You: Is an Independent Ruler, Highest held Title is at least Duchy Rank and Is not at war with the target. (patch 1.21.0)
How do I get the AI to accept Grant Merchant Charter?
The AI weighs it. Its reasons: Intimidated by you, Terrified of you, Plans to abuse Charter +40, 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 and Company Size relative to Patron Rank -25.
How much does Grant Merchant Charter cost?
Prestige (varies), 25 Gold (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+20
Their opinion of you × 0.25varies
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
Plans to abuse Charter
when
  • The character you target:
    • Ai honor less than 0
    • Ai greed more than 0
+40
Company Size relative to Patron Rank
when
  • root.highest_held_title_tier >= tier_kingdom
  • The character you target: Has the Aspiring Business Law
varies
Company Size relative to Patron Rank
when
varies
Company Size relative to Patron Rank
when
  • root.highest_held_title_tier >= tier_hegemony
  • The character you target: Has the Prominent Company Law
+25
Company Size relative to Patron Rank
when
  • root.highest_held_title_tier <= tier_kingdom
  • The character you target: Has the Trade Empire Law
varies
Company Size relative to Patron Rank
when
  • root.highest_held_title_tier <= tier_duchy
  • The character you target: Has the Prominent Company Law
-25
Acceptance (ai_accept) (104 lines of game script)
base = 20
opinion_modifier = {
	opinion_target = scope:actor
	who = scope:recipient
	multiplier = 0.25
}
modifier = {
	add = intimidated_external_reason_value
	scope:recipient = {
		has_dread_level_towards = {
			target = scope:actor
			level = 1
		}
	}
	desc = INTIMIDATED_REASON
}
modifier = {
	add = cowed_external_reason_value
	scope:recipient = {
		has_dread_level_towards = {
			target = scope:actor
			level = 2
		}
	}
	desc = COWED_REASON
}
modifier = {
	add = 40
	scope:recipient = {
		ai_honor < 0
		ai_greed > 0
	}
	desc = will_abuse_charter_reason
}
modifier = {
	scope:actor.highest_held_title_tier >= tier_kingdom
	scope:recipient = {
		has_realm_law = company_size_small
	}
	add = {
		value = 25
		if = {
			limit = {
				scope:actor.highest_held_title_tier >= tier_empire
			}
			add = 25
		}
		if = {
			limit = {
				scope:actor.highest_held_title_tier >= tier_hegemony
			}
			add = 25
		}
	}
	desc = COMPANY_TOO_SMALL_FOR_TIER_REASON
}
modifier = {
	scope:actor.highest_held_title_tier >= tier_empire
	scope:recipient = {
		has_realm_law = company_size_medium
	}
	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.highest_held_title_tier >= tier_hegemony
	scope:recipient = {
		has_realm_law = company_size_large
	}
	add = 25
	desc = COMPANY_TOO_SMALL_FOR_TIER_REASON
}
modifier = {
	scope:actor.highest_held_title_tier <= tier_kingdom
	scope:recipient = {
		has_realm_law = company_size_huge
	}
	add = {
		value = -25
		if = {
			limit = {
				scope:actor.highest_held_title_tier <= tier_duchy
			}
			add = -25
		}
	}
	desc = COMPANY_LARGE_FOR_TIER_REASON
}
modifier = {
	scope:actor.highest_held_title_tier <= tier_duchy
	scope:recipient = {
		has_realm_law = company_size_large
	}
	add = -25
	desc = COMPANY_LARGE_FOR_TIER_REASON
}

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

What happens

If they accept

  • The character you target:
    • 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
  • The character you target:

• 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) (9 lines of game script)
is_available = any_tributary = {
	government_has_flag = government_is_merchant
}
is_landed = yes
highest_held_title_tier > tier_barony
is_shown = scope:recipient = {
	government_has_flag = government_is_merchant
	suzerain ?= scope:actor
}

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

Can be sent when (is_valid…) (46 lines of game script)
scope:actor = {
	is_independent_ruler = yes
	highest_held_title_tier >= tier_duchy
	NOT = {
		is_at_war_with = scope:recipient
	}
}
scope:recipient = {
	trigger_if = {
		limit = {
			merchant_has_charter_from_patron_trigger = {
				EQUIPPED = no
				INCLUDE_FORGERIES = no
			}
		}
		custom_tooltip = {
			text = merchant_charter_grant_single_charter_same_tt
			always = no
		}
	}
	trigger_else = {
		scope:actor = {
			OR = {
				any_tributary = {
					merchant_has_charter_from_patron_trigger = {
						EQUIPPED = no
						INCLUDE_FORGERIES = no
					}
					save_temporary_scope_as = charter_holder_temp
				}
				always = yes
			}
			custom_tooltip = {
				text = merchant_charter_grant_single_charter_tt
				NOT = {
					any_tributary = {
						merchant_has_charter_from_patron_trigger = {
							EQUIPPED = no
							INCLUDE_FORGERIES = no
						}
					}
				}
			}
		}
	}
}

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

Effects (on_send, on_accept, on_decline) (73 lines of game script)
on_accept = scope:recipient = {
	create_merchant_charter_artifact_effect = {
		PATRON = scope:actor
		MERCHANT = scope:recipient
	}
	play_sound_effect = event:/DLC/EP5/SFX/Stingers/ep5_mx_sting_obtaining_charter
	hidden_effect = {
		send_interface_toast = {
			type = event_toast_effect_neutral
			title = merchant_charter_granted_title
			left_icon = scope:actor
			right_icon = scope:created_charter
			every_character_artifact = {
				limit = {
					var:charter_patron ?= scope:actor
					var:charter_house ?= scope:recipient.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:recipient
				}
			}
		}
	}
}
hidden_effect = {
	scope:actor = {
		send_interface_toast = {
			type = event_toast_effect_neutral
			title = merchant_charter_granted_title
			left_icon = scope:recipient
			right_icon = scope:created_charter
			show_as_tooltip = {
				scope:created_charter ?= {
					set_owner = scope:recipient
				}
			}
		}
	}
}
scope:recipient = {
	custom_tooltip = merchant_charter_unlocks_tt
	add_prestige = scope:actor.tier_scaled_prestige_value
	if = {
		limit = {
			has_opinion_modifier = {
				modifier = revoked_my_charter_opinion
				target = scope:actor
			}
		}
		hidden_effect = {
			remove_opinion = {
				modifier = revoked_my_charter_opinion
				target = scope:actor
			}
		}
	}
	if = {
		limit = {
			is_ai = yes
		}
		add_opinion = {
			modifier = granted_charter_opinion
			target = scope:actor
		}
	}
}

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

Category
Diplomatic actions
Cost: Prestige
varies
Cost: Gold
25
Again on the same character
after 10 years
In the menu
under More…
ID
grant_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?