查看“EU4转档器模组制作”的源代码

{{version|2.6}}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 <code>eu4_converter</code> folder includes the following folders and files:
{|class="wikitable"
!style="width:15em"|Folder name
!Contents/use
|-
|army_names
|Contains definitions for [[eu4:Country creation#Army names|army names]] on a per-title basis. As of version [[Patch 2.6.X#Patch 2.6.3|2.6.3]] only contains definitions for the Roman Empire (<code>e_roman_empire</code>).
|-
|centers_of_trade
|
|-
|common
|Contains various base files which the converter uses to generate modified ones.
|-
|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|EU4 modding]].
|-
|fleet_names
|Contains definitions for [[eu4:Country creation#Fleet names|fleet names]] on a per-title basis. As of version [[Patch 2.6.X#Patch 2.6.3|2.6.3]] only contains definitions for the Roman Empire (<code>e_roman_empire</code>).
|-
|style="background-color:#e2f2e2;"|'''gfx'''
|By default contains two sub-folders: <code>flags</code> and <code>interface</code>
|-
|style="background-color:#e2f2e2;"|'''gfx'''\flags
|Contains custom flags. By default it contains a selection of alternative "flags"/coats of arms as used by pagans (in the sub-folder <code>norse_pagan</code>), since the converter cannot convert arms files to flag files. For example, the file <code>d_york</code> is used to provide the alternative "flag" file used by the Norse petty kingdom of Jorvik (rather than the standard "flag" used by the Duchy of York). For more information on how this type of "flag" is used in CK2, see [[Title modding#Pagan coats of arms|Title modding § Pagan coats of arms]].
|-
|style="background-color:#e2f2e2;"|'''gfx'''\interface
|
|-
|historical_idea_groups
|Contains definitions for [[eu4:Country creation#Historical idea groups|historical idea groups]] on a per-title basis.
|-
|historical_units
|Contains definitions for [[eu4:Country creation#Historical units|historical units]] on a per-title basis.
|-
|hordes
|Contains lists of provinces outside of the CK2 map held by particular horde titles. By default contains files for the Mongol Empire, Golden Horde, Ilkhanate and Timurids; as of version [[Patch 2.6.X#Patch 2.6.3|2.6.3]] only the Mongol Empire has any provinces defined.
|-
|interface
|Contains interface files defining converter-specific sprites, such as converted religion icons.
|-
|ship_names
|Contains definitions for [[eu4:Country creation#Ship names|ship names]] on a per-title basis.
|-
|sons_of_abraham
|Contains files specifically for use when the Sons of Abraham DLC is active
|-
|sunset_invasion
|Contains files specifically for use when the Sunset Invasion DLC is active
|}

{|class="wikitable"
!style="width:15em"|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 CK2 graphical cultures (see [[culture modding]], [[portrait modding]] and [[Cultures#List of Cultures|cultures § list of cultures]]) convert to which EU4 graphical cultures (used mainly for advisor portraits and unit models). 
|-
|[[#culture_table.csv|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. <code>papal_government</code> for <code>k_papal_state</code>) 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 <code>religion_table.csv</code> when the Son's of Abraham DLC is enabled
|-
|key_provinces.csv
|
|-
|[[#nation_table.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 <code>copy\common\countries</code> and <code>copy\common\country_tags</code>).
|-
|[[#province_table.csv|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|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.txt|trait_conversion.txt]]
|Defines which [[eu4:personalities|personality]] a leader will be assigned based on their CK2 traits.
|-
|unit_type_table.csv
|
|}

==Files==
===culture_table.csv===
<code>culture_table.csv</code> defines which Europa Universalis IV culture a Crusader Kings II culture converts to.

The format of the file is as follows:

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

Here are two examples:

<code>norse;norse;1;Norse</code>

In this case, ''norse'' is the name of the culture in Crusader Kings II (cultures are defined in the [[Culture modding|\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.

<code>swedish;swedish;0;Swedish</code>

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===
<code>nation_table.txt</code> 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:

<code>CK2 title;EU4 tag (nation);EU4 country file;Comment (optional)</code>

For example:

<code>e_scandinavia;SCA;Scandinavia;Scandinavia Empire</code>

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

Titles are defined in the Crusader Kings II folder <code>common\landed_titles</code>. Tags are defined in the Europa Universalis IV folder <code>common\country_tags</code> 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 <code>common\countries</code>.

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===
<code>province_table.csv</code> 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.<ref>[[forum:972157|Reply by Darkrenown in CK2 Dev Diary#26: Considerable Converter Capabilities]]</ref>

The format of the file is as follows:

<code>CK2 title ID;EU4 province ID;EU4 province ID - EU4 province name (filename);Comment (optional; typically CK2 title name - EU4 province name)</code>

Here is an example:

<code>c_vestisland;370;370 - Reykjavik;Vestisland - Reykjavik</code>

In the example, ''c_vestisland'' is the title ID in Crusader Kings II (title IDs are defined in the [[Title modding|\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:

 <nowiki>d_munster;375;375 - Munster;Duchy Munster - Munster
c_desmond;375;375 - Munster;Desmond - Munster</nowiki>

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:

 <nowiki>d_leinster;374;374 - Leinster;Duchy Leinster - Leinster
c_leinster;374;374 - Leinster;County Leinster - Leinster</nowiki>

===religion_table.csv===
<code>religion_table.csv</code> defines which Europa Universalis IV religion a Crusader Kings II religion converts to.

The format of the file is as follows:

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

Here are two examples:

<code>finnish_pagan_reformed;finnish_pagan_reformed;1;Reformed Suomenusko</code>

In this case, ''finnish_pagan_reformed'' is the name of the religion in Crusader Kings II (religions are defined in the [[Religion modding|\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.

<code>catholic;catholic;0;Catholic</code>

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). 

===trait_conversion.txt===
<code>trait_conversion.txt</code> defines which [[eu4:personalities|personality]] a leader will be assigned based on their CK2 [[traits]].

The format of the file is as follows:
 <nowiki>eu4trait = {
	name = <personality name>
	weight = {
		factor = X
		<modifiers>
	}
}</nowiki>

<code><modifiers></code> is a list of modifiers which modify the weight of the personality type (i.e. how likely it is to be picked). They may be additive (<code>additive_modifier</code>) or multiplicative (<code>modifier</code>).

For example:
 <nowiki>eu4trait = {
	name = calm_personality
	weight = {
		factor = 0
		additive_modifier = {
			value = 1
			trait = brooding
		}
		additive_modifier = {
			value = 3
			trait = patient
		}
		additive_modifier = {
			value = 2
			trait = shy
		}
		additive_modifier = {
			value = 1
			trait = content
		}
		modifier = {
			factor = 0
			trait = wroth
		}
	}
}</nowiki>

This tells the converter that a ruler with the <code>patient</code> trait will have a weight of 3 '''added''' to the <code>calm_personality</code> type, while a ruler with the <code>wroth</code> trait will have their weight for that type '''multiplied''' by 0 (i.e. the weight will ''be'' 0, since any number × 0 = 0).

==References==
<references/>

[[Category:Modding]]
{{ModdingNavbox}}