Conversion of Imperator Defensive Leagues + compatches for TFE and RoA (#2631)

### CHANGES
- Finished game_start effect that sets up converted Imperator Defensive
Leagues. (Closes #2591)
- I decided to not add the Confederation/Defensive League split stuff
directly into the converter because it ended up requiring quite a bit of
changes that could be annoying to update whenever something needs to be
added or changed. Because it is something that can be used without the
converter too, I kept it as a separate mod that I uploaded to the Steam
Workshop called "Confederations & Leagues".
- I modified the welcome event that gets triggered at game start for
players (that normally notifies them of the game rules added by the
converter), and added a section to explain any/all mods that end up
being designed to work alongside the converter, so players can know that
the mod exists, and what it does.
- I setup the game_start effect so that if it detects that the
"Confederations & Leagues" mod is loaded (through a global variable), it
will properly setup the converted Defensive Leagues according to how the
mod allows them to be setup. If it detects that you are playing without
the mod, then it will only setup the converted Defensive Leagues that
can properly be setup in base game CK3 (meaning only Tribes/Nomads below
kingdom-tier can get in).

- Made a global variable (`irtock3_enabled`) get set at game start that
indicates that the converter was used (and you are currently using a
converted save game), so that if any mod in the future wants/needs to
consider whether you are playing a converted Imperator game, they can
easily check that variable.

- Updated the files for the new TFE update (didn't add anything new
aside from just making sure there were no replaceable/removable code
errors) (Closes #2639)


### UPDATE (June 20)
- Updated for RoA Version 4.0.0 (mainly just made sure there were no big
errors when converting, haven't added much of their new content yet)

- RoA changed how it handles the CCU parameter to be similar to how
WtWSMS handles it, so the relevant code files were modified to account
for that change.

- Converter heritage and language files were modified to account for RoA
CCU change, as well as change some of the parameters given to some of
the heritages/languages by the mods so they make a little more sense.

- Merged the Venetic heritage and language file into the main
IRToCK3_heritage/language files to simplify things.

- Made Basque have Equal Inheritance instead of Visigothic Codes in
vanilla CK3 and RoA (TFE and WtWSMS make their own edits)

- Renamed zzz_IRToCK3_tfe_override_l_english.yml.liquid to
zzz_IRToCK3_mod_override_l_english.yml.liquid and added a section for
ROA.

- Made Talaiotic map to Nuragic, since they were expected to be closer
to them than the Basque.

- Added a mapping to ROA's new Nenets culture in the proper out-of-scope
region of CK3

- Added a mapping for the romano_hellenic and helleno_roman cultures
from the Imperator "Terra Europea - Terra Indomita Sub-Mod" to greek
since they represent a kind of Roman-Hellenic hybrid culture in
Imperator

- Redid the province mappings for RoA since they changed their map a
bit. Might need to be reworked later, but should be fine for now. (Since
the converter can now convert wasteland provinces to whoever owns most
of the land surrounding them, I left quite a bit of the wasteland
province mappings the provinceMapper made)

- Redid the imperator_invictus mappings, removing the mapped provinces
from Subsaharan Africa so they don't all end up Berber/Megalithic.


### UPDATE (June 21)
- Moved 00_mongol_invasion_effects.txt edit from the TFE versions of
replaceable/removable_file_blocks to vanilla version of files.

- Modified become_chakravarti_decision and unite_india_decision_effect
so that they can only be taken if e_india has no holder or de jure land,
and instead of requiring the three normal Indian Empire titles, it
instead requires you to control the entire world_india region (pretty
much the same thing as what it required before), and it de jure drifts
the kingdoms of all empires that are 80% inside that india region.
(Closes #2596)

- Changed title mappings so that BHA maps to e_india instead of MRY.
e_india and BHA both represent a united India title/tag in their
respective games, so it makes more sense to have those mapped together.

- Made HIB map to k_ireland instead of IVE since HIB actually represents
a united Ireland.

- Updated some of the replaceable/removable_file_blocks for ROA and TFE.

---------

Co-authored-by: iht <[email protected]>

Author: tanner918

ImperatorToCK3.UnitTests/Imperator/Diplomacy/DiplomacyDBTests.cs

@@ -99,4 +99,21 @@ public void DependencyCanBeLoaded() {
 		Assert.Equal(new Date("1.1.1", AUC: true), diplomacy.Dependencies[0].StartDate);
 		Assert.Equal("tributary", diplomacy.Dependencies[0].SubjectType);
 	}
+
+	[Fact]
+	public void DefensiveLeagueCanBeLoaded() {
+		var reader = new BufferedReader(
+			"""
+			defensive_league={
+				member=7
+				member=552
+			}
+			""");
+		var diplomacy = new ImperatorToCK3.Imperator.Diplomacy.DiplomacyDB(reader);
+
+		Assert.Single(diplomacy.DefensiveLeagues);
+		Assert.Equal(2, diplomacy.DefensiveLeagues[0].Count);
+		Assert.Equal((ulong)7, diplomacy.DefensiveLeagues[0][0]);
+		Assert.Equal((ulong)552, diplomacy.DefensiveLeagues[0][1]);
+	}
 }

ImperatorToCK3/CK3/Cultures/PillarCollection.cs

@@ -93,12 +93,12 @@ private void LoadPillar(string pillarId, BufferedReader pillarReader, OrderedDic
 					Logger.Warn($"Language {pillarId} is missing required language_family parameter!");
 				}
 			}
-			if (ck3ModFlags["wtwsms"]) {
+			if (ck3ModFlags["wtwsms"] || ck3ModFlags["roa"]) {
 				if (!pillar.Parameters.AsValueEnumerable().Any(p => p.Key.StartsWith("language_branch_"))) {
 					Logger.Warn($"Language {pillarId} is missing required language_branch parameter!");
 				}
 			}
-			if (ck3ModFlags["tfe"] || ck3ModFlags["roa"]) {
+			if (ck3ModFlags["tfe"]) {
 				if (!pillar.Parameters.AsValueEnumerable().Any(p => p.Key.StartsWith("language_group_"))) {
 					Logger.Warn($"Language {pillarId} is missing required language_group parameter!");
 				}

ImperatorToCK3/CK3/Diplomacy/DiplomacyDB.cs

@@ -0,0 +1,37 @@
+using commonItems;
+using ImperatorToCK3.CK3.Titles;
+using ImperatorToCK3.Imperator.Countries;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace ImperatorToCK3.CK3.Diplomacy;
+
+internal class DiplomacyDB {
+	public List<List<Title>> Leagues { get; } = [];
+
+	public void ImportImperatorLeagues(IReadOnlyCollection<List<ulong>> irLeagues, CountryCollection countries) {
+		Logger.Info("Importing Imperator defensive leagues...");
+
+		foreach (var irLeague in irLeagues) {
+			List<Title> ck3LeagueMembers = [];
+			foreach (var irMemberId in irLeague) {
+				if (!countries.TryGetValue(irMemberId, out var country)) {
+					Logger.Warn($"Member {irMemberId} of defensive league not found in countries!");
+					continue;
+				}
+
+				var ck3Title = country.CK3Title;
+				if (ck3Title is not null) {
+					ck3LeagueMembers.Add(ck3Title);
+				}
+			}
+
+			if (ck3LeagueMembers.Count < 2) {
+				Logger.Notice("Not enough members in league to import it, skipping: " +
+				             $"{string.Join(", ", ck3LeagueMembers.Select(t => t.Id))}");
+				continue;
+			}
+			Leagues.Add(ck3LeagueMembers);
+		}
+	}
+}

ImperatorToCK3/CK3/World.cs

@@ -5,6 +5,7 @@
 using ImperatorToCK3.CK3.Armies;
 using ImperatorToCK3.CK3.Characters;
 using ImperatorToCK3.CK3.Cultures;
+using ImperatorToCK3.CK3.Diplomacy;
 using ImperatorToCK3.CK3.Dynasties;
 using ImperatorToCK3.CK3.Legends;
 using ImperatorToCK3.CK3.Provinces;
@@ -38,6 +39,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using Open.Collections;
+using DiplomacyDB = ImperatorToCK3.CK3.Diplomacy.DiplomacyDB;
 using System.Collections.Frozen;
 
 namespace ImperatorToCK3.CK3;
@@ -60,6 +62,7 @@ internal sealed class World {
 	public MapData MapData { get; private set; } = null!;
 	public List<Wars.War> Wars { get; } = [];
 	public LegendSeedCollection LegendSeeds { get; } = [];
+	public DiplomacyDB Diplomacy { get; } = new();
 	internal CoaMapper CK3CoaMapper { get; private set; } = null!;
 	private readonly List<string> enabledDlcFlags = [];
 
@@ -408,6 +411,10 @@ public World(Imperator.World impWorld, Configuration config, Thread? irCoaExtrac
 			() => {
 				LegendSeeds.LoadSeeds(ModFS);
 				LegendSeeds.RemoveAnachronisticSeeds("configurables/legend_seeds_to_remove.txt");
+			},
+
+			() => {
+				Diplomacy.ImportImperatorLeagues(impWorld.DefensiveLeagues, impWorld.Countries);
 			}
 		);
 	}

ImperatorToCK3/Data_Files/blankMod/output/common/on_action/IRToCK3_titles_game_start.txt

@@ -3,6 +3,7 @@ on_game_start = {
 	on_actions = {
 		IRToCK3_create_admin_noble_families
 		IRToCK3_fix_roman_empire_name
+		IRToCK3_initial_variables
 	}
 }
 
@@ -723,4 +724,11 @@ IRToCK3_gamestart_events = {
 			trigger_event = welcome.1 # This event so far just notifies the players of the game rules added by the converter
 		}
 	}
+}
+
+# This just sets up a global variable that could be checked by any theoretical mod that wants to consider whether the converter was used
+IRToCK3_initial_variables = {
+	effect = {
+		set_global_variable = irtock3_enabled
+	}
 }

ImperatorToCK3/Data_Files/blankMod/output/common/scripted_effects/irtock3_scripted_effects.txt

@@ -0,0 +1,233 @@
+## This handles setting up the defensive leagues converted from Imperator
+# Inputs:
+# list = irtock3_confederation_members - A list containing all of the members of the specific Imperator Defensive League
+irtock3_confederation_setup_effect = {
+	if = { # Check if the Confederations & Leagues mod is loaded, allowing more than Nomads/Tribes into confederations
+		limit = { has_global_variable = confed_league_enabled }
+
+		if = {
+			limit = { # Need to make sure that there are enough members in the Imperator Defensive League of appropriate rank. Confederations & Leagues might be modified to allow smaller kingdoms into Confederations/Leagues (likely as a game rule), so when that is done, this will likely get modified to account for that.
+				any_in_list = {
+					list = irtock3_confederation_members
+					count > 1
+					CL_has_appropriate_title_tier = yes
+				}
+			}
+
+			# Remove rulers who can't be in a confederation/league because of title rank or government, so they aren't added later or considered for anything else later on
+			every_in_list = {
+				limit = {
+					OR = {
+						CL_has_appropriate_title_tier = no
+						AND = {
+							CL_uses_confederations = no
+							CL_uses_leagues = no
+						}
+					}
+				}
+				list = irtock3_confederation_members
+				remove_from_list = irtock3_confederation_members
+			}
+
+			## Need to determine whether this specific Imperator Defensive League will convert to a Confederation or a League, so check the government of every member, and count how many should be in confederations and how many should be in leagues
+			set_global_variable = {
+				name = confed_num
+				value = 0
+			}
+			set_global_variable = {
+				name = league_num
+				value = 0
+			}
+			every_in_list = {
+				list = irtock3_confederation_members
+
+				if = {
+					limit = { CL_uses_confederations = yes }
+					change_global_variable = {
+						name = confed_num
+						add = 1
+					}
+				}
+				else_if = {
+					limit = { CL_uses_leagues = yes }
+					change_global_variable = {
+						name = league_num
+						add = 1
+					}
+				}
+			}
+
+			# Now need to get relevant rulers to be used to determine the name of the confederation/league. For now, will just take the two with the largest military strength
+			if = {
+				limit = { global_var:league_num >= global_var:confed_num } # This should imply they should be in a Defensive League
+
+				# Get first member, for the 'actor' scope
+				ordered_in_list = {
+					limit = { CL_uses_leagues = yes }
+					alternative_limit = { always = yes } # Incase somehow this was chosen and no one is actually capable of using leagues, need to make sure someone is chosen
+					list = irtock3_confederation_members
+					order_by = max_military_strength
+					save_scope_as = actor
+					save_scope_as = confederation_offerer
+				}
+				# Get second member, for the 'recipient' scope
+				ordered_in_list = {
+					limit = {
+						CL_uses_leagues = yes
+						NOT = { this = scope:actor }
+					}
+					alternative_limit = { # Incase somehow this was chosen and no one is actually capable of using leagues, need to make sure someone is chosen
+						NOT = { this = scope:actor }
+					}
+					list = irtock3_confederation_members
+					order_by = max_military_strength
+					save_scope_as = recipient
+					save_scope_as = confederation_accepter
+				}
+
+				# When an Imperator Defensive League is converted, its members will always be allowed into the confederation/league, regardless of government, so need to give them a variable that signifies they should be allowed in
+				every_in_list = {
+					limit = { CL_uses_leagues = no }
+					list = irtock3_confederation_members
+					set_variable = allowed_in_leagues
+				}
+			}
+			else = { # Otherwise, they will be put into a confederation
+				# Get first member, for the 'actor' scope
+				ordered_in_list = {
+					limit = { CL_uses_confederations = yes }
+					alternative_limit = { always = yes } # Incase somehow this was chosen an no one is actually capable of using confederations, need to make sure someone is chosen
+					list = irtock3_confederation_members
+					order_by = max_military_strength
+					save_scope_as = actor
+					save_scope_as = confederation_offerer
+				}
+				# Get second member, for the 'recipient' scope
+				ordered_in_list = {
+					limit = {
+						CL_uses_confederations = yes
+						NOT = { this = scope:actor }
+					}
+					alternative_limit = { # Incase somehow this was chosen an no one is actually capable of using confederations, need to make sure someone is chosen
+						NOT = { this = scope:actor }
+					}
+					list = irtock3_confederation_members
+					order_by = max_military_strength
+					save_scope_as = recipient
+					save_scope_as = confederation_accepter
+				}
+
+				# When an Imperator Defensive League is converted, its members will always be allowed into the confederation/league, regardless of government (as long as they meet the rank requirements), so need to give them a variable that signifies they should be allowed in
+				every_in_list = {
+					limit = { CL_uses_confederations = no }
+					list = irtock3_confederation_members
+					set_variable = allowed_in_confederations
+				}
+			}
+
+			# Trigger the event that will create the confederation/league and have both scope:actor and scope:recipient added to it
+			scope:actor = {
+				#Event distributor event
+				trigger_event = mpo_interactions_events.0001
+			}
+
+			# Add other Defensive League members
+			every_in_list = {
+				limit = { is_confederation_member = no }
+				list = irtock3_confederation_members
+				save_scope_as = new_member
+				scope:actor.confederation = { add_confederation_member = scope:new_member }
+				clear_saved_scope = new_member
+			}
+
+			# Cleanup so it doesn't cause any issues when converting multiple Defensive Leagues from Imperator
+			remove_global_variable = league_num
+			remove_global_variable = confed_num
+			clear_saved_scope = actor
+			clear_saved_scope = confederation_offerer
+			clear_saved_scope = recipient
+			clear_saved_scope = confederation_accepter
+			clear_saved_scope = new_confederation
+		}
+	}
+	# Otherwise, assume just using base game confederations, meaning only Nomads/Tribes should be allowed in
+	else = {
+		if = {
+			limit = { # Need to make sure that there are enough members in the Imperator Defensive League of appropriate rank and government for base game confederations
+				any_in_list = {
+					list = irtock3_confederation_members
+					count > 1
+					AND = {
+						highest_held_title_tier < tier_kingdom
+						OR = {
+							has_government = nomad_government
+							has_government = tribal_government
+						}
+					}
+				}
+			}
+
+			# Remove rulers who can't be in a confederation because of title rank or government, so they aren't added later on
+			every_in_list = {
+				limit = {
+					OR = {
+						highest_held_title_tier >= tier_kingdom
+						NOR = {
+							has_government = nomad_government
+							has_government = tribal_government
+						}
+					}
+				}
+				list = irtock3_confederation_members
+				remove_from_list = irtock3_confederation_members
+			}
+
+			## Now need to get relevant rulers to be used to determine the name of the confederation. For now, will just take the two with the largest military strength
+			# Get first member, for the 'actor' scope
+			ordered_in_list = {
+				list = irtock3_confederation_members
+				order_by = max_military_strength
+				save_scope_as = actor
+				save_scope_as = confederation_offerer
+			}
+			# Get second member, for the 'recipient' scope
+			ordered_in_list = {
+				limit = {
+					NOT = { this = scope:actor }
+				}
+				list = irtock3_confederation_members
+				order_by = max_military_strength
+				save_scope_as = recipient
+				save_scope_as = confederation_accepter
+			}
+
+			# Trigger the event that will create the confederation and have both scope:actor and scope:recipient added to it
+			scope:actor = {
+				#Event distributor event
+				trigger_event = mpo_interactions_events.0001
+			}
+
+			# Add other Defensive League members
+			every_in_list = {
+				limit = { is_confederation_member = no }
+				list = irtock3_confederation_members
+				save_scope_as = new_member
+				scope:actor.confederation = { add_confederation_member = scope:new_member }
+				clear_saved_scope = new_member
+			}
+
+			# Cleanup so it doesn't cause any issues when converting multiple Defensive Leagues from Imperator
+			clear_saved_scope = actor
+			clear_saved_scope = confederation_offerer
+			clear_saved_scope = recipient
+			clear_saved_scope = confederation_accepter
+			clear_saved_scope = new_confederation
+		}
+	}
+
+	# Empty the list of members so there are no conflicts when converting multiple Imperator Defensive Leagues
+	every_in_list = {
+		list = irtock3_confederation_members
+		remove_from_list = irtock3_confederation_members
+	}
+}