IL-2 Campaign Tracker and Campaign Service Record

[Arrow_1974]

Hi all,
we, @kraut1 and I,  want to introduce a new mod:
 

IL-2 Great Battles SP Campaign Tracker v2.0

The IL-2 Campaign Tracker is a tool that automatically tracks your single-player campaign career across all IL-2 Great Battles campaigns. It monitors your missions in the background, records your combat performance, manages rank promotions and historical awards, and provides a professional service record viewer to review your complete pilot history.

Main Features:

• Automatic tracking - monitors all SP campaign missions without requiring any interaction during gameplay
• Promotions & awards - earn historically accurate ranks and medals based on your performance, displayed via in-game popups and briefing text (derived from the SP career mode)
• Service record viewer - browse your complete career in a clean web interface with customizable pilot profiles, mission debriefings, and career statistics
• PDF reports - automatically generated mission summaries with combat results and award history
• Backup & restore - save campaign states and replay failed missions
• Fully customizable - adjust promotion criteria and award requirements via configuration files

The tracker works entirely in the background while you fly. After missions, your achievements appear in the in-game briefing screens (only after restart of IL-2 in the next session) and popup notifications for awards and promotions. Launch the Service Record viewer anytime to see your complete pilot history presented like an official military record.

Works with all stock and community campaigns. Safe and fully reversible - the uninstaller (when using the setup.exe) cleanly removes all modifications.

📥 Downloads & Links

Installer (Recommended):  
[IL2_CampaignTracker_Setup_v2.2.exe.zip] - Automated installation with guided setup --> link modified to latest version 2/5/2026 

Manual Installation:  
[Manual Install Package] - For users who prefer manual setup --> no more available

Source Code & Development:  
[GitHub Repository] - View source code, report issues, or contribute

Full documentation including installation instructions, configuration guide, and troubleshooting is provided in the README.html file attached to this post.README.html

Once again, many thanks to Kraut1. His help, feedback, and encouragement have played a major role in creating and improving this mod.
Example screenshots of a campaign service record:

Enjoy tracking your IL-2 career! 🛩️

Edited February 6 by Arrow_1974
Links updated to latest version / manual installation not available anymore

[FilMit]

What languages does it support besides English?

P.s. That's it, I found the answer to my question.

Edited January 17 by FilMit

[Stonehouse]

Nice! Does it recognise PWCG campaigns? 

PS Thanks for making it evident that we have forum tags now. Makes it much easier to find all the mods I am maintaining.

[kraut1]

1 hour ago, Stonehouse said:

Nice! Does it recognise PWCG campaigns? 

PS Thanks for making it evident that we have forum tags now. Makes it much easier to find all the mods I am maintaining.

Hi @Stonehouse IL-2 Campaign Tracker and Campaign Service Record is designed for scripted Campaigns.

In PWCG we have already Squadron management with Logbook, Promotions and Awards/Orders.
PWCG Campaigns are not compatible.
 

[Stonehouse]

30 minutes ago, kraut1 said:

Hi @Stonehouse IL-2 Campaign Tracker and Campaign Service Record is designed for scripted Campaigns.

In PWCG we have already Squadron management with Logbook, Promotions and Awards/Orders.
PWCG Campaigns are not compatible.
 

Very true. I'd forgotten.

[Arrow_1974]

@FilMit: I am looking into the possibility to support multiple languages. But this may take a little while....

[Billsponge1972]

Thank you so much for this! I'm going to try it out pronto. I was wondering if it works with tank crew campaigns also?

[Arrow_1974]

@Billsponge1972: I cannot provide a definitive answer. My focus has been exclusively on World War II single-player aircraft campaigns, excluding Flying Circus. As I do not own either Flying Circus or Tank Crew, I am unable to make a substantiated evaluation.

Edited January 17 by Arrow_1974

[Billsponge1972]

Thanks, that's ok, I have a rework of my old "Sherman's in Northwest Europe" campaign that I'll try it with and let you know.

[Arrow_1974]

⚠️I found a small bug related to British ranks not being displayed correctly. ⚠️

The issue was caused by an indentation error in the campaign_progress_config.yaml. Because of this, the British rank definitions were not parsed correctly and therefore did not appear in the PDF or in the Service Record.

How to fix it yourself:

1. Open campaign_progress_config.yaml from your tracker installation folder

2. Remove the incorrect indentation in the Britain ranks section (see screenshot).
   

3. Save the file and restart the application.

I have already fixed this in the files provided in the download links in the initial post of this thread, so if you re-download the current version, no manual changes are required.

@kraut1 Thanks for reporting the issue!

Edited January 18 by Arrow_1974

[kraut1]

Example: my current scripted Camapign status Work in Progress / partly released displayed in the Tracker / Service Record:

 

[Arrow_1974]

Hi everyone (and @FilMit),

I’m happy to share a new multi-language version of my IL-2 Campaign Tracker for IL-2 Sturmovik: Great Battles.

Here is the download link: [IL2_CampaignTracker_Setup_v2.2_ML.exe.zip] - Automated installation with guided setup

This update adds multi-language UI support while keeping the exact same functionality as the original English-only version. No gameplay logic, calculations, or tracking behavior has changed.

Supported Languages (7 total)

The tracker now supports:

• English (baseline / reference language)

• German

• Spanish

• French

• Polish

• Russian

• Simplified Chinese

Language selection is automatic based on what language you select during installation. Debriefings/Events are written to all existing info.locale={language}.txt for each campaign for all supported languages in their respective language. PDFs are generated in the (during installation) selected language. The campaign service record is also displayed in the selected language. GUIs are also translated.

 Important Notes (Please Read)

• This is a BETA release
  I have not fully tested every language end-to-end yet—only spot checks and random tests so far.

• Functionality is identical
  Promotions, awards, mission parsing, PDFs, popups, backups, etc. behave exactly the same as in the English-only version.

• Translation disclaimer
  I do not take responsibility for translation quality in:

  • Spanish

  • French

  • Polish

  • Russian

  • Simplified Chinese

  These translations were generated with tooling and may contain awkward wording, stylistic issues, or terminology that feels “off.”

  👉 That said: I would be very happy to receive feedback if you notice strange, unclear, or misleading translations. Improving them over time is absolutely the goal.

• README not fully translated
  Please excuse that I did not translate readme.html into all languages.
  Users who want a localized README can easily do so themselves using AI tools or online translators.

Why BETA

I wanted to get this version out early, so the community can:

• Try it in real campaigns

• Spot language issues I might miss

• Provide feedback before I call this “final”

Nothing is locked in yet.

Thanks to everyone who has been testing, giving feedback, and generally keeping this project alive.
Have fun with the multi-language version—and, as always…

Happy flying! ✈️

Edited February 6 by Arrow_1974
Download link updated

[kraut1]

13 hours ago, Arrow_1974 said:

Hi everyone (and @FilMit),

I’m happy to share a new multi-language version of my IL-2 Campaign Tracker for IL-2 Sturmovik: Great Battles.

Here is the download link: [IL2_CampaignTracker_Setup_v2.1_ML.exe.zip] - Automated installation with guided setup

This update adds multi-language UI support while keeping the exact same functionality as the original English-only version. No gameplay logic, calculations, or tracking behavior has changed.

Supported Languages (7 total)

The tracker now supports:

• English (baseline / reference language)

• German

• Spanish

• French

• Polish

• Russian

• Simplified Chinese

Language selection is automatic based on what language you select during installation. Debriefings/Events are written to all existing info.locale={language}.txt for each campaign for all supported languages in their respective language. PDFs are generated in the (during installation) selected language. The campaign service record is also displayed in the selected language. GUIs are also translated.

 Important Notes (Please Read)

• This is a BETA release
  I have not fully tested every language end-to-end yet—only spot checks and random tests so far.

• Functionality is identical
  Promotions, awards, mission parsing, PDFs, popups, backups, etc. behave exactly the same as in the English-only version.

• Translation disclaimer
  I do not take responsibility for translation quality in:

  • Spanish

  • French

  • Polish

  • Russian

  • Simplified Chinese

  These translations were generated with tooling and may contain awkward wording, stylistic issues, or terminology that feels “off.”

  👉 That said: I would be very happy to receive feedback if you notice strange, unclear, or misleading translations. Improving them over time is absolutely the goal.

• README not fully translated
  Please excuse that I did not translate readme.html into all languages.
  Users who want a localized README can easily do so themselves using AI tools or online translators.

Why BETA

I wanted to get this version out early, so the community can:

• Try it in real campaigns

• Spot language issues I might miss

• Provide feedback before I call this “final”

Nothing is locked in yet.

Thanks to everyone who has been testing, giving feedback, and generally keeping this project alive.
Have fun with the multi-language version—and, as always…

Happy flying! ✈️

@Arrow_1974 Thank you very much!

Although in IL-2 my Campaign is 100% english, the german translation is great!

A small suggestion:

The Tracker creates for each campaign all language files and this takes much time.

if this is required I suggest to create a "pause campaign switch" in the "campaign_mission_dates.json" to avoid, that currently not actively flown campaigns are analysed again and again.

But altogether seen from my Point of View the translation is really good!

[FilMit]

Thank you very much for this program. This was sorely lacking for static BoS campaigns. We're just used to the minimalist style 😜
Special thanks for the languages!!! All the best to you!

[Billsponge1972]

Finally got around to installing this. Very nice! Thank you @Arrow_1974!

I can say that it works with TC campaigns. There is some missing data like flight times and incorrect awards/medals as to be expected but for the most part complete. 🙂

[Arrow_1974]

8 hours ago, Billsponge1972 said:

can say that it works with TC campaigns. There is some missing data like flight times and incorrect awards/medals as to be expected but for the most part complete. 🙂

Interesting- if I had more information about TC campaigns I could implement them better into the tracker.

[Arrow_1974]

IL-2 Campaign Tracker v2.2 - Settings Manager & Performance Improvements

Hey everyone,

I'm happy to announce version 2.2 of the IL-2 Campaign Progress Tracker with some significant improvements.

🆕 New: Settings Manager GUI

No more manual editing of YAML or JSON files! The new Settings Manager (IL2_Settings_Manager.exe) provides a user-friendly interface to configure all tracker settings.

What you can configure:

General Tab

• Language - Switch between 7 languages (English, Deutsch, Français, Español, Polski, Русский, 简体中文)
• Enable Popups - Toggle promotion/award notifications on/off
• Rank Scaling - Enable/disable rank scaling based on campaign length

Rank Scaling Tab

• View and edit all scaling brackets (e.g., 1-10 missions = 1.0x, 11-20 = 1.15x, etc.)
• Add, edit, or remove brackets as needed
• Perfect for fine-tuning progression in longer custom campaigns

Rank Values Tab

• Adjust promotion score thresholds for each nation
• Supports all four nations (Germany, Soviet Union, USA, Britain)

Campaigns Tab

• Set Starting Rank Offset per campaign (supports 0-7!)
• Useful for campaigns where your pilot starts as an experienced officer or squadron leader

Auto-Regeneration

When you change certain settings, the tracker automatically regenerates all affected content:

Setting Changed	What Happens
Language	All debriefings and PDF reports regenerated in new language
Rank Scaling	All events recalculated with new scaling factors
Rank Values	All promotions recalculated with new thresholds

No need to manually delete JSON files or restart anything - just click "Apply" and the tracker handles everything!

---

⚡ Performance Improvement: Smarter Regeneration

Previously, when you completed a mission and the campaignsstates.txt was updated, the tracker would regenerate events for all campaigns. This could be slow if you had many campaigns installed.

Now in v2.2: The tracker detects which campaign was actually modified and only regenerates that specific campaign. This makes the update process significantly faster and more efficient, especially for users with many campaigns.

---

📥 How to Get It

Download the latest version from Tracker 2.2 Multi Language with Settings Manager. The Settings Manager (IL2_Settings_Manager.exe) is included in the installation package.

---

Here the newest README: README.html

And for our German pilots: README_DE.html 
Sorry that I do not provide the README in other languages as I am only confident in my English and German language skills.

Let me know if you have any questions or feedback!

Happy flying! ✈️🎖️

Edited February 6 by Arrow_1974
Download Link updated

[Arrow_1974]

Small Quality-of-Life Update – New Control Center GUI

Hi everyone,

I’ve added one more small but practical improvement to the Campaign Tracker (and fixed some minor issues from previous versions).

A new Control Center GUI is now included (available in all supported languages), which brings all major functions together in a single place. Instead of searching through the installation directory for individual executables, you can now access everything directly from this central control panel. 

From the Control Center you can:

• Start and stop the Campaign Tracker

• Open the Campaign Service Record

• Launch the Settings Manager

• Uninstall the tracker cleanly

During installation, you can choose to create a desktop shortcut. This shortcut will open the Control Center GUI directly.
Alternatively, the Control Center can be launched manually from the installation directory via IL2_Tracker_Control_GUI.exe.

You can download it here: Tracker with Control Center

This change doesn’t alter any existing functionality—it simply streamlines access and makes day-to-day usage a bit more convenient. 
But I highly recommend to download the latest version of the tracker. I don’t maintain previous versions anymore.

IMPORTANT: In order to have in-game promotion/award popups work correctly, you need to DISABLE "Fullscreen" in the graphics settings menu in IL-2 BoS

As always, feedback is welcome. If you notice anything odd or have suggestions for further improvements, let me know.

Best regards
Alex

Edited February 1 by Arrow_1974

[Arrow_1974]

Hi everyone,

I have implemented a small new feature that allows you to select a campaign-specific language in the Settings Manager. For example, if you select German for a German campaign, the service record detail page for that campaign will be displayed in German.

All other areas—such as the in-game debriefing, PDF outputs, and the landing page—continue to use the language selected during installation. Available campaign languages are: German, English and Russian ("Default" is your globally set language)

Here is the link for the latest version and the latest README in English and German: Campaign Tracker with per-campaign-selectable language
README_DE.htmlREADME.html

Edited February 8 by Arrow_1974

[Arrow_1974]

Hi everybody,

I added a medal showcase to the campaign tracker. You can access your campaign specific awards on the detail page of the campaign service record in the left column at the bottom after your latest received award:

Here an example of an US showcase (all medals earned):


You can download the latest version of the tracker here:
Latest tracker version with medal showcase feature

Edited yesterday at 04:00 AM by Arrow_1974

[LuftManu]

This looks great! Thank you!

[TheAlpaca]

Quote

Can this be used for Dynamic Campaigns as well? Like the normal career mode?

 

[Arrow_1974]

@TheAlpaca:

The Campaign Tracker is currently designed specifically for scripted (static) WW2 IL-2 campaigns and therefore cannot be used with Dynamic Campaign systems such as the in-game Career Mode or Pat Wilson’s Campaign Generator (PWCG).

The tracker operates by analyzing two dedicated data sources generated by scripted campaigns:

• campaignsstates.txt

• Mission FlightLogs

These files provide the structured progression and mission outcome data required to reconstruct pilot careers, promotions, awards, and campaign timelines within the tracker.

Dynamic campaign systems work fundamentally differently:

PWCG (Pat Wilson’s Campaign Generator)
PWCG is a standalone application with its own campaign engine, database structure, and progression logic. It already maintains internal pilot records, logbooks, awards, and statistics. Because it does not generate or rely on the same campaign state files used by scripted campaigns, its data cannot be interpreted by the tracker without a complete, dedicated integration layer.

IL-2 In-Game Career Mode
The official Career Mode stores all progression data inside the cp.db database rather than in campaignsstates.txt. Since the Campaign Tracker does not read or parse this database format, Career Mode campaigns are currently outside the supported scope.

In short:

• ✅ Scripted / hand-built campaigns → Supported

• ❌ PWCG dynamic campaigns → Not compatible

• ❌ In-game Career Mode → Not compatible

This limitation is primarily architectural rather than conceptual. Supporting dynamic campaigns would require implementing entirely separate data parsers and progression logic for each campaign system, effectively turning the tracker into a parallel career engine.

For now, the tracker is intentionally focused on enhancing scripted campaigns where no native long-term career tracking, award management, or service record system exists.

Future support for the in-game Career Mode is theoretically possible, for example by creating a dedicated service record system similar to the one implemented in this tracker. Due to the different underlying data structure, this would require additional development and is therefore a longer-term consideration.

I created a rank expansion mod for the in-game career mode if this should interest you. Link to rank expansion mod for single player career mode

Edited 4 hours ago by Arrow_1974