Difference between revisions of "EU4 Converter modding"

From Crusader Kings II Wiki
Jump to navigation Jump to search
(Added file/folder tables to summarise use of files and folders (especially those not elaborated on further down))
(Structure)
Line 6: Line 6:
  
 
==Structure==
 
==Structure==
The main folder for the converter includes the following folders and files:
+
The <code>eu4_converter</code> folder includes the following folders and files:
 
{|class="wikitable"
 
{|class="wikitable"
!Folder name
+
!width = "20em"|Folder name
 
!contents/use
 
!contents/use
 
|-
 
|-
Line 21: Line 21:
 
|-
 
|-
 
|copy
 
|copy
|Any files placed in this folder will be copied directly into the generated mod, so can be used to statically define pretty much anything in the converted game.<br />For more information on what can be done and how see [[eu4:modding|EU4 modding]].
+
|Any files placed in this folder will be copied directly into the generated mod, so can be used to statically define pretty much anything in the converted game. For example, custom graphics, idea groups, map modifications, additional/modified localisation files, cultural province names, events and decisions could all be defined in here. For more information on what can be done and how see [[eu4:modding|EU4 modding]].
 
|-
 
|-
 
|fleet_names
 
|fleet_names

Revision as of 14:30, 11 January 2017

The Europa Universalis 4 Save Converter is a DLC that was released together with patch 1.11.

In order to modify it, you need to add a \eu4_converter\ folder to your mod, in which all files related to the EUIV converter should be stored. The vanilla files are inside DLC\dlc030.zip.

Modifying the converter does not change the checksum of the game.

Structure

The eu4_converter folder includes the following folders and files:

Folder name contents/use
army_names
centers_of_trade
common
copy Any files placed in this folder will be copied directly into the generated mod, so can be used to statically define pretty much anything in the converted game. For example, custom graphics, idea groups, map modifications, additional/modified localisation files, cultural province names, events and decisions could all be defined in here. For more information on what can be done and how see EU4 modding.
fleet_names
gfx
historical_idea_groups
historical_units
hordes
interface
ship_names
sons_of_abraham
sunset_invasion
File name Use
border_provinces.csv
color_table.csv Defines the color (in decimal RGB values) what a tag will use.
culture_gfx_table.csv Defines which CKII graphical cultures (see Culture modding and Portrait modding and Cultures § List of Cultures) convert to which EU4 graphical cultures (used mainly for advisor portraits and unit models).
culture_table.csv Maps CK2 cultures to EU4 cultures
defines.lua Defines some general settings the converter will use, such as which title to use for the HRE, what start date to use etc.
government_table.csv Defines which government types should be used by converted titles. May be defined on a per-title basis (e.g. papal_government for k_papal_state) or on a broader per-government type basis. This file is only used if conclave is active; otherwise conversion is automatic.
heresy_table_soa.csv Overrides entries in religion_table.csv when the Son's of Abraham DLC is enabled
key_provinces.csv
nation_table.csv Defines which CK2 titles will map to predefined EU4 tags (rather than auto-generated tags; custom tags may be added in copy\common\countries and copy\common\country_tags).
province_table.csv Defines which CK2 titles (counties and duchies) map to which EU4 provinces. Mappings may be weighted using multiple entries and titles can map to multiple provinces.
religion_table.csv Defines which CK2 religions map to which EU4 religions.
sunset_invasion_table.csv Defines which EU4 provinces belong to which tag when the Sunset Invasion DLC is enabled.
trait_conversion.csv
unit_type_table.csv

Files

culture_table.csv

culture_table.csv defines which Europa Universalis IV culture a Crusader Kings II culture converts to.

The format of the file is as follows:

CK2 culture;EU4 culture;Whether or not the culture is custom defined by the converter;Comment (optional)

Here are two examples:

norse;norse;1;Norse

In this case, norse is the name of the culture in Crusader Kings II (cultures are defined in the \common\cultures folder), norse is the culture the converter will map it to in Europa Universalis IV (as it is custom it is defined in the \eu4_converter\common\cultures folder), 1 implies that it is a custom culture from the converter, and Norse is the name of the culture in Europa Universalis IV.

swedish;swedish;0;Swedish

In this case, the swedish culture is already present in Europa Universalis IV, so the value is set to 0, and the converter will map it to the existant culture in Europa Universalis IV (cultures are defined in the common\cultures folder).

nation_table.csv

nation_table.txt defines which nation (or "tag") a title in Crusader Kings II will convert to in Europa Universalis IV.

The format of the file is as follows:

CK2 title;EU4 tag (nation);EU4 country file;Comment (optional)

For example:

e_scandinavia;SCA;Scandinavia;Scandinavia Empire

This tells the converter to convert the Crusader Kings II title e_scandinavia (the Empire of Scandinavia) into the Europa Universalis IV tag SCA (the formable nation of Scandinavia). The third parameter Scandinavia tells the converter which country file to use in Europa Universalis IV. The fourth parameter Scandinavia Empire is a comment designed to help coders and is optional. Note however that the ; divider is required.

Titles are defined in the Crusader Kings II folder common\landed_titles. Tags are defined in the Europa Universalis IV folder common\country_tags and a list of tags can be found at eu4:Countries in the "Country descriptions list" section at the bottom of the page. Country files are found in the Europa Universalis IV folder common\countries.

Any title not defined in this file will generate a new custom tag. This is not usually an issue but does preclude them from tag-specific events, decisions, ideas etc. It should also be noted that titles which are using a modified name when converted (either from their title history or because of their holder's culture) will not use the nation table so will also have automatically generated tags in Europa Universalis IV.

province_table.csv

province_table.csv defines which province in Europa Universalis IV a Crusader Kings II title converts to.

The file works based upon a point system, with the more "hits" in the province list the more likely the realm is to get the province in EU4. So if a county is listed twice it corresponds to two points, while a county that is listed once will have one point. That is the reason for why duchies are in the list, as it gives more weight to the one who owns the duchy for the conversion.[1]

The format of the file is as follows:

CK2 title ID;EU4 province ID;EU4 province ID - EU4 province name (filename);Comment (optional; typically CK2 title name - EU4 province name)

Here is an example:

c_vestisland;370;370 - Reykjavik;Vestisland - Reykjavik

In the example, c_vestisland is the title ID in Crusader Kings II (title IDs are defined in the \common\landed_titles folder), 370 is the province ID in Europa Universalis IV, while 370 - Reykjavik is the province ID and name in Europa Universalis IV (which is the filename in the \history\provinces folder) and Vestisland - Reykjavik are the title name in Crusader Kings II and province name in Europa Universalis IV.

Both duchy and province titles from Crusader Kings II can be defined, but in case there is both a duchy and a county for the same Europa Universalis IV province, the duchy needs to be specified, by adding Duchy before the Crusader Kings II title name.

Here is an example of that:

d_munster;375;375 - Munster;Duchy Munster - Munster
c_desmond;375;375 - Munster;Desmond - Munster

This is also the case if there is a duchy and a county with identical names, then both the duchy and the county need to be specified.

Here is an example of this case:

d_leinster;374;374 - Leinster;Duchy Leinster - Leinster
c_leinster;374;374 - Leinster;County Leinster - Leinster

religion_table.csv

religion_table.csv defines which Europa Universalis IV religion a Crusader Kings II religion converts to.

The format of the file is as follows:

CK2 religion;EU4 religion;Whether or not the religion is custom defined by the converter;Comment (optional)

Here are two examples:

finnish_pagan_reformed;finnish_pagan_reformed;1;Reformed Suomenusko

In this case, finnish_pagan_reformed is the name of the religion in Crusader Kings II (religions are defined in the \common\religions folder), finnish_pagan_reformed is the religion the converter will map it to in Europa Universalis IV (as it is custom it is defined in the \eu4_converter\copy\common\religions folder), 1 implies that it is a custom religion from the converter, and Reformed Suomenusko is the name of the religion in Europa Universalis IV.

catholic;catholic;0;Catholic

In this case, the catholic religion is already present in Europa Universalis IV, so the value is set to 0, and the converter will map it to the existant religion in Europa Universalis IV (religions are defined in the common\religions folder).