Europa Universalis IV to Victoria II Converter

From Europa Universalis 4 Wiki
Jump to navigation Jump to search
Game modification: Europa Universalis IV to Victoria II Converter
Europa Universalis IV to Victoria II Converter


Compatible with EUIV v1.30

Steam workshop

The EU4 to Vic2 converter is a tool that converts a Europa Universalis 4 save and generates a Victoria 2 scenario (mod) from it. It can be downloaded from this forum thread or from Steam.
It is compatible with Ck2 converted savegames, as well as with Vic2 to HoI4 converter, allowing the player to play a continuous megacampaign from CK2 to HoI4.

Features and Conversion Mechanics[edit]

Here is a general list of Converter capabilities and conversion mechanic explanations. For more information feel free to ask for clarifications on forums or take a peek at the code.
Note: The converter includes a configurables/ folder that contains all data files with rules it uses during conversion. These files are there for a reason - so the user can view them and modify them according to specific needs. Do not be shy to hack away and change them so the conversion fits expected goals.


  • Victoria 2 with both expansions is required.
  • EU4, with or without any expansions or DLCs, versions 1.0-1.30 are supported.

Incoming Savegames[edit]

  • Converter supports compressed save games.
  • Ironman saves are supported.
  • Random New World saves are not supported.

Outgoing Mod[edit]

  • Converter will produce a Victoria 2 mod.
  • On Windows, and using the front-end, the mod will be copied to Vic2 installation mod/ directory.
  • Without front-end (running the converter manually) or on other OS-es, mod will be exported to converter's output/ folder, and will have to be moved by user.


  • Converted mod supports 2 bookmarks: 1836 and the conversion date.
  • Conversion-date bookmarks can be quite early, chaining converters from CK2 onward, one can play a 769 game in Vic2 engine, though aside for the novelty that is a horrible idea.
  • Converting earlier than 1836 will cause penalties in global literacy levels, so where a country would normally have 60% literacy in 1836, converting in 1000 will see its literacy slashed to 6%.
  • Any date post 1815 is generally a solid point for a meaningful Vic2 game, as the first technologies unlock at 1815, and first political parties at 1830.


  • Cultures are converted according to culture_map.txt. Feel free to edit the file if unhappy with results.
  • Cultures change. New world will always cause non-native cultures to diverge into "neo-cultures".
  • Neocultures are either defined in culture_map.txt (english in northern USA become Yankee), or are dynamically generated (nubian in Brazil become Nubian South American).
  • Neocultures belong to their original culture's cultural group.

Primary and Accepted Cultures[edit]

  • Depending on where the capital is, if the primary culture has changed to a neoculture, it will be updated.
  • Accepted cultures coming from EU4 are completely ignored.
  • Accepted cultures are generated by doing a census among country's full/stated EU4 cores. Territories/Trade Company regions are ignored.
  • A culture in the same cultural group as primary culture, holding 15%+ population in cored provinces will become an accepted culture.
  • A culture in a different cultural group than primary culture, holding 20%+ population in cored provinces will become an accepted culture.


  • Religions are updated according to religion_map.txt. Feel free to edit the file if unhappy with results.
  • As religion plays little role in Vic2, there are no special mechanics regarding it.

Government Type[edit]

  • Government conversion is defined in government_mapping.txt
  • EU4 government reforms (with Dharma) can impact government conversion, according to reform_effects.txt. For example a republic with peasants_republic reform will in fact convert as proletarian_dictatorship.
  • Feel free to consult these files for specific conversion effects, both for reforms and for source governments.


  • Starting reforms are determined from 3 sources: government type - idea_effects.txt, government reforms (with Dharma) - reform_effects.txt, and EU4 idea groups completed - idea_effects.txt.
  • All three parts have equal weight. Files referenced give a scale of 0 to 10 describing how a particular idea or reform or government form affects different Vic2 reforms, literacy, upper house composition, technology and national values.
  • Any reform or idea with weight of 5 (or without an effect listed) will have no effect on that reform aspect. For example industry = 5 will not affect industry tech.
  • Currently we do not support the popular Governments Expanded EU4 mod which brings hundreds of new government reforms, so those reforms will have no effect on the conversion process.


  • Literacy is calculated through several factors: base literacy, reform effects, westernization status, configuration cap and configuration eurocentrism.
Base Literacy[edit]
  • Base literacy is 40%. Protestant, anglican, confucian or reformed religions add additional 10%.
  • Sunday schools, monastic education, western embassy, education act or school establishment act all add a cumulative %5 to base literacy.
  • Having up to 10% provinces with Universities will give up to 10% bonus base literacy.
  • For older games, Military Colleges do the same but up to 5% bonus base literacy.
  • Base literacy is directly modified by government type, government reforms and idea groups finished (see above under reforms).
  • For every point of divergence above or below 5, literacy is adjusted by 10%.
  • Literacy is directly modified by westernization progress.
  • Civilized countries apply no penalty to literacy.
  • A country with westernization at 50% will have base literacy halved.
Configuration Cap[edit]
  • Literacy is capped at a value defined in configuration.
  • The default is 1, so no cap is applied.
  • Different tech groups in eu4 have different westernization values in tech_groups.txt.
  • If Eurocentrism is enabled, this file will affect literacy through both westernization values (see above) and through literacy modifiers directly, as defined in the file.
  • By altering this file it is possible to produce any type of scenario one desires.
  • Countries matching tech groups at westernization=10 in tech_groups.txt can never become primitive/uncivilized, no matter how far behind tech they are at time of conversion.


  • Starting technology is determine by looking at technological levels (adm/dip/mil) at conversion date and institutions embraced.
  • Be aware that for any game converted at 1821 or later virtually entire world will be at max tech and max institutions, so these values become meaningless.
  • At this point, converter looks at government, ideas and reforms (see above in reforms), to determine how these affect technology levels.
  • Again, look at idea_effects.txt and reform_effects.txt for a direct list of technological effects and alter it to suit your needs.
  • Once the effects are applied, all civilized countries are sorted by each of the 5 scores, and distributed linearly on a scale of -1 to 1 (for every of the 5 vic2 tech groups).
  • Converter then looks at starting_technologies.txt, compares that country's score, and assigns all techs at or below the country's score.
  • Since, for example, flintlock_rifles are at -1.0 in army scores, every civilized country will receive it, but only the most advanced country will receive army_professionalism
  • Feel free to modify starting_technologies.txt to fit your needs.

Cores, States, Territories and Colonies[edit]

  • Colonies in progress at the date of conversion convert as colonies in Victoria 2, and may be converted into territories if the Country has sufficient colonization points.
  • EU4 states and territories are almost completely, but not entirely ignored (see accepted culture determination above).


  • Those provinces that hold a majority of primary or accepted culture, will become cores.
  • If national cores are enabled in configurations, all provinces holding a majority of a particular culture will receive a core of that culture's nation, as defined in nationals.txt.
  • If cultural union cores are enabled, all provinces holding a majority of a particular culture will receive a core of that culture group's cultural union nation, as defined in unions.txt.

States and Territories[edit]

  • If a state contains provinces with the owner's cores, it will become a state.
  • If the state contains unaccepted culture pops that are civilized (based on that culture's westernization level), they will also become states.
  • Otherwise, it will become a territory.
  • Uncivilized countries convert all their provinces as states.

If using default configuration files this means Europe (with the exception of Crimea and surrounding lands) will convert as states for whomever holds the provinces. New world provinces will either be territories or states depending on pop composition (if majority is native, they will likely become territories if owned by civilized countries).

Armies and Navies[edit]

  • EU4 armies are converted into Vic2 armies through two mechanisms - manpower value and pip-to-guns conversion.
  • Vic2 regiments hold 3000 soldiers, while EU4 regiments hold 1000 soldiers. Where approximate power ratio is 1:1, expect to have one third of EU4 regiments deployed.
  • For older units (countries with lower tech or earlier conversion date), converter is using regiment_costs.txt, that defined how many pips are required for one Vic2 regiment
  • For very early conversions, where units have but a few pips, having no regiments post conversion is quite possible.
  • Navies follow a similar model, with an exception of transports that will always convert at an identical ratio.


  • Wars are converted according to war_goal_map.txt.
  • This file defines different war goals (not all eu4 CBs have equivalent Vic2 ones!)
  • Primary belligerents are imported as well as all supporting allies.
  • since this feature is rather new and not sufficiently tested, please report back any issues.

Diplomacy, Spherelings, Puppets and Personal Unions[edit]

  • Diplomacy is converted as defined in agreement_types.txt.
  • Alliances are converted ad verbatim.
  • A GP will start with all its puppets as spherelings.
  • Tributaries will not become puppets but will become spherelings with military access enabled.
  • Royal marriages increase relations between two countries.
  • Regular vassals, marches, client states, client marches, daimyos (if not integrated through Japanese unification), personal unions and all other dependencies convert as puppet states.
  • We do not convert EU4 personal unions into Vic2 personal unions such since the only different between a PU in vic2, and a vassal in Vic2 is that a PU has a preset end date, at which point the vassal is released.
  • GPs look at their general relations across all relevant countries (guarantees, marriages etc) and if they have sufficient influence, the relations are automatically improved (Neutral->Cordial->Friendly).
  • Converter will not sphere countries automatically, even if influence is at 100 and relations are Friendly, as this is a player's decision to make.

Consciousness and Militancy[edit]

  • Starting Consciousness for primary and accepted cultures is a direct function of EU4's Legitimacy (or republican tradition or equivalents) and Stability.
  • The lower legitimacy/stability, the higher starting Consciousness.
  • For colonial pops (any non-accepted culture) consciousness is a function of primary population's consciousness and average autonomy - the closer average autonomy is to 100%, the clover non-state consciousness will be to state consciousness.


  • Factories available at start are defined in starting_factories.txt.
  • Converter will score every country according to it's tech levels and the number of built manufactories, as proportional to its size.
  • Coal furnaces count as 3 manufactories for this purpose.
  • Once all countries are scored, top 15 countries will take turns to spend their "industrial score" by purchasing factories from the list (defined in the file), according to their RGOs and available technologies.
  • Since every country will only have so many points, increasing the number of starting factories will not have full impact unless the world is full with many powerful civilized countries with a large score.


  • Generally, EU4 buildings contribute to province weights when determining population shaping, and industrial score. There are a few exceptions:
  • Level 8 forts will be transformed into level 1 Vic2 forts.
  • Every Grand Shipyard or Drydock in a state will increase that state's naval base by 1, up to a maximum of 2.
  • It is not necessary to have the Grand Shipyard and the Drydock in the same EU4 province, they are summed up on a state level.
  • Railroads are not imported nor built.

Population Shaping[edit]

  • Population shaping is an optional but relevant function of the converter.
  • When disabled all provinces will have identical number of pops as vanilla, though their culture, religion and distribution will be different.
  • With dev-push option, factors such as development investments, life rating, constructed buildings and similar will determine approx. increase (or decrease for a lack of those investments). Very generally speaking, 1 dev point increase in EU4 province will translate into 1% population increase in related Vic2 province, as compared to vanilla Vic2 population size of that Vic2 province.
  • Extreme reshaping option is useful for special scenarios where historical distribution is harmful, such as multiplayer games, flat-dev games and similar. All of the world's population will be redistributed according to absolute development size of eu4 provinces, so a province with 50 development will have 10x as much population as a province with 5 development.
  • When either reshaping is enabled, the configuration's shaping factor will be applied - a factor of 0 retains vanilla population, and a factor of 100 applies full shaping.


  • The converter provides a small library of over 17500 flags to be used for various countries and every government type.
  • Colonial flags - for those colonial nations that are not independent - and do not have a predefined flag (Permian Alaska or Funj Brazil) will have flags automatically generated.
  • Converter will also try to match Indian and Muslim flags with respective countries, as well as use CK2 flags for those countries where a CK2-title connection can be established.

Uncivilized nations[edit]

  • As discussed earlier under technology, unless EU4 game is heavily modded, by end-date all countries will be at max tech and institutions, and will convert as civilized.
  • Using Eurocentrism option is strongly recommended to maintain standard Vic2 colonization and native-"handling" mechanics.
  • Uncivilized reforms assigned according to technological level and generally imitate vanilla Vic2.



  • Game supports "Observer" mode through an event that fires after game has started.
  • This event, if enabled, will release Jan Mayen, and make it very undesirable, so the player can assume the role of Observer without fear of being conquered.

African Wipe[edit]

  • A strongly recommended option for those playing outside Africa, this option will remove all African natives from sub-saharan Africa. Existing colonies by civilized nations (and partially westernized, if eurocentrism is enabled) will remain.
  • Using this option enabled the use of vanilla Vic2 colonization mechanics without having to spend improper amounts of infamy by conquering natives.

RGO Randomization[edit]

  • Completely optional, shuffling RGOs can be interesting for multiplayer games, or to bring some variety. Provinces with similar terrain type and climate will have their RGOs shuffled, so no fear of having fish RGO in deserts.

The HRE[edit]

  • Unless HRE was dissolved or united in EU4, both the HRE and the Emperor are imported.
  • The Emperor will have until 1860s to unify the HRE members and land through warfare and sphereing in order to enact Unify HRE decision.
  • Once Nationalism and Imperialism becomes available, this option will no longer be available.


Q: I have an ironman save. Can it be converted?
A: Yup.

Q: I loaded my mod, but nothing changed. What's wrong?
A: You probably placed the mod in the My Documents mod folder. It needs to go in the Vic2 install location's mod folder.

Q: Vic2 is crashing at converting history. What do I do?
A: Try going into the mod and deleting history/units. If it now loads, likely a navy got placed badly. Open up log.txt and search for warnings. If any mention whitelisting and blacklisting, open port_blacklist.txt and add the provinces in the warnings to file file. Save it and reconvert. Repeat checking for the warnings and adding the provinces until there are no more warnings. You should now get a working mod. Make sure to inform the team of any provinces you had to add so we can include them in future releases.

Q: Vic2 is crashing at Initializing Maplogic. What do I do?
A: Clear your map cache by deleting the cache folder inside ".../victoria 2/map/" in both My Documents and the Victoria 2 install location.

Q: Vic2's map is all blue. What do I do?
A: Clear your map cache by deleting the cache folder inside ".../victoria 2/map/" in both My Documents and the Victoria 2 install location.

Q: The converter crashes after no time with no errors and no log.txt (when running through the frontend). What went wrong?
A: You may need to install this if you are not on Windows 10: If this does not help upload your save to the PDX forums for further study.

Q: The converter says my save is compressed. What do I do?
A: You are using an old converter that does not support conmpressed saves. Download a fresh release.

Q: How can I customize my game after converting?
A: Use the guide in after_converting.txt in the converter subdirectory. Scan through configurables/ folder and look into the myriad of configuration files - a great majority of these files is intended to be modified by users to acheive specific conversion results.

Q: The generated mod was in a different language than my savegame.
A: Go in the mod of the converted save, then in setting.txt and change the line "language=l_english" to the language you need, e.g. "language=l_french"

Q: Some/all country names appear as X25, FRA etc.
A: This is an issue with the localisation. See above if you may have changed the language, if not check the localisation files in the converter for the offending countries. Sometimes Vic2 fails to load localizations and merely needs to be restarted.

Q: The country crashes upon selecting a country and pressing play (at main screen)
A: Upload your save to PDX forums for further study.

Q: The game forbids me to select nations.
A: Upload your save to PDX forums for further study.

Recent version history and changelogs[edit]

  • 1.0 Flag of Picardy Picardy - Currently pre-release
  • 1.0 Flag of Oyo Oyo - Iron release, 2020.07.11
  • 1.0 Flag of Nitra Nitra - Imperial release, 2020.06.10
  • 1.0 Flag of Mexico Mexico - Final 1.29 release, 2020.03.25
  • 1.0 Flag of Lucca Lucca - QOL release, 2020.02.01
  • 1.0 Flag of Kurland Kurland - 2020.01.28
  • 1.0 Flag of Jan Mayen Jan Mayen - 2019.12.30

You can find detailed change logs at the forum pages linked above.

Helping with development[edit]

We're always on lookout for programmers, modders, editors and similar, for this and all other current projects.

  • Programming the converters is very streamlined across all projects and involves parsing incoming data, mangling it, and outputting it into a mod
  • Modding support involves crafting supporting events, decisions, ideas and standard modding work
  • Editors deal with data files - we rely on a myriad of supporting files that define how various aspects of the game are converted. Provinces, religions, cultures and so on.

If you have the expertise, or a wish to learn, and a desire to help us with converter projects, you are more than welcome to contact us and join our team.


Configuration Options[edit]

Converter relies on configuration.txt, a file inside the converter directory, to load all the necessary resources. This file is uniformly generated by the Frontend every time a conversion is started. However, for non-windows builds the converter has to be ran manually and this file needs to be set by hand as well.

Feature Status
Europa Universalis 4 Directory A path on your computer where Europa Universalis 4 is installed. The converter uses this to look up the various localisations, country colors, the military unit strengths, the continents, the cultures, the religions, the regions, and the colonial regions.

It will typically be in the Steam folder, and the frontend should find it automatically. When properly set in the configurations file, it should look something like the following.

   EU4directory = "C:\Program Files (x86)\Steam\steamapps\common\Europa Universalis IV"
Europa Universalis 4 Documents Directory A path on your computer where Europa Universalis 4 keeps temporary files. It is used to look up needed mods.

It will typically be in My Documents, and the frontend should find it automatically. When properly set in the configurations file, it should look something like the following.

   EU4DocumentsDirectory = "C:\Users\Stephen\Documents\Paradox Interactive\Europa Universalis IV"
Crusader Kings 2 export directory

A path on your computer where Crusader Kings 2 keeps exported games. It is used to look up needed mods. If the game was not a CK2->EU4 conversion game, this does not need to be set.

It will typically be in My Documents, and the frontend should find it automatically. When properly set in the configurations file, it should look something like the following.

   CK2ExportDirectory = "C:\Users\Stephen\Documents\Paradox Interactive\Crusader Kings II\eu4_export"

More recent variants of CK2 converter (both official and ours) will drop the CK2 mod directly into EU4 mod directory, so you should point this path there:

   CK2ExportDirectory = "C:\Users\Stephen\Documents\Paradox Interactive\Europa Universalis IV\mod"

Doublecheck where your CK2 exported game really is!

Victoria 2 directory

A path on your computer where Victoria 2 is installed. It is used to look up a great many items for the converter.

If Victoria 2 was installed from Steam, it will typically be in the Steam folder, and the frontend should find it automatically. If Victoria 2 was not installed from Steam, it will be wherever the game was installed, and the frontend will need to be shown where it is. When properly set in the configurations file, it should look something like the following.

   V2directory = "C:\Program Files (x86)\Steam\steamapps\common\Victoria 2"
Victoria 2 Documents directory

A path on your computer where Victoria 2 keeps temporary files. It is used to look up province adjacencies.

It will typically be in My Documents, and the frontend should find it automatically. When properly set in the configurations file, it should look something like the following.

   V2Documentsdirectory = "C:\Users\Stephen\Documents\Paradox Interactive\Victoria II"
Save game

Used to instruct the frontend on which game to convert. It must contain the full path and the save game itself. If the EU4 Documents Directory has been set properly, the browse button should easily lead you to the save.

Manually setting it works the same:

   SaveGame = "C:\Users\Stephen\Documents\Paradox Interactive\Europa Universalis IV\save games\autosave.eu4"
Max Literacy

The maximum literacy a nation will start with. If a nation would otherwise convert with higher literacy, it will be capped to this value. The default is 100%. Note that setting this to less than 10% will begin to cause counter-intuitive behavior. See the literacy section for more information.

This setting is in integer notation, from 10 to 100.

When properly set in the configurations file, this setting should look something like the following.

   max_literacy = "100"
Turn Colonial Nations into territories?

How should we handle one's colonial nations? Options are:
1 - Never, they are puppets - All will be independent
2 - Sometimes, by attitude - Set the threshold manually
3 - All, even disloyal ones - Integrate every dependant colonial nation

   absorb_colonies = "1"
If "Sometimes", when exactly?

The threshold attitude for when colonies are absorbed. Default is loyal. This setting is only relevant is the setting before was set to "Sometimes". Options are:
1 - Absorb Loyal only - Only Loyal colonies
2 - Absorb Disloyal too - Disloyal colonies absorbed too.
3 - Absorb Rebellious as well - All colonies are absorbed

   liberty_threshold = "1"
Shape population?
Adjust population size according to dev improvement over EU4 timeframe, buildings constructed, life rating in V2 and other province modifiers. Options are:

1 - Stick to vanilla pop sizes. - Use Vanilla population sizes.
2 - Devpush means more people! - Adjust population sizes with a variety of factors - dev investment during the course of the game, buildings constructed, life rating of the province and similar. 1 dev increase will approximately translate to 1% pop increase compared to vanilla numbers. However, provinces not invested at all will have population slightly decreased.
3 - Extreme - abs. devsize - Redistribute everyone according to absolute value of provinces - this options is useful for multiplayer games coming from a flat word or similar special cases

   pop_shaping = "2"
Shaping Factor?

This is a raw factor that applies to shaping options from previous setting. 0 - Vanilla, 100 - Full. Feel free to experiment with this factor if using either shaping option.

   pop_shaping_factor = "100"
Auto-assign national cores?

Assign cores for nationalities and cultural unions (Can be an issue for CK2 and/or flat dev imports). Options are:
1 - Yes, unification is nigh. - Use defaults - both national (eg. polish) and cultural unions (eg. PLC) cores will be distributed to provinces according to their culture.
2 - No national cores - For primary nationalities - only cultural union ones
3 - No cultural union cores - No Germany, apparently - only national cores for cultures
4 - Don't assign any. - Don't touch anything - relies on EU4 imported cores only

   core_handling = "1"
Make world Eurocentric?

Drop literacy and civilization levels for non-europeans? Options are:
1 - Time to sell some opium! - Configurable via techgroups.txt - you can use this file to inverse the world, or do massive alt-fiction changes.
2 - Use EU4 institutions (bad) - Use defaults - this will cause serious problems as virtually all countries will start as civilized due to rapid spread of all institutions and tech in unmodded EU4 games.

   euro_centrism = "1"
Wipe sub-saharan Africa?

Turn it into proper colonizable real estate? Options are:
1 - Time for a safari! - Wipe the primitives - this clears up most of the native tags from subsaharan Africa, while leaving existing colonies of all European and Asian (and New World nations).
2 - Leave africans in peace... - Don't alter EU4 endgame.

   africa_reset = "1"
Randomise RGOs?

If set, RGOs will be shuffled within similar climate and terrain provinces. Options are:
No - Historical RGOs
Yes - Shuffled RGOs

   randomise_rgos = "no"
Any conversion in EU4 converts all population:

We can convert everyone and their cows, but this will have negative effects on gameplay (assimilation, hotspot crises). Do not change unless you know what to expect. Options are:
No - Nobility and merchants (good) - All upper strata + 50% of middle strata - it will take approx 200-300 years for a majority of population to convert after EU4 province conversion. This is a good thing as it gives meaning to Vic2 assimilation, promotion, hotspots and other mechanics.
Yes - Everyone inc. peasants (BAD!) - 100% of population - this is unwise, but often required feature.

   convert_all = "no"
Mod Output Name (optional):

You can manually set the output name of the mod here.

   output_name = ""