﻿TankCoach — набор тестера, World of Tanks (Wargaming, «ВГ»)                07.11.2026
==============================================================================
Автор: VasiliyM · Telegram: t.me/tankcoach · Конфиденциальность: privacy@tankcoach.net
Язык: RU (English version: README_EN.txt)


1. ЧТО ЭТО
---------
Три мода. Вместе они дают разбор боя на сервере проекта (https://app.tankcoach.net):

  mod_netprobe_wot.pyc       7.02   замер связи и выстрелов (netprobe, «клиент»)
  mod_netprobe_track.pyc     2.43   логгер боя: позиции, засвет, выстрелы,
                                    попадания, урон, броня
  mod_coach_viewer.pyc       0.42   страница TankCoach: список боёв, кнопка
                                    «Собрать», отправка боя, вход и регистрация

Как это работает:
  * Моды в бою ТИХО записывают данные боя в файлы (папка Netprobe_mod_result
    рядом с игрой). Бои уходят только по кнопке «Собрать» (что уходит само -- п. 8), анализа на твоём ПК нет.
  * Когда ты нажимаешь «Собрать», страница TankCoach упаковывает файлы ЭТОГО
    боя и отправляет их на наш сервер. Отчёт строит СЕРВЕР, и он же его
    показывает. Нужен только браузер.
  * В бою на экране есть только индикатор netprobe: шкала связи (пинг, лаги)
    и, на несколько секунд после выстрела, круги клиентского и серверного
    прицела и точка, куда ушёл снаряд. Попал / не попал, по кому и сколько —
    в бою НЕ показывается и не считается; это всё в отчёте после боя.
  * Моды только читают то, что клиент и так знает, и не управляют игрой.


2. ЧТО НУЖНО
------------
  * World of Tanks (Wargaming, «ВГ»), версия клиента 2.4.1.1 (набор собран под неё).
  * Заявка не нужна: первый собранный бой сам создаёт вход (см. п. 6).
  * Браузер на ПК (Chrome, Edge, Firefox) — для просмотра отчётов.
  * «Серверный прицел» в настройках игры можно НЕ включать: с этого набора
    netprobe и логгер сами просят сервер присылать серверный маркер (на экране
    ничего не меняется). Включённая настройка тоже работает.


3. УСТАНОВКА
------------
ПРОСТОЙ СПОСОБ: дважды щёлкни TankCoach_install.bat из этой папки (кратко — START_HERE.txt).
Он сам найдёт игру, сделает копию старых файлов и поставит свежий набор
(нужен интернет; набор проверяется по подписи автора). Окно на русском или английском —
по языку твоего Windows. Подробнее — README_INSTALL_RU.txt (RU) и README_INSTALL_EN.txt (EN).
Windows может написать «Не удаётся проверить издателя» — нажми «Выполнить» (или «Подробнее» ->
«Выполнить в любом случае»): это безопасно, ставятся только наборы с подписью автора.
Ничего не вышло — ставь вручную, шаги ниже.

1) Закрой игру.
2) Найди папку игры — ту, где лежит WorldOfTanks.exe. Обычно в лаунчере у игры есть
   пункт «Показать в папке» (шестерёнка рядом с кнопкой «Играть»); либо
   открой путь установки игры вручную.
3) Открой файл version.xml в этой папке (Блокнотом): там строка вида
   <version> v.2.4.1.1 #… </version>. Запомни номер — 2.4.1.1.
4) Распакуй архив. Скопируй папку  install\res_mods\2.4.1.1  внутрь
   <папка игры>\res_mods\   (с заменой файлов, если спросит).
   Должно получиться:

     res_mods\2.4.1.1\scripts\client\gui\mods\mod_netprobe_track.pyc
     res_mods\2.4.1.1\scripts\client\gui\mods\mod_netprobe_wot.pyc
     res_mods\2.4.1.1\scripts\client\gui\mods\mod_coach_viewer.pyc
     res_mods\2.4.1.1\gui\maps\netprobe\*.png            (68 картинок)

   ВАЖНО: именно ...\scripts\client\gui\mods\ — иначе моды тихо не
   загрузятся. Это самая частая ошибка.
5) Если у тебя стояли другие версии этих модов (mod_netprobe*.pyc,
   mod_netprobe_track.pyc, mod_coach_viewer.pyc) — старые файлы замени или
   убери. Две версии одного мода одновременно не ставить.
6) Запусти игру. Проверка: через минуту в папке Netprobe_mod_result должны
   появиться журналы (см. п. 11).


4. ПОСЛЕ ПАТЧА ИГРЫ (обновление клиента)
----------------------------------------
Каждый патч создаёт в res_mods папку с НОВЫМ номером, а моды остаются в
старой. Тогда:
1) Открой version.xml -> новый номер (например, v.<новый номер>).
2) Скопируй папку со своего старого res_mods\2.4.1.1 в новую
   res_mods\<новый номер> (целиком, подпапки scripts и gui), либо возьми
   папку install\res_mods\2.4.1.1 из набора, переименуй её в новый номер
   и скопируй в res_mods\.
3) Запусти игру. Если моды после патча не загрузились (нет строк в журналах
   из п. 11) — клиент мог измениться; напиши автору, версию клиента назови.
Старую папку можно оставить: игра читает только папку своей версии.
Новый набор от автора ставится так же, как в п. 3 (с заменой файлов).


5. УДАЛЕНИЕ
-----------
Закрой игру. Удали из res_mods\2.4.1.1\scripts\client\gui\mods\ три
файла (mod_netprobe_track.pyc, mod_netprobe_wot.pyc, mod_coach_viewer.pyc) и папку
res_mods\2.4.1.1\gui\maps\netprobe\ . Папку Netprobe_mod_result (файлы
твоих боёв) можно удалить или оставить; файл netprobe_track_config.json в
папке игры — тоже можно удалить.


6. ПЕРВЫЙ ЗАПУСК: ОТКРЫТЬ СТРАНИЦУ И ВОЙТИ
------------------------------------------
Открой страницу TankCoach — в ангаре нажми Ctrl+Shift+R.

 Страница откроется в твоём обычном браузере Windows (Chrome / Edge /
 Firefox — какой стоит по умолчанию). Игра остаётся открытой, вернись в неё
 через Alt+Tab. (До 0.29 страница открывалась во встроенном браузере игры —
 вернуть можно строкой "mode": "overlay" в Netprobe_mod_result\coach_viewer.json.)

 Если браузер сам не открылся:
      1. Alt+Tab -> открой обычный браузер (Chrome / Edge / Firefox).
      3. Введи адрес:   http://127.0.0.1:18765/server
         (поставь в закладки). Адрес 127.0.0.1 — это ТВОЙ компьютер: страницу
         отдаёт сам мод, пока запущена игра. Вне игры страница не откроется.
      4. Если не открылось, порт мог сдвинуться (18766 … 18774). Точный адрес —
         в Netprobe_mod_result\coach_viewer.log, строка «server:
         http://127.0.0.1:…/».
    Дальше всё как обычно: вход, список боёв, «Собрать». Отчёт откроется в
    том же окне браузера — ничего больше делать не надо.


Вход и регистрация.
  * Заявка и ключ от автора НЕ нужны. При первом открытии страницы будет окно
    «Разбор ваших боёв»: что и куда отправляется. Нажми «Согласен — начать»,
    затем «Собрать» у свежего боя (не старше суток) -- этот бой подтверждает
    твой ник, и мод сам сохраняет вход (coach_viewer.json).
  * Тут же можно задать свой пароль для сайта (8-64 знака) -- чтобы смотреть
    бои с телефона или другого ПК: https://app.tankcoach.net/battles
  * Уже есть ник и ключ (выдавал автор)? Ссылка «у меня уже есть ник и пароль
    -- войти» в том же окне. Сменить ключ: https://app.tankcoach.net/key
  * Язык страницы — переключатель RU / EN вверху (с 0.30). Сначала язык берётся по
    клиенту: ВГ с русским, украинским, белорусским или казахским интерфейсом и Мир танков —
    русский, остальные клиенты ВГ — английский. Выбор запоминается (coach_viewer.json,
    поле "lang"). Отчёт строится на языке страницы; язык можно сменить и в самом отчёте.
  * Вышла новая версия мода — вверху страницы появится жёлтая полоса со ссылкой «Скачать».
    Её можно закрыть; повторно покажется только при следующей новой версии.
  * Бой, сыгранный под другим ником, сервер не примет.


Хранение (тестовый период): на сервере хранятся 20 последних разборов.
Когда их набирается 20, старые 10 можно скачать одним архивом (готовые
отчёты, открываются в браузере без сервера) -- через 3 дня они удаляются.
Статистика боёв (связь, стрельба, «Баланс сил») остаётся на сайте всегда.


7. КАК ПОЛУЧИТЬ ОТЧЁТ О БОЕ
---------------------------
1) Сыграй бой и дождись выхода в ангар — лучше досмотреть до итогов боя:
   бой без итогов сервер не берёт (если игра упала после боя — примет примерно
   через 20 минут).
2) Открой страницу TankCoach (п. 6). У нужного боя нажми «Собрать».
3) Страница упакует файлы боя, отправит на сервер, и через несколько секунд
   (иногда минуту-две, если сервер собирает чужой бой) откроется отчёт.
   Потом у боя в списке будет «Открыть».
4) В отчёте: «⤓ Скачать» — сохранить отчёт файлом, «🔗 Ссылка» — скопировать
   адрес, «↗ Открыть в браузере» — открыть отчёт в обычном браузере Windows
   (кнопка нужна, если отчёт открылся во встроенном окне игры; coach_viewer
   0.27 и новее). Ссылка на отчёт открывается где угодно, мод не нужен.
5) Закрыть окно игры с отчётом — Esc или «✕ Закрыть».

Отметка «np: …» у боя: «сырые» — данные замера связи есть, всё в порядке;
«не закончен» — игра закрылась посреди боя (отчёт соберётся без разбора
выстрелов); «нет» — замера не было (например, netprobe не загрузился).


8. ЧТО УХОДИТ НА СЕРВЕР
-----------------------
  * АВТОМАТИЧЕСКИ, в начале боя: список участников -- ID аккаунтов и танки,
    без ников -- для подсчёта силы команд (только ВГ).
  * АВТОМАТИЧЕСКИ, раз в сутки: проверка, не вышел ли новый набор.
  * АВТОМАТИЧЕСКИ: ошибки наших модов (из журналов модов и python.log,
    только строки наших модов), без ников других игроков. Отправляет
    страница TankCoach, пока она открыта. Отключить: «сообщить о проблеме /
    идея» -> галочка «автоматически отправлять ошибки мода».
  * ПО КНОПКЕ «Собрать»: файлы только этого боя — позиции и курсы машин,
    засвет, выстрелы, попадания, урон, броня, замеры связи, итоги боя и
    состав боя (список участников, как в итогах).
  * ПО ГАЛОЧКЕ в окне «сообщить о проблеме»: хвосты журналов модов (имя
    пользователя Windows в путях заменяется на <user>; перед отправкой можно
    посмотреть, что уйдёт — «что уйдёт?») и до 3 скриншотов из папки
    screenshots игры, которые ты сам отметил.
  * Сами моды в интернет ничего не отправляют — отправляет страница TankCoach
    в браузере, и только по этим правилам.


9. ПРИВАТНОСТЬ
--------------
  * Разработчик видит отчёты боёв тестеров — чтобы находить ошибки и улучшать
    сервис.
  * У разработчика (VasiliyM) есть доступ администратора к серверу: он видит
    список всех боёв тестеров, их отчёты, отзывы и сбои сборки. Просмотры
    записываются в журнал сервера.
  * Данные не передаются третьим лицам.
  * Ники в аналитике не хранятся. (Сами файлы боя содержат состав боя, как
    в итогах боя, — они нужны, чтобы собрать отчёт; в сводки и статистику
    ники не попадают.)
  * Удалить свои данные: напиши на privacy@tankcoach.net (укажи ник и дату
    боёв, если нужно удалить только часть).
  * Описание данных на сайте: tankcoach.net/privacy/


10. ОБРАТНАЯ СВЯЗЬ И ПРОБЛЕМЫ
-----------------------------
  * Страница TankCoach -> «✉ сообщить о проблеме / идея» (и значок ✉ у каждого
    боя) и кнопка «✉ Сообщить о проблеме» в каждом отчёте. Выбери «проблема /
    идея / другое», напиши пару слов. Бой, версии модов, клиент, язык
    прикладываются сами.
  * Журналы и скриншоты — только по галочке (см. п. 8). Если не уверен —
    не ставь.
  * Под каждым вердиктом в отчёте могут быть кнопки «верно / неверно» — они
    помогают проверить разбор; жми по делу.
  * Можно и просто написать в Telegram: t.me/tankcoach.
  * Самое полезное: «в этом бою на выстреле №N отчёт говорит …, а на деле …»
    + номер боя (адрес отчёта).


11. ЕСЛИ НЕ РАБОТАЕТ
--------------------
Открой папку Netprobe_mod_result (рядом с игрой). В журналах должны быть строки:
  netprobe_track.log   «netprobe_track 2.43 by VasiliyM loaded»
  netprobe.log         «netprobe 7.02 by VasiliyM loaded»
  coach_viewer.log     «coach_viewer 0.42 loaded (zagruzhen)…»
Нет строки -> мод не загрузился: проверь путь из п. 3 (самая частая ошибка —
лишняя или пропущенная папка) и номер папки версии (п. 4). Не помогло —
пришли эти три журнала автору.
  * Страница не открывается — см. п. 6. Страница пишет «сервер недоступен» —
    сервер проекта стоит на домашнем оборудовании автора, бывают перерывы:
    бой НЕ пропадает (файлы у тебя), нажми «Собрать» позже.
  * Лимит загрузок за сутки — страница скажет «лимит исчерпан»; подожди до
    завтра.
  * Много ошибок модов в python.log — пришли python.log из папки игры.


12. ИЗВЕСТНЫЕ ОГРАНИЧЕНИЯ (это тестовая версия)
-----------------------------------------------
  * Полоса «закрыто ниже N м» (препятствия на линии выстрела) — грубая: боковое
    укрытие не видно, оценка по рельефу и силуэту, ближе ~7 м силуэта цели
    нет. Не принимай её за точный ответ.
  * Часть разделов отчёта в разработке: «Разбор» выстрела (анимация), зоны
    пробития по броне, 3D-вид, разбор попаданий по тебе. Что-то может быть
    пустым, примерным («оценка») или отличаться от того, что ты видел.
  * Случайный бросок пробития клиент не присылает — отчёт показывает границу
    («пробил при выпавшем не ниже …»), а не сам бросок. Фугасы и осколки —
    оценка.
  * 3D (WebGL) нужен GPU в браузере: во внешнем браузере работает; во
    встроенном окне обычного клиента — может не работать (тогда статичная
    картинка).
  * ВГ: стоковый клиент ещё проверяется на нашей странице — если что-то
    выглядит криво во встроенном окне, открой то же во внешнем браузере и
    сообщи, чем отличается.
  * Отчёт строится от секунд до нескольких минут (очередь на сервере).
  * Сервер один и небольшой: если пришлёшь десятки боёв подряд, часть станет
    в очередь. Присылай боевые бои, а не весь архив.
  * Просмотр реплеев — это не бой; собирать для отчёта нужно реальные бои.


автор VasiliyM · t.me/tankcoach
