An external overlay for World of Tanks Blitz (Windows) with two features:

1. Gun marks. During a battle it shows how much more damage you need to deal so that the gun mark percentage does not drop. After the battle it shows the exact result.
2. Session statistics in the hangar. Battles, win rate, average damage, assist, blocked damage, credits and free XP for the session.

How the mod works

The mod does not inject into the game and does not read its memory. It only reads files that the client itself writes to disk: the recording of the current battle and the results of previous battles.

Nothing is sent to the internet. All data stays on your computer in %APPDATA%\GunMarkOverlay.

Installation

1. Unpack the program to any folder and run it. An icon will appear in the tray.
2. For session statistics in the hangar: in the tray icon menu choose “Install widget in hangar” and restart the game. The program finds the game folder (Steam) by itself. Before making changes it saves a backup of the original file next to it (Hangar.yaml.dvpl.session.bak).
3. To remove the widget: “Remove widget from hangar” in the same menu. You can also roll back with “Verify integrity of game files” in Steam.
4. After installing and launching, make sure replays are enabled (at least 10), otherwise neither of the two mods will work.

Gun marks

What is shown by default

The main number: how much more damage you need to deal so that the gun mark percentage does not drop (the progress bar shows the same thing). The percentage is not shown by default so that you do not rely on an approximate number.

The approximate percentage (forecast and “likely”, with a plus or minus relative to the current value) is enabled by a separate item in the menu.

After the battle (while the post-battle statistics are loading) the overlay shows the exact result from the battle results file.

Accuracy

1. The main estimate (“so as not to drop”) is intentionally made with a margin: it is better to show “slightly more damage needed” than to give false confidence.
2. “Likely” is closer to reality, but can be wrong in either direction.
3. The more of your own battles on a given tank, the more accurate it is. On a new tank the first battles are less accurate. This is normal.
4. This is an estimate, not a guarantee. The exact value comes only after the battle (while the post-battle statistics are loading).

Tanks with a low percentage

If a tank’s gun mark is below roughly 75 %, do not rely much on the approximate percentage. At low percentages the deviation of the forecast from the real result can be large, and the margin estimate itself is less accurate. In such cases look at the “damage needed” number and the exact result after the battle, not at the percentage in the overlay.

What is not taken into account

Damage to unspotted enemies, base/point capture in Superiority mode.

Because of this, in battles with capture the real result is usually better than the mod showed. This is the safe side of the error.

Platoon

In a platoon gun marks do not count. The mod detects a platoon and, instead of a calculation, shows the message “platoon: gun marks don’t count”.

Tips

1. Play regular random battles. The mod does not count ranked and other modes.
2. Let the mod collect 5–10 of your battles on each new tank before trusting the number too much.
3. Go by the main number (“damage needed”). If you have dealt it, the percentage will almost certainly not drop.
4. The approximate percentage is useful for planning, but it is a forecast.
5. On tanks below ~75 % do not trust the approximate percentage: the spread is larger there.
6. Do not delete the %APPDATA%\GunMarkOverlay folder: it holds the accumulated statistics that make the mod more accurate.

Session statistics in the hangar

Counted for the session:

1. number of battles, win rate;
2. average damage, average assist, blocked damage;
3. credits and free XP.

Notes:

1. Only random battles are counted (ranked ones will be added later).
2. Credits and free XP are taken from the live balance in the hangar, not from the battle file, because the file does not contain repair and consumable costs. Only the balance change right after a battle is added to the session; manual purchases and sales in the hangar are not counted.
3. The session is kept between launches. It can be reset with the button in the widget.
4. The widget collapses on click.
5. The mod must be running. If you close the program, nothing will be shown in place of the widget in the hangar.
6. After a game update the client may restore the original hangar file and the widget will disappear. Please install the widget again after that; the session is kept if it existed before the update. The same happens after “Verify integrity of game files” in Steam.
7. If other mods also modify the hangar file, the installation will stop and change nothing.
8. If the screen is small (for example, a laptop) and the widget overlaps the equipment, move it up: tray icon menu → “Hangar widget position” → “Up”, then restart the game or play a battle. The position is remembered.

Settings (tray icon menu)

1. Language (en / uk / ru).
2. Window size: 75–200 %. By default it is chosen according to the screen resolution.
3. Text color and outline, background, position (the window can be dragged).
4. Showing the approximate percentage and compact mode (a single indicator).
5. Installing and removing the widget in the hangar.
6. Hangar widget position (up / down / left / right).

Settings files are located in %APPDATA%\GunMarkOverlay. If something goes wrong, check log.txt in the same folder.

FAQ

1. Antivirus complains. The program reads files and shows a window over the game, and such behavior sometimes causes false positives.
2. The percentage after the battle did not match the forecast. This is expected: the forecast is approximate. The mod takes the exact value from the battle results.
3. The percentage shows strange values (for example -60%). Your replay results folder is empty; the problem will go away after 1–2 battles.