Creating custom CBs

[grisamentum]

I've been experimenting with making a few CBs of my own and had a little limited success but I've realized I don't really understand what some of the conditionals and triggers do.

Could someone explain, or direct me to where I can find out, what is the difference between:

can_use
can_use_title
is_valid
is_valid_title

Like, for example, the coastal_republic attack cb:

	can_use = {
		ROOT = {
			is_republic = yes
			capital_scope = {
				port = yes
			}
		}
	}

	can_use_title = {
		tier = COUNT
		location = {
			port = yes
		}
	}

	is_valid = {
		ROOT = {
			is_republic = yes
			capital_scope = {
				port = yes
			}
		}
	}

	is_valid_title = {
		tier = COUNT
		location = {
			port = yes
		}
	}

Seems very redundant. For example, it seems to me that it's saying:

can_use: Can be used by - republics, with their capital in a coastal county.
can_use_title: you have to have at least a county title from a coastal county? or that's what it targets?
is_valid: ?? The same as can_use? What's the difference here?
is_valid_title: Again, the same as can_use_title? What's the difference?

In both can_use and is_valid, it's talking about ROOT, which is the declarant of the war. So I'm not getting the difference there. Any help?

 

[grisamentum]

More specific question:

Why does this CB work against, say, the King of France, but not the HRE? (Take the 15/9/1066 start date; pick Hungary because it has Papal Investiture).

investiture_crisis = {
	name = CB_NAME_INVESTITURE_CRISIS
	war_name = WAR_NAME_INVESTITURE_CRISIS
	sprite = 9
	truce_days = 3650
	can_call_vassals = yes
	can_call_allies = yes
	can_ask_to_join_war = no
	is_permanent = yes

	can_use = {
		ROOT = {
			any_demesne_title = {
				OR = {
					tier = KING
					tier = EMPEROR
				}
        			has_law = investiture_law_0
    		}
		}
		FROM = {
			any_demesne_title = {
				OR = {
					tier = KING
					tier = EMPEROR
				}
				has_law = investiture_law_1
    		}
		}
	}
	
	is_valid_title = {
		FROM = {
			any_realm_title = {
				has_law = investiture_law_1	
			}
		}
	}

	on_success = {
		ROOT = {
			piety = 100
		}
		any_attacker = {
			limit = { character = ROOT }
			participation_scaled_piety = 200
		}
		any_attacker = {
			limit = { NOT = { character = ROOT } }
			hidden_tooltip = { participation_scaled_prestige = 200 }
		}
		FROM = {
			prestige = -200
		}
	}
	
	on_success_title = {
		FROM = {
			any_demesne_title = {
				limit = { OR = { tier = king tier = emperor } }
				add_law = investiture_law_0
			}
		}
	}

	on_fail = {
		FROM = {
			prestige = 100
		}
		any_defender = {
			limit = { character = FROM }
			participation_scaled_prestige = 100
		}
		any_defender = {
			limit = { NOT = { character = FROM } }
			hidden_tooltip = { participation_scaled_prestige = 100 }
		}
		ROOT = {
			prestige = -200
		}
	}

	on_reverse_demand = {
		ROOT = {
			prestige = -200
		}
		FROM = {
			prestige = 200
		}
		any_defender = {
			limit = { character = FROM }
			participation_scaled_prestige = 200
		}
		any_defender = {
			limit = { NOT = { character = FROM } }
			hidden_tooltip = { participation_scaled_prestige = 200 }
		}
	}

	attacker_ai_victory_worth = {
		factor = 200
	}
	
	attacker_ai_defeat_worth = {
		factor = 100
	}

	defender_ai_victory_worth = {
		factor = -1 # always accept
	}
	
	defender_ai_defeat_worth = {
		factor = 100
	}
}

As you can see, as Hungary, it'll correct be available against France (has free investiture) but won't work against the HRE (also has free investiture).

Why? Is the HRE not an "any_realm_title"?

 

[Fawr]

Could someone explain, or direct me to where I can find out, what is the difference between:
can_use
can_use_title
is_valid
is_valid_title

is_valid is talking about the person who can use that CB (the doge of venice for example has to be the head of a republic, and their captial has to be a port).

is_valid_title is talking about the county which you are fighting about (so you can declare war targeting the title of count of Barcelona but not targeting the title of count of Paris, and not King of France, duchy of Brittany or the HRE).

I assume can_use and can_use_title work the same sort of way.