﻿Shell Distribution Logger 1.7.4
by S. Komarov ("Stig97_..")

INSTALLATION
1. Unpack the zip into your World of Tanks folder (e.g. C:\Games\World_of_Tanks) and allow it to merge folders.
2. Start the game (restart it if it's running). The client restarts once by itself on the first launch. That's normal.
3. In the garage, open the mods list and pick "Shell Distribution Logger".

Update: replace the old .wotmod in the mods/<game version> folder with the new one. Your logs are kept.
After a game update: move the mod into the new mods/<game version> folder.

UNINSTALL
Delete com.komarov.shelldistributionlogger_*.wotmod. Your shot logs stay in shellLogger_local in the game folder
and your settings in mods/configs/shell_logger; delete those folders too if you don't want them.

SETTINGS (optional)
mods/configs/shell_logger/config.cfg, created the first time you change a switch in the window:
  "processReplays": false    also log shots while you watch replays (the "log replays" switch)
  "silhouette": true         trace the target's real outline for every shot
  "obstacles": true          also trace cover in front of the target
  "outputDir": "./shellLogger_local"         where the logs are kept (the game folder)
  "language": "auto"         the window's language: "auto" (the game's), "en" or "ru"

IF SOMETHING DOESN'T WORK
The mod writes its messages to the game's log, World_of_Tanks/game.log, in lines starting
with [SHELL_LOGGER]. The garage window needs net.openwg.gameface (included); the logging itself does not.

CREDITS
- Built on wotstat-analytics by Andrei Soprachev (WotStat), the free, open mod this one grew out of: https://github.com/wotstat/wotstat-analytics. Everything that sent data to WotStat's servers has been removed.
- FixedBattleResultsCache by Andrii Andrushchyshyn (MIT licence).
- net.openwg.gameface by OpenWG (MIT licence): https://gitlab.com/openwg/wot.gameface
- The expected shell distribution comes from "Ultimate Gun Mechanics" by Peter "Overlord_Prime" Han (380,000+ logged shots): https://docs.google.com/document/d/1au-7iJuzjSBsjhB6pLiAzMZNPxOOdrx_AFEGa6TU89Q

========================================================================

Shell Distribution Logger 1.7.4 — журнал распределения снарядов
Автор: S. Komarov («Stig97_..»)

УСТАНОВКА
1. Распакуйте архив в папку с игрой (например, C:\Games\World_of_Tanks) и согласитесь на объединение папок.
2. Запустите игру (или перезапустите, если она открыта). При первом запуске клиент один раз перезапустится сам. Это нормально.
3. В ангаре откройте список модов и выберите «Журнал распределения снарядов».

Обновление: замените старый .wotmod в папке mods/<версия игры> на новый. Журнал выстрелов сохранится.
После обновления игры: перенесите мод в новую папку mods/<версия игры>.

УДАЛЕНИЕ
Удалите com.komarov.shelldistributionlogger_*.wotmod. Журнал выстрелов останется в shellLogger_local в папке игры,
настройки — в mods/configs/shell_logger; удалите и эти папки, если они вам не нужны.

НАСТРОЙКИ (необязательно)
mods/configs/shell_logger/config.cfg появляется, когда вы впервые меняете переключатель в окне:
  "processReplays": false    записывать выстрелы и при просмотре реплеев (переключатель в окне)
  "silhouette": true         снимать настоящий контур цели для каждого выстрела
  "obstacles": true          снимать и укрытие перед целью
  "outputDir": "./shellLogger_local"         куда сохраняется журнал (папка игры)
  "language": "auto"         язык окна: "auto" (как в игре), "en" или "ru"

ЕСЛИ ЧТО-ТО НЕ РАБОТАЕТ
Мод пишет сообщения в журнал игры World_of_Tanks/game.log, строки начинаются с [SHELL_LOGGER].
Окну в ангаре нужен net.openwg.gameface (есть в архиве), запись выстрелов работает и без него.

АВТОРЫ И БЛАГОДАРНОСТИ
- Основан на wotstat-analytics Андрея Сопрачева (WotStat) — бесплатном открытом моде, из которого вырос этот: https://github.com/wotstat/wotstat-analytics. Всё, что отправляло данные на серверы WotStat, удалено.
- FixedBattleResultsCache — Andrii Andrushchyshyn (лицензия MIT).
- net.openwg.gameface — OpenWG (лицензия MIT): https://gitlab.com/openwg/wot.gameface
- Ожидаемое распределение снарядов взято из документа «Ultimate Gun Mechanics» Peter "Overlord_Prime" Han (более 380 000 записанных выстрелов): https://docs.google.com/document/d/1au-7iJuzjSBsjhB6pLiAzMZNPxOOdrx_AFEGa6TU89Q
