jontiben/eu4-war-explorer

The EU4 War Explorer is program that shows information and statistics about wars in an EU4 save file. It is written entirely in Python.

EU4 War Explorer

created by jontiben in 2022

War info screen

This application reads EU4 savefiles (ending in the file extension .eu4) for information about past wars and then presents it in an easily readable format. It features:

• A searchable list of every finished war in the savefile (searchable by elements of the war title or by tags involved)
• Breakdowns of the overall casualties in a war by side which can be further broken down by individual nation
• A list of battles fought in the war plotted on a map, which can be exported to an image
• A breakdown of forces and losses for each battle
• A scrollable timeline showing major events over the course of the war with clickable links to battles
• Full mod support

Navigation is done exclusively through clicking, scrolling, the ESC key, and typing to search on the war list screen.

Note that the first 11 wars on the battle screen will always be the same on any vanilla EU4 savefile because they took place before the beginning of the game. The window needs to be at a minimum height of 800 pixels in order to fully display every item on the interface.

Planned features are:

• The ability to sort battles by total casualty count
• More information on the timeline

This project was written entirely in Python using Pygame and tkinter for the UI and PIL for modded map processing.

To contact me, please send me a friend request on discord where I am @jontiben.

Screenshots

War list sorted by casualties War info screen with the Anbennar mod Battle map and list Single battle Timeline

License

This project is maintained under the MIT License.

Other

Link to PDXPlaza forum post: https://forum.paradoxplaza.com/forum/threads/eu4-war-explorer.1577174/

eu4-war-explorer's Issues

Keep position in war list when leave war info screen

More interactive timeline

In its final form a war's timeline should include tick marks every month (or X-amount of months, or X-amount of days) since the beginning of the war. Alternatively it could have a mark for the first of every month. Entries on the timeline involving battles should be clickable links to the battle's page.

Sort by casualties

War and battle lists should both be sortable by their total casualties. It should also show this information in the war list interface.

Fixed unit icon scaling on battle casualty screen

Right now unit icons are all scaled to be the same size, which is a square, on the battle casualty screen, even though their raw images are neither a square nor the same aspect ratio as one another. This is noticeable with ships.

Clearer navigation

It should be obvious when you can go back to a previous window using escape. People get confused when it's not.

Poor mod support

The War Explorer does not currently support modded localization. When it encounters modded tags, the raw tag is used as the nation's name and a fallback rebel flag as the nation's flag. This could be solved by allowing the user to select a mod's localization folder instead of just restricting them to the basegame's localization.

War list not reloading when new file's opened

Super long loadtimes

90+ seconds for 1821 saves

Proper scrolling

Currently all scrollable windows, whether vertical or horizontal, can be scrolled a good distance past their last entry. This is because I am afraid of math. I should confront this fear head-on for the sake of providing a higher-quality user experience.