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

Decision · Decisions

Entice Merchants

Invite Merchants to settle in your Capital, creating Trade Routes and offering their services as your Clients.

GoldvariesGoldCooldown 5 years

If goods are to flow into, out of, and across the realm, we must ensure a healthy environment for the business of merchants.

Requirements

  • Fewer than 5 Merchants have their Companies in your Capital
  • Also needed: available (an adult, not imprisoned, not incapable)

Who sees it

The decision only appears in the list for a character who meets these:

  • Is landed
Can be taken when (is_valid) (10 lines of game script)
custom_tooltip = {
	text = invite_merchants_decision_capital_full_tt
	gdp_capital_province_merchant_count_value < invite_merchants_max_capital_merchants_value
}
is_available_quick = {
	adult = yes
	at_war = no
	imprisoned = no
	incapable = no
}

As written in game/common/decisions/dlc_decisions/gdp/gdp_merchant_decisions.txt.

Shown to a character when (is_shown) (1 line of game script)
is_landed = yes

As written in game/common/decisions/dlc_decisions/gdp/gdp_merchant_decisions.txt.

Effects

Effect (181 lines of game script)
save_scope_as = new_patron
custom_tooltip = invite_merchants_decision_effect_1
custom_tooltip = {
	text = invite_merchants_decision_effect_2
	every_in_global_list = {
		variable = merchants_tally
		holder ?= {
			if = {
				limit = {
					scope:new_patron = {
						is_ai = no
					}
					government_has_flag = government_is_merchant
					exists = domicile
					exists = suzerain
					is_available_quick = {
						adult = yes
						at_war = no
						imprisoned = no
						incapable = no
					}
					NOR = {
						suzerain = scope:new_patron
						has_character_flag = entice_merchant_cooldown
						has_character_flag = entice_merchant_blocker
						has_character_flag = entice_merchant_invited
						has_character_flag = entice_merchant_permanent_refusal
						is_target_in_variable_list = {
							name = entice_merchant_cooldown
							target = scope:new_patron
						}
					}
					character_has_trade_monopoly = no
					NOT = {
						merchant_has_usable_charter_trigger = {
							ONLY_EQUIPPED = no
							INCLUDE_FORGERIES = no
						}
					}
					suzerain.highest_held_title_tier <= root.highest_held_title_tier
					NOT = {
						has_hook = suzerain
					}
					trigger_if = {
						limit = {
							is_ai = yes
						}
						suzerain = {
							is_ai = yes
						}
					}
					NOT = {
						is_allied_to = scope:new_patron
					}
					NOT = {
						has_any_good_relationship_with_character_trigger = {
							CHARACTER = scope:new_patron
						}
					}
				}
				if = {
					limit = {
						suzerain.top_liege ?= scope:new_patron.top_liege
					}
					add_to_temporary_list = same_realm_merchants
				}
				else_if = {
					limit = {
						in_diplomatic_range = scope:new_patron
					}
					add_to_temporary_list = nearby_merchants
				}
			}
		}
	}
	save_scope_value_as = {
		name = entice_merchant_budget
		value = {
			value = invite_merchants_max_capital_merchants_value
			subtract = gdp_capital_province_merchant_count_value
			max = invite_merchants_max_per_use_value
			min = 0
		}
	}
	save_scope_value_as = {
		name = max_moving_merchants
		value = {
			value = highest_held_title_tier
			subtract = 2
			min = 1
			multiply = 2
			max = scope:entice_merchant_budget
		}
	}
	save_scope_value_as = {
		name = moving_merchants
		value = {
			value = scope:max_moving_merchants
			divide = 2
			floor = yes
			min = 1
			max = scope:entice_merchant_budget
		}
	}
	ordered_in_list = {
		list = same_realm_merchants
		order_by = entice_merchants_order_value
		max = scope:moving_merchants
		check_range_bounds = no
		add_character_flag = {
			flag = entice_merchant_blocker
			months = 2
		}
		trigger_event = {
			id = gdp_decision.3000
			days = { 7 56 }
		}
		add_to_list = moving_merchants
	}
	save_scope_value_as = {
		name = nearby_moving_merchants
		value = {
			value = scope:entice_merchant_budget
			every_in_list = {
				list = moving_merchants
				subtract = 1
			}
			max = scope:moving_merchants
			min = 0
		}
	}
	ordered_in_list = {
		list = nearby_merchants
		order_by = entice_merchants_order_value
		max = scope:nearby_moving_merchants
		check_range_bounds = no
		add_character_flag = {
			flag = entice_merchant_blocker
			months = 2
		}
		trigger_event = {
			id = gdp_decision.3000
			days = { 7 56 }
		}
		add_to_list = moving_merchants
	}
	save_scope_value_as = {
		name = unused_entice_merchant_budget
		value = {
			value = scope:entice_merchant_budget
			every_in_list = {
				list = moving_merchants
				subtract = 1
			}
			min = 0
		}
	}
	save_scope_value_as = {
		name = remaining_moving_merchants
		value = {
			value = scope:max_moving_merchants
			subtract = scope:moving_merchants
			min = 0
			max = 2
			if = {
				limit = {
					scope:unused_entice_merchant_budget = scope:entice_merchant_budget
				}
				min = 1
			}
			max = scope:unused_entice_merchant_budget
		}
	}
	while = {
		count = scope:remaining_moving_merchants
		trigger_event = {
			id = gdp_decision.3001
			days = { 7 56 }
		}
	}
}

As written in game/common/decisions/dlc_decisions/gdp/gdp_merchant_decisions.txt.

• the game's own tooltip text · ◦ our reading of the script line · code the script where neither exists

Group
Decisions
Major
no
Cost: Gold
varies
Cooldown
5 years
ID
invite_merchants_decision

Costs that vary

Gold:

value = major_gold_value

Entice Merchants is a decision in Crusader Kings III (Decisions). It costs Gold (varies). Cooldown: 5 years. It needs fewer than 5 Merchants have their Companies in your Capital and available (an adult, not imprisoned, not incapable) (listed below). Patch 1.21.0, from game/common/decisions/dlc_decisions/gdp/gdp_merchant_decisions.txt.

for a guide, post or blog
Quick answers (3)
How much does Entice Merchants cost in CK3?
Gold (varies) (patch 1.21.0).
What are the requirements for Entice Merchants?
Fewer than 5 Merchants have their Companies in your Capital and available (an adult, not imprisoned, not incapable); the full conditions are on the page (patch 1.21.0).
How long is the cooldown of Entice Merchants?
5 years.

Source: game/common/decisions/dlc_decisions/gdp/gdp_merchant_decisions.txt and the English localisation, Crusader Kings III 1.21.0.

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