编辑“CK3 To EU4 Converter”

{{Mod
|logo=CK3toEU4WikiLogo.png
|type=Tool
|author=[[User:Zemurin|Zemurin]], [[User:Idhrendur|Idhrendur]]
|status=Supports CK3 1.1 and EU4 1.30
|forum=[[forum:1415137|Paradox Plaza Thread]]
|steam=2241203093
}}

This converter allows a player to take a game from the end of [[Crusader Kings III|CK3]] and convert it into a playable [[EU4:Europa Universalis 4|EU4]] save, continuing the campaign. Produced mod is  compatible with the [[eu4:Europa_Universalis_IV_to_Victoria_II_Converter|EU4 to Vic2]] and [[hoi4:Victoria_2_to_Hearts_of_Iron_IV_converter|Vic2 to HoI4]] converters, allowing the player to play a continuous ''megacampaign'' from CK3 through HoI4. This project is a successor of the [[ckii:CK2 To EU4 Converter|CK2 to EU4 converter project]].

== Features ==

=== Requirements ===
* Crusader Kings III with optional expansions, latest version is required.
* Europa Universalis IV, with optional expansions, latest version is required.

=== Incoming Savegames ===
* Converter supports compressed save games.
* Ironman saves are supported.

=== Outgoing Mod ===
* Converter will produce an EU4 mod.
* Using the front-end, the mod will be copied to EU4 mod directory, located in the user's documents, usually ''C:\Users\User\Documents\Paradox Interactive\Europa Universalis IV\mod''.
* Without front-end (running the converter manually), the mod will be exported to the converter's output folder, and will have to be moved manually by the user.

==== Bookmarks ====
* The converter ideally supports two starting bookmarks - 1444.11.11 and the date at conversion. Players starting earlier will have to wait for 1453 to begin with regular tech progression as technology during CK2 era does not change much.
* Starting before 1066 will require the player to embrace Feudalism institution as it canonically starts at 1066.

==== Map conversion ====
* Converter tries to alter the map as little as possible against vanilla. If a province is out of CK3's scope, it is left untouched. This applies to country histories as well - most out-ot-scope countries will have a history (monarchs, leaders, advisors) identical to EU4 if they start at 1444.11.11 bookmark
* For those countries inside CK3's scope, the conversion treads lightly, only updating necessary elements, e.g. which provinces are owned by whom and what should be local religion/culture/development.

====Religions and Cultures====
* EU4 conversion supports mappings for most CK3 canonical faiths, though although sometimes merging them with other religions. These religions are also compatible with EU4toVic2 and Vic2ToHoI4 converters.
* Reformed and Custom religions are generated dynamically from chosen tenets and doctrines. As this is our first attempt of dynamically crafting EU4 gameplay, balance is yet to be tweaked.
* Cultures have been expanded greatly, and CK3 cultures are not imported on 1:1 basis - instead they are split up. Italian can break into Tuscan, Lombardian, Umbrian, Venetian and so on, as the converter tries to emulate EU4 style of cultural groups.
* Countries can be named after their Dynasties (though they retain canonical tags and have canonical missions and ideas), and some of these dynasties have custom flags. This applies to countries with cultures that support such a renaming.

====Advisors, Rulers, Queens and Heirs====
* Ruler's councilmen from CK3 are available for hire in EU4 (unless they are too old for EU4 to offer them).
* Rulers are converted ad-verbatim. If a ruler is too young to rule, a regency council will be set up for them.
* Queens (or Prince-consorts) are also imported where possible, to help stabilize the realm at start.
* Heirs are imported where possible. Since the converter does not have access to memory-state of a running CK3 game, it makes educated guesses for some of the more obscure succession choices, so please allow for a wrong heir or a lack of one that can occur sometimes.
* Excommunicated rulers are imported as such.
* Ruler prestige and cash are imported but at a logarithmic scale - starting as a relative unknown nets negative starting prestige, while those rulers staring at 500-1000 prestige or more will get a significant boost. 
* While starting prestige and cash are determined by EU4 itself, converter will give a boost of up to 100-150 ducats to wealthy rulers, and starting prestige modifier from -50 for complete unknowns up to +100 for extremely prestigious rulers. 
* Negative cash is not imported.
* Alas, there are no loans to Jewish moneylenders in CK3 for the converter to import.

====Diplomacy, Vassals, Tributaries and Personal Unions====
* For a christian ruler that holds multiple crowns (of same level), he will find his realm split into multiple states, under a personal union lead by his primary title. The split occurs on de-jure basis, where territory outside any de-jure titles will fall under primary crown.
* Non-christian rulers in the same situation will simply absorb the other crowns.
* Large CK3 vassals, holding inappropriate amounts of provinces (compared to the total country size) can be split off into autonomous EU4 vassals at conversion, if the player chooses appropriate option.
* Royal marriages are not imported, and neither are alliances. Unlike CK3, in EU4 diplomatic slots are few and with some of them already taken by vassals and PUs, the converter does not desire to choke the player's diplomatic slots.
* There are no tributaries to be imported.

==== Buildings, Development and Wonders====
* The converter does not import any buildings. Only building that is supported at game start is the humble Fort.
* Small countries (but not OPMs or microstates) will only receive a capital fort, while larger ones will receive a fort in every state or territory they mostly control. Player should delete the excess forts if these hamper the economy.
* Unlike buildings themselves, development and building count does map directly against CK3 development. The more castle baronies that exist in a province, and more buildings inside each, more manpower development is received. Similar applies to cities and production, and finally to temples and tax development. Raw county development is also scaled and redistributed across tax/production/manpower.
* A single building, or building upgrade is worth 0.25 development points in appropriate category. Holding in a barony is worth 0.75 development points, and general development is worth 0.1 per point. Players are advised to tweak these numbers themselves in dev_weights.txt configuration file.
* Wonders are not imported as the current special buildings in select provinces are not actual wonders from CK2.

==== HRE and Empire Shattering====
* Entirely player's choice, the HRE can be kept unified or shattered into EU4-style microstates. If shattering is enabled (which is recommended), the converter will carefully choose which tags are to be turned into free cities and electors.
* Elector ratio attempts to match vanilla EU4 - three theocracies (or substitute republics in not enough (arch)bishops are available) and four secular rulers.
* HRE Electors from CK3 are preserved if possible - they need to hold elector duchies and survive the conversion process.
* Which empire is to be the new HRE is also up to the player - player can HRE-ify Byzantium, Rome, or any empire they desire.
* All empires on the map can be shattered into smaller independent kingdoms or duchies, in case the CK3 game was too blobby. Which specific empires converter shatters can also be manually set.

==== Siberia & Africa ====
* Optionally, the player can clear out all insignificant tribes from east and west Siberia Regions, excluding Kamchatkans which are out of scope. For those playing Russian countries, this will marginally ease any eastward colonial expansion.
* Unless a large country has already expanded into Subsaharan region, the saharan passes will be cleared to prevent premature expansion into the basin.

== Frequently Asked Questions ==
''Q: Is this the official converter?''<br />
A: This converter has been done by the same team that specializes in other Paradox converters:
CK2->EU4, EU4->Vic2, Vic2->HoI4, CK2->EU3, EU3->Vic2, Vic2->HoI3, and relatively soon, Imperator->CK3
It is not official, but it produces as accurate conversion as possible.

''Q: I have an ironman save. Can it be converted?<br />
A: Yes.

''Q: What about mods?<br />
A: Unless they change how cultures, religions or flags work, sure, use mods. Total map overhauls are not supported (of course), and whatever new cultures and religions are brought by the mod - you'll have to add manually in the files in configurables folder.

''Q: How can I customize my game after converting?<br />
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 achieve specific conversion results.

''Q: Is linux supported?<br />
A: The converter does compile on Linux, and you need to compile it from source it to run it. Clone the github repository + all submodules, and run build_linux.sh. If you already have ImageMagick 7 installed, delete relevant commands from the script. Also you'll need to export LD_PATH for the imagemagick libs so the converter can find them. You may need to export the path even when compiling and installing ImageMagick from source.

''Q: Is OSX supported?<br />
A: No, none of the developers has a Mac and we cannot do a port. If you have experience in coding and are willing to help us, we're always interested.

''Q: I have found errors / bugs / glitches / wrong provinces / culture mismaps / religion mismaps / broken names /...<br />
This is good! We need user input to see where we mapped stuff wrong. Please come to [[forum:1415137|converter release thread]] and report any bugs. When reporting upload your ck3 save, converter's log.txt and describe in detail what is wrong. Screenshots always help. We fix user reported bugs as priority.

''Q: I want to help!<br />
We always need help. Not only for this converter, but all others. As they share the same pool of developers we're often stretched thin. We need experienced coders, with working knowledge of C++ and git. We also need modders willing to scour through our mapping files, verify the events, triggers, general data files and so on. If you think you could contribute, please visit our [[forum::1415140|development thread]] and say hello.

== Quick Troubleshooting ==

''Q: The generated mod was in a different language than my savegame.''<br />
A: At the moment, CK3ToEU4 only guarantees English localisation, but German, French and Spanish are nominally supported.

''Q: Some/all country names appear as X25, FRA etc.''<br />
A: This is an issue with the localisation. Only English is guaranteed, and you may be running EU4 in some other localization. Also, CK3 often lacks named and adjectives for various titles in non-English languages. We try to use English localisation when this happens.

''Q: I do not see the converted mod in the launcher.''<br />
A: Click "Manage Mods" and then look for "Add More Mods" button in the lower right corner.

''Q: I loaded my mod, but nothing changed. What's wrong?''<br />
A: Is the mod enabled in the launcher? If so, then EU4 refused to load it due to possible errors. Respond to the [https://forum.paradoxplaza.com/forum/threads/ck3-to-eu4-converter-release-thread.1415137/ forum thread] and upload your save, log.txt and errors.txt so we may debug.

''Q: The country crashes upon selecting a country and pressing play (at map selection)''<br />
A: Upload your save, log.txt and errors.txt to the [https://forum.paradoxplaza.com/forum/index.php?threads/ck2-to-eu4-converter-release-thread.1415137/ forum thread] for further study.

''Q: The game forbids me to select nations.''<br />
A: Upload your save, log.txt and errors.txt to the [https://forum.paradoxplaza.com/forum/index.php?threads/ck2-to-eu4-converter-release-thread.1415137/ forum thread] for further study.

== Versions and Change Logs ==
* 0.3 {{icon|cainite|30px}} [[forum:1415137|Cainite]] - Development prerelease
* 0.2 {{icon|vidilist|30px}} [[forum:1415137/page-6#post-26971677|Baltic]] - Just In Time Release - 2020.09.30
* 0.1 {{icon|adamite|30px}} [[forum:1415137/page-4#post-26958823|Adamite]] - First Barebones Release - 2020.09.27

Detailed change logs can be seen at linked forum threads above.

== Credits ==
* Comagoosie - Rakaly melter
* Idhrendur - Sanity Checks and Review
* IohannesIohannium (aka Mysterious_Italy) - Data Files
* Elfangor - Data Files
* Silver Wizard - Coding support
* Zemurin - The Weave
* AND ALL THE OTHERS WHO GAVE THEIR INPUT ON THE FORUM AND DISCORD.
[[en:CK3 To EU4 Converter]]