﻿TankCoach — набор тестера, Мир танков (Lesta)                11.11.2026
==============================================================================
Автор: VasiliyM · Telegram: t.me/tankcoach · Конфиденциальность: privacy@tankcoach.net
Язык: RU (English version: README_EN.txt)


1. ЧТО ЭТО
---------
Три мода — в одном файле net.tankcoach.mod_2026.11.11.1.mtmod. Вместе они дают разбор боя на сервере проекта (https://ru.tankcoach.net):

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

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


2. ЧТО НУЖНО
------------
  * Мир танков (Lesta), версия клиента 1.46.0.0 (набор собран под неё).
  * Заявка не нужна: первый собранный бой сам создаёт вход (см. п. 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) Найди папку игры — ту, где лежит Tanki.exe. Обычно в лаунчере у игры есть
   пункт «Показать в папке» (шестерёнка рядом с кнопкой «Играть»); либо
   открой путь установки игры вручную.
3) Открой файл version.xml в этой папке (Блокнотом): там строка вида
   <version> v.1.46.0.0 #… </version>. Запомни номер — 1.46.0.0.
4) Распакуй архив. Скопируй ВСЕ файлы из папки набора  install\mods\1.46.0.0
   в папку  <папка игры>\mods\1.46.0.0\  (с заменой, если спросит). Главный файл —
   наш мод одним файлом:

     mods\1.46.0.0\net.tankcoach.mod_2026.11.11.1.mtmod

   Остальные .mtmod рядом с ним — общие библиотеки меню модов (кнопка списка
   модов и окно настроек). Если такие же или более новые уже стоят — их не копируй.
5) Если раньше стояла прежняя версия TankCoach — убери её, иначе мод загрузится
   дважды: другие файлы net.tankcoach.mod_*.mtmod из mods\1.46.0.0\ и наши старые
   файлы из res_mods\1.46.0.0\ (scripts\client\gui\mods\mod_netprobe_track.pyc,
   mod_netprobe.pyc, mod_coach_viewer.pyc и папка gui\maps\netprobe).
   Установщик (TankCoach_install.bat) делает это сам и кладёт старое в TankCoach_backup.
6) Запусти игру. Проверка: через минуту в папке Netprobe_mod_result должны
   появиться журналы (см. п. 11).

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


5. УДАЛЕНИЕ
-----------
Закрой игру. Удали файл mods\1.46.0.0\net.tankcoach.mod_2026.11.11.1.mtmod — это весь мод. Библиотеки меню
модов (остальные .mtmod) можно оставить: ими пользуются и другие моды. Папку
Netprobe_mod_result (файлы твоих боёв) можно удалить или оставить; файл
netprobe_track_config.json в папке игры — тоже можно удалить.


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

 В Мире танков встроенный браузер игры наши страницы не пускает (белый список
 Lesta), поэтому мод сам открывает страницу в твоём обычном браузере Windows —
 просто подожди пару секунд после Ctrl+Shift+R. Окно браузера может оказаться
 под игрой: Alt+Tab.
 Если браузер не открылся — открой его сам и введи адрес
     http://127.0.0.1:18765/server
 (127.0.0.1 — твой компьютер; страницу отдаёт мод, пока идёт игра; если порт
 занят, он сдвигается до 18774 — адрес в Netprobe_mod_result\coach_viewer.log,
 строка «server: http://127.0.0.1:…/»).
 Отчёт откроется в том же окне браузера.


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


Настройки в ангаре: кнопка списка модов внизу справа ->
  «TankCoach — настройки»: что показывать в бою (шкала связи, полоса выстрелов,
  квадрат лага, пинг цифрами, круги и точка снаряда после выстрела; выключатель
  раздела убирает всё сразу; действует со следующего боя);
  «TankCoach — мои бои»: ваши бои на сайте (откроется в браузере).
  Те же галочки — на странице мода (Ctrl+Shift+R). Кнопку списка модов и окно
  настроек ставит установщик (две библиотеки, см. THIRD_PARTY_LICENSES.txt).


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


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

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


8. ЧТО УХОДИТ НА СЕРВЕР
-----------------------
  * АВТОМАТИЧЕСКИ, раз в сутки: проверка, не вышел ли новый набор.
  * АВТОМАТИЧЕСКИ: ошибки наших модов (из журналов модов и 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.05 by VasiliyM loaded»
  coach_viewer.log     «coach_viewer 0.49 loaded (zagruzhen)…»
Нет строки -> мод не загрузился: проверь путь из п. 3 (самая частая ошибка —
лишняя или пропущенная папка) и номер папки версии (п. 4). Не помогло —
пришли эти три журнала автору.
  * Страница не открывается — см. п. 6. Страница пишет «сервер недоступен» —
    сервер проекта стоит на домашнем оборудовании автора, бывают перерывы:
    бой НЕ пропадает (файлы у тебя), нажми «Собрать» позже.
  * Лимит загрузок за сутки — страница скажет «лимит исчерпан»; подожди до
    завтра.
  * Много ошибок модов в python.log — пришли python.log из папки игры.

13. ДОСТУП ИЗ РОССИИ (Мир танков)
--------------------------------
Адрес сервера для Мира танков — https://ru.tankcoach.net (запасной —
ru2.tankcoach.net, страница переключится на него сама и напишет «запасной
адрес»). У ряда российских провайдеров (в т.ч. мобильных) иностранные адреса
открываются плохо или не открываются: страница TankCoach пишет «сервер
недоступен», «Собрать» зависает, отчёт не грузится.
  * Сама игра и моды при этом работают как обычно, файлы боёв лежат у тебя —
    ничего не теряется.
  * Проверь: открой в браузере https://ru.tankcoach.net/ . Открылась главная,
    но «Собрать» висит — это тот самый случай (маленькие страницы проходят,
    большие нет).
  * Что делать: напиши автору в Telegram (t.me/tankcoach, личные сообщения) —
    подскажу способ открыть отчёт у тебя. Пока не решили — копи бои, потом
    соберёшь пачкой. Для ускорения напиши название провайдера и тип связи
    (домашний / мобильный).


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


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