User ManualПосібник користувача

Getting StartedПочаток роботи

WotStreamPlus is a streaming companion for World of Tanks. It reads your battle results in real time and pushes live overlay data to OBS Studio or generates standalone HTML widgets for any streaming software.

WotStreamPlus — стримінговий помічник для World of Tanks. Програма зчитує результати боїв у реальному часі та передає живі дані оверлея до OBS Studio або генерує автономні HTML-віджети для будь-якого програмного забезпечення для стримінгу.

First LaunchПерший запуск

On first run, open the Settings tab and click Browse to point the app at your World of Tanks installation folder. The app uses this folder to read replays and to keep the required game mod up to date. That's the only setup required — there is no account to create and nothing to sign in to.

Під час першого запуску відкрийте вкладку Налаштування та натисніть Огляд, щоб вказати програмі папку гри World of Tanks. Програма використовує цю папку для зчитування реплеїв та оновлення необхідного мода гри. Це єдине потрібне налаштування — немає ні облікового запису, ні входу.

What You See on First LaunchЩо видно при першому запуску

WotStreamPlus is free, with no login and no subscription. Every tab — Statistics, Onslaught, Ladder, Versus, Settings, and About — is available immediately, with no plan or expiry to worry about.

WotStreamPlus безкоштовний, без входу та без підписки. Усі вкладки — Статистика, Натиск, Сходинки, Versus, Налаштування та Про програму — доступні одразу, без плану чи терміну дії.

Battle Statistics TrackerТрекер бойової статистики

The Statistics tab tracks your performance across battles in a single streaming session and displays the results on your overlay in real time.

Вкладка Статистика відстежує вашу ефективність у боях протягом одного стримінгового сеансу та відображає результати на оверлеї в реальному часі.

Starting a SessionПочаток сеансу

Click Start in the Statistics tab. The app begins monitoring your most recent replay files. Play a battle in World of Tanks — once the battle ends the results appear on the overlay automatically. No manual steps are required between battles.

Натисніть Старт у вкладці Статистика. Програма починає відстежувати ваші останні реплеї. Зіграйте бій у World of Tanks — щойно бій завершиться, результати автоматично з'являться на оверлеї. Жодних ручних дій між боями не потрібно.

What Is TrackedЩо відстежується

For each battle the app records:

Для кожного бою програма записує:

• Damage dealt — direct damage to enemy vehicles
• Завдана шкода — пряма шкода ворожим машинам
• Assisted damage — radio (spotting), track, and stun assists combined
• Шкода допомогою — засвітка, гусениця та приголомшення разом
• Kills — number of enemy vehicles destroyed
• Знищення — кількість знищених ворожих машин
• Credits earned — gross credits and net credits after shell costs
• Зароблені кредити — валові кредити та чисті кредити після витрат на снаряди
• Result — win or loss
• Результат — перемога або поразка

The overlay also shows running session totals and averages for damage and kills that update after every battle.

Оверлей також показує поточні підсумки сеансу та середні значення шкоди й знищень, що оновлюються після кожного бою.

Configuring FieldsНалаштування полів

Open the field configuration panel to choose which statistics appear on your overlay. Any field can be hidden, and you can drag fields into the order that suits your stream layout best.

Відкрийте панель налаштування полів, щоб вибрати, яка статистика відображається на оверлеї. Будь-яке поле можна приховати, а поля можна перетягувати у зручний для вашого стриму порядок.

Squad ModeРежим взводу

Enable Squad mode to break the overlay down by squad member rather than showing only session totals. Each player in your squad gets their own row with individual damage, kills, and other tracked metrics.

Увімкніть режим взводу, щоб розбити оверлей за членами взводу замість відображення лише підсумків сеансу. Кожен гравець у вашому взводі отримує окремий рядок з індивідуальними показниками шкоди, знищень та іншою статистикою.

Victory and Kill BonusesБонуси за перемоги та знищення

If you run a custom points system on stream you can assign a bonus multiplier to wins and to kills. The bonus is added on top of the raw damage value in the session total, letting you display a custom score rather than plain damage numbers.

Якщо ви використовуєте власну систему очок у стримі, ви можете призначити бонусний множник за перемоги та знищення. Бонус додається до значення шкоди в підсумку сеансу, дозволяючи відображати власний рахунок замість простих цифр шкоди.

Pausing and ResumingПауза та продовження

Click Pause to stop recording new battles without losing the current session history. A time marker is inserted in the battle log at the point you paused — useful for marking stream breaks. Click Resume to continue tracking from where you left off.

Натисніть Пауза, щоб зупинити запис нових боїв, не втрачаючи поточну історію сеансу. У журнал боїв вставляється часова мітка в точці паузи — зручно для позначення перерв у стримі. Натисніть Продовжити, щоб відновити відстеження з того місця, де зупинилися.

Battle HistoryІсторія боїв

The battle history panel lists every battle recorded in the session:

Панель історії боїв показує кожен бій, записаний у сеансі:

• Battle number and date/time
• Номер бою та дата/час
• Map name
• Назва карти
• Tank used
• Використана машина
• Damage dealt
• Завдана шкода

To remove a battle click the delete button next to it. Session totals and averages recalculate instantly.

Щоб видалити бій, натисніть кнопку видалення поруч із ним. Підсумки та середні значення сеансу миттєво перераховуються.

Grid LayoutСітчастий макет

Toggle Grid layout to switch the overlay to a compact, column-based display. This is useful when screen space is limited or when you want a more structured look on your stream.

Увімкніть Сітчастий макет, щоб перемкнути оверлей на компактне відображення у вигляді стовпців. Це корисно, коли місця на екрані мало або ви хочете більш структурованого вигляду на стримі.

Onslaught Rating TrackerТрекер рейтингу Натиску

The Onslaught tab tracks your competitive Onslaught mode rating and displays it as a live overlay throughout your streaming session.

Вкладка Натиск відстежує ваш рейтинг у конкурентному режимі Натиск та відображає його на живому оверлеї протягом усього стримінгового сеансу.

What Is DisplayedЩо відображається

The overlay shows:

Оверлей показує:

• Current rank and division
• Поточний ранг та дивізіон
• Rating points
• Рейтингові очки
• Session boost status — whether a boost is currently active
• Статус прискорення сеансу — чи активне прискорення наразі
• Qualification indicator — shown when you are in a qualification phase working toward the next rank
• Індикатор кваліфікації — відображається, коли ви перебуваєте у кваліфікаційній фазі на шляху до наступного рангу

Battle HistoryІсторія боїв

The last 5 Onslaught battles are shown below the rating display. Each row includes the map name, the point change from that battle (positive or negative), and the rank and division you reached after the battle.

Нижче під відображенням рейтингу показані останні 5 боїв Натиску. Кожен рядок містить назву карти, зміну очок у цьому бою (позитивну або негативну) та ранг і дивізіон, досягнуті після бою.

Persistence Between SessionsЗбереження між сеансами

Your last known rating and point total are saved when you close the app. On the next launch the tracker restores that baseline, so it always starts from the correct point rather than waiting for the next battle to establish context.

Ваш останній відомий рейтинг та загальна кількість очок зберігаються при закритті програми. При наступному запуску трекер відновлює цю базову точку, тому завжди починається з правильного значення, не чекаючи наступного бою.

Rank IconsЗначки рангу

Rank icons are displayed on the overlay alongside your current rank. They are kept up to date automatically whenever the game updates.

Значки рангу відображаються на оверлеї поряд із вашим поточним рангом. Вони автоматично оновлюються при кожному оновленні гри.

OBS Studio IntegrationІнтеграція з OBS Studio

WotStreamPlus can push live data directly into your OBS scene so your overlay updates automatically without any browser refreshes or manual copy-paste.

WotStreamPlus може передавати живі дані безпосередньо до вашої сцени OBS, тому оверлей оновлюється автоматично без жодного оновлення браузера або ручного копіювання.

PrerequisitesПередумови

Before connecting, enable the WebSocket server inside OBS:

Перед підключенням увімкніть WebSocket-сервер в OBS:

1. In OBS, open Tools → WebSocket Server Settings.
2. В OBS відкрийте Інструменти → Налаштування WebSocket-сервера.
3. Enable the server and note the port number (default is 4455).
4. Увімкніть сервер та запишіть номер порту (за замовчуванням 4455).
5. Optionally set a password to protect the connection.
6. За бажанням встановіть пароль для захисту з'єднання.
7. Click OK.
8. Натисніть ОК.

Connecting from WotStreamPlusПідключення з WotStreamPlus

1. Open the Settings tab in WotStreamPlus.
2. Відкрийте вкладку Налаштування у WotStreamPlus.
3. Enter the OBS host (usually localhost), port, and password.
4. Введіть хост OBS (зазвичай localhost), порт та пароль.
5. Click Connect. The connection status updates next to the button.
6. Натисніть Підключити. Статус з'єднання оновлюється поруч із кнопкою.

Text SourcesТекстові джерела

Once connected, the app pushes statistics values to named text sources in your active OBS scene. If a required source does not exist yet it is created automatically. You can reposition and style these text sources freely inside OBS.

Після підключення програма передає значення статистики до іменованих текстових джерел у вашій активній сцені OBS. Якщо необхідне джерело ще не існує, воно створюється автоматично. Ви можете вільно переміщати та стилізувати ці текстові джерела в OBS.

Browser SourcesДжерела браузера

For richer overlay designs, point an OBS browser source at the local widget file generated by WotStreamPlus (see HTML Widgets). The browser source updates live after every battle with no manual refresh needed.

Для складніших дизайнів оверлея вкажіть джерело браузера OBS на локальний файл віджета WotStreamPlus (див. HTML-віджети). Джерело браузера оновлюється після кожного бою без ручного оновлення.

HTML WidgetsHTML-віджети

In addition to OBS text sources, WotStreamPlus can write live data to local HTML files. These files work as browser sources in OBS, Streamlabs, or any other software that supports local browser sources.

Окрім текстових джерел OBS, WotStreamPlus може записувати живі дані до локальних HTML-файлів. Ці файли працюють як джерела браузера в OBS, Streamlabs або будь-якому іншому програмному забезпеченні, що підтримує локальні джерела браузера.

Statistics WidgetВіджет статистики

When the Statistics tracker is running, a widget HTML file is written to the same folder as the WotStreamPlus application. To use it:

Поки трекер статистики працює, HTML-файл віджета записується до тієї самої папки, де знаходиться програма WotStreamPlus. Щоб використати його:

1. In your streaming software, add a new Browser Source.
2. У вашому програмному забезпеченні для стримінгу додайте нове Джерело браузера.
3. Check the option to load from a local file.
4. Виберіть параметр завантаження з локального файлу.
5. Browse to the WotStreamPlus application folder and select the statistics widget file.
6. Перейдіть до папки програми WotStreamPlus та виберіть файл віджета статистики.
7. Set the width and height to match your overlay layout.
8. Встановіть ширину та висоту відповідно до макета вашого оверлея.

The file is updated automatically after each battle. The browser source will reflect the latest results without any manual refresh.

Файл оновлюється автоматично після кожного бою. Джерело браузера відображатиме останні результати без ручного оновлення.

Onslaught WidgetВіджет Натиску

A separate widget file is generated for the Onslaught tracker and saved in the same folder. Follow the same steps above to add it as a second browser source if you want to display both overlays simultaneously.

Для трекера Натиску генерується окремий файл віджета, що зберігається в тій самій папці. Виконайте ті самі кроки вище, щоб додати його як друге джерело браузера, якщо ви хочете відображати обидва оверлеї одночасно.

Ladder ModeРежим драбини

The Ladder tab lets you run a challenge ladder during your stream. You define a sequence of stairs, each with its own goals, and the app tracks your progress automatically as you play — advancing you when you succeed and dropping you back when you run out of retries.

Вкладка Драбина дозволяє проводити викликову драбину під час стриму. Ви визначаєте послідовність сходинок, кожна зі своїми цілями, і програма автоматично відстежує ваш прогрес — просуваючи вас уперед при успіху та повертаючи назад при вичерпанні спроб.

Setting Up StairsНалаштування сходинок

Click Add stair to append a new stair to the ladder. Each stair has four fields:

Натисніть Додати сходинку, щоб додати нову сходинку до драбини. Кожна сходинка має чотири поля:

• Damage goal — the minimum damage required to pass the stair.
• Ціль шкоди — мінімальна шкода, необхідна для проходження сходинки.
• Kill goal — minimum kills required. Leave blank if kills are not required.
• Ціль знищень — мінімальна кількість знищень. Залиште порожнім, якщо знищення не вимагаються.
• Prize — optional label shown on the widget when this stair is active. Use it to display what the viewer wins or what you commit to if you complete or fail the stair.
• Нагорода — необов'язкова мітка, що відображається на віджеті, поки ця сходинка активна. Використовуйте її, щоб показати, що отримає глядач або що ви зобов'язуєтесь зробити при проходженні чи провалі.
• Retries — how many times you may fail this stair before dropping back. Leave blank for unlimited retries. Enter 999 to make this a floor stair (see below).
• Спроби — скільки разів ви можете не виконати цю сходинку перед поверненням назад. Залиште порожнім для необмеженої кількості спроб. Введіть 999, щоб зробити сходинку нижньою межею (детальніше нижче).

Running the LadderЗапуск драбини

Click Start in the Ladder tab. After each battle the app checks your result against the current stair's goals:

Натисніть Старт у вкладці Драбина. Після кожного бою програма перевіряє ваш результат відповідно до цілей поточної сходинки:

• Pass — damage and kills both met. You advance to the next stair.
• Прохід — шкода та знищення виконані. Ви просуваєтесь до наступної сходинки.
• Retry — goals not met, but retries remain. You stay on the same stair.
• Повторна спроба — цілі не виконані, але спроби залишились. Ви залишаєтесь на тій самій сходинці.
• Drop — goals not met and retries exhausted. You fall back to the previous stair.
• Падіння — цілі не виконані, а спроби вичерпані. Ви повертаєтесь на попередню сходинку.

Floor StairsСходинки-нижні межі

Enter 999 in the Retries field to make a stair a floor stair. Once you reach it, failing always keeps you on it — you can never drop below. The widget shows a lock icon (🔒) on the retry counter when the current stair is a floor stair.

Введіть 999 у поле Спроби, щоб зробити сходинку нижньою межею. Досягнувши її, провали завжди залишатимуть вас на ній — ви не зможете впасти нижче. Віджет показує значок замка (🔒) на лічильнику спроб, коли поточна сходинка є нижньою межею.

Ladder WidgetВіджет драбини

While the ladder is running, an HTML widget file is written to the application folder. Add it as a browser source in your streaming software the same way as the Statistics and Onslaught widgets (see HTML Widgets).

Поки драбина запущена, HTML-файл віджета записується до папки програми. Додайте його як джерело браузера у вашому програмному забезпеченні для стримінгу так само, як і віджети Статистики та Натиску (дивіться HTML-віджети).

The widget shows all stairs stacked from bottom to top. The current stair is highlighted with a border and displayed slightly wider than the others so it stands out at a glance. Passed stairs are marked with a check mark. Each stair shows its damage goal, kill goal, prize (if set), and retry count or lock icon in a single line.

Віджет відображає всі сходинки, складені знизу догори. Поточна сходинка виділяється рамкою та відображається трохи ширше за інші, щоб відразу впадати в очі. Пройдені сходинки позначаються галочкою. Кожна сходинка показує ціль шкоди, ціль знищень, нагороду (якщо встановлена) та кількість спроб або значок замка в одному рядку.

HelpДовідка

Click the ? button in the top-right corner of the battle log panel to open a help window with a full description of every Ladder Mode control and how to use the tab.

Натисніть кнопку ? у верхньому правому куті панелі журналу боїв, щоб відкрити вікно довідки з повним описом усіх елементів керування режиму Драбина.

Versus ModeРежим Versus

The Versus tab lets you run head-to-head challenges on stream — player against player, or team against team. You configure who is playing, how rounds are won, and when the match is decided. The results update on your overlay after every battle.

Вкладка Versus дозволяє проводити протистояння під час стриму — гравець проти гравця або команда проти команди. Ви налаштовуєте учасників, умови перемоги у раунді та умови завершення матчу. Результати оновлюються на оверлеї після кожного бою.

Mode SwitcherПеремикач режиму

Choose between two challenge modes at the top of the tab:

Виберіть один із двох режимів виклику у верхній частині вкладки:

• 1 vs 1 — compares one player from each side within the same battle. The app looks for one Side A player and one Side B player in each battle result and compares their individual stats head-to-head.
• 1 vs 1 — порівнює одного гравця з кожної сторони в одному бою. Програма шукає одного гравця Сторони A та одного гравця Сторони B в кожному результаті бою і порівнює їхню індивідуальну статистику.
• Team vs Team — compares two predefined groups of players. Stats for all Side A players found in a battle are summed together and compared against the combined stats of all Side B players in the same battle.
• Команда проти команди — порівнює дві попередньо визначені групи гравців. Статистика всіх гравців Сторони A, знайдених у бою, підсумовується і порівнюється зі зведеною статистикою всіх гравців Сторони B в тому самому бою.

Setting Up Player ListsНалаштування списків гравців

The left panel shows the Side A players and the right panel shows the Side B players. Click + to add a player name, then select a name and click − to remove it. Player names must match the in-game names exactly. Both lists are saved automatically and restored the next time you open the app.

Ліва панель показує гравців Сторони A, а права — гравців Сторони B. Натисніть +, щоб додати ім'я гравця, виберіть ім'я та натисніть −, щоб видалити його. Імена гравців мають точно відповідати ігровим іменам. Обидва списки зберігаються автоматично та відновлюються при наступному відкритті програми.

Team NamesНазви команд

Above each player list there is a name field. Type the label you want to display for that side — a clan tag, a player handle, or any short name. These names appear in the widget scoreboard as column headers above the score tiles. While a session is running the name fields are locked; edit them before clicking Start. Your entries are saved automatically.

Над кожним списком гравців є поле для назви. Введіть мітку, яку хочете відображати для цієї сторони — тег клану, нікнейм або будь-яку коротку назву. Ці назви відображаються у скорборді віджету як заголовки стовпців над плитками рахунку. Поки сеанс запущений, поля назв заблоковані; редагуйте їх до натискання Start. Записи зберігаються автоматично.

Best of NНайкращий з N

Set the Best of value to determine how many rounds it takes to win the match. The first side to win the majority of rounds wins the match. For example, Best of 3 means the first side to win 2 rounds wins. When one side reaches the required wins the session ends automatically.

Встановіть значення Найкращий з, щоб визначити, скільки раундів потрібно для перемоги в матчі. Перша сторона, що виграє більшість раундів, перемагає в матчі. Наприклад, «Найкращий з 3» означає, що перша сторона, яка виграє 2 раунди, перемагає. Коли одна сторона досягає необхідної кількості перемог, сеанс завершується автоматично.

Win RulesПравила перемоги

The center panel lets you configure how each round is decided. Rules are evaluated in order — the first rule that produces a different value between the two sides determines the round winner. If all rules tie, the round is a draw.

Центральна панель дозволяє налаштувати, як визначається переможець у кожному раунді. Правила оцінюються по черзі — перше правило, що дає різне значення для двох сторін, визначає переможця раунду. Якщо всі правила дають нічию, раунд є нічиєю.

• Add Rule — select a stat from the dropdown (Damage, Assisted, Kills, Credits, Win, and so on) and click Add Rule to append it to the rule chain.
• Додати правило — виберіть статистику зі спадного меню (Шкода, Допомога, Знищення, Кредити, Перемога тощо) та натисніть Додати правило, щоб додати її до ланцюжка правил.
• Add Field — select a rule row first, then pick a stat from the dropdown and click + Field. This adds the chosen stat to the selected rule so both fields are summed together before comparison. For example, a single rule containing Damage and Assisted will compare each side's combined damage-plus-assisted value.
• + Поле — спочатку виберіть рядок правила, потім виберіть статистику зі спадного меню та натисніть + Поле. Це додає обрану статистику до вибраного правила, щоб обидва поля підсумовувалися перед порівнянням. Наприклад, правило, що містить Шкоду та Допомогу, порівнює зведене значення шкоди плюс допомога кожної сторони.
• Remove — select a rule row and click Remove to delete it from the chain.
• Видалити — виберіть рядок правила та натисніть Видалити, щоб видалити його з ланцюжка.
• ▲ / ▼ — move the selected rule up or down in priority order.
• ▲ / ▼ — переміщайте вибране правило вгору або вниз у порядку пріоритету.

The Win field has special behaviour: when it is the only field in a rule, the side that won the actual WoT battle wins the round — no numeric comparison is made. When Win is combined with other fields in the same rule, it only contributes bonus points if Count by Points is enabled and the Win × multiplier is greater than 1; otherwise it is ignored in the combination.

Поле Перемога має особливу поведінку: якщо воно є єдиним у правилі, раунд виграє та сторона, яка перемогла у реальному бою в WoT — числове порівняння не відбувається. Коли поле «Перемога» поєднується з іншими полями в одному правилі, воно додає бонусні очки лише якщо увімкнено Рахувати за очками і множник Перемог × більший за 1; інакше воно ігнорується у комбінації.

Count by PointsРахувати за очками

Enable Count by Points to switch from the rule chain to a weighted points formula. Each side earns points equal to their combined Damage, Assisted, and Credits, with Kills and Wins added as bonus multipliers you set in the interface. The side with the higher points total wins the round. When this option is on, the rule chain is ignored.

Увімкніть Рахувати за очками, щоб перейти від ланцюжка правил до зваженої формули очок. Кожна сторона отримує очки, рівні сумі їхньої Шкоди, Допомоги та Кредитів, а Знищення та Перемоги додаються як бонусні множники, що ви встановлюєте в інтерфейсі. Сторона з більшою кількістю очок виграє раунд. Коли цей параметр увімкнено, ланцюжок правил ігнорується.

• Kills × — each kill earns this many extra points.
• Знищення × — кожне знищення дає стільки додаткових очок.
• Win × — this bonus is added when the side won the battle.
• Перемога × — цей бонус додається, коли сторона виграла бій.

Font StyleСтиль шрифту

To the right of the score display, two dropdowns let you choose a font for the widget overlay. The first dropdown lists every font installed on your Windows system. The second lets you pick a size from 12 to 40 px. The chosen font and size apply to both the team name labels and the score digits in the widget. Your selection is saved automatically and restored the next time you open the app.

Праворуч від відображення рахунку два спадні меню дозволяють вибрати шрифт для оверлею віджету. Перше меню містить усі шрифти, встановлені у вашій системі Windows. Друге дозволяє вибрати розмір від 12 до 40 пк. Обраний шрифт і розмір застосовуються як до міток назв команд, так і до цифр рахунку у віджеті. Ваш вибір зберігається автоматично та відновлюється при наступному відкритті програми.

Score and Battle LogРахунок та журнал боїв

The current match score is shown at the top of the tab as A: X — B: Y. Below the player lists a round-by-round log in the application panel shows each battle's map name, the compared values for both sides, the round winner, and the running score after that round.

Поточний рахунок матчу відображається у верхній частині вкладки як A: X — B: Y. Під списками гравців панель журналу у програмі відображає назву карти кожного бою, порівнювані значення для обох сторін, переможця раунду та поточний рахунок після цього раунду.

Versus WidgetVersus-віджет

While a session is running, WotStreamPlus writes a versus-widget.html file to the application folder. Add it as a browser source in your streaming software to display the live scoreboard on stream. The widget uses a three-column layout: the Side A team name and score tile on the left, a glowing golden «VS» separator in the centre, and the Side B team name and score tile on the right. Score tiles have a semi-transparent dark background with a white border; the outer container is fully transparent so your game capture or scene background shows through. The font and size you selected in the tab are applied to both the team name labels and the score digits.

Поки сеанс запущений, WotStreamPlus записує файл versus-widget.html до папки програми. Додайте його як джерело браузера у своєму програмному забезпеченні для стримінгу. Віджет використовує трьохколонкове компонування: назва команди Сторони A та плитка рахунку зліва, золотавий роздільник «VS» із підсвіткою по центру, назва команди Сторони B та плитка рахунку справа. Плитки рахунку мають напівпрозорий темний фон із білою рамкою; зовнішній контейнер повністю прозорий, тому фон гри або сцени просвічується. Шрифт та розмір, обрані у вкладці, застосовуються до міток назв та цифр рахунку.

When OBS Studio output mode is active, a glowing ▼ chevron appears below the scoreboard. Click it to expand the round history log; click again to collapse it. The log stays expanded or collapsed across the widget's 5-second auto-refresh so it does not jump open unexpectedly during a stream. In HTML widget mode the log is not shown — the full round history is visible in the application's battle log panel instead.

Коли активний режим виводу OBS Studio, під скорбордом з'являється підсвічений символ ▼. Натисніть його, щоб розгорнути журнал раундів; натисніть ще раз, щоб згорнути. Стан розгорнуто/згорнуто зберігається між автоматичними оновленнями віджету кожні 5 секунд. У режимі HTML-віджета журнал не відображається — повна історія раундів доступна у панелі журналу боїв у програмі.

The centre column shows BO{N} (e.g. BO3, BO5) directly below the VS text to indicate the series format. When a side is one win away from clinching the match the widget switches to a glowing MATCH POINT label; when both sides are simultaneously one win away the label reads DECIDER. The label disappears once the match is decided. Both labels are displayed in the language set in the app.

Центральна колонка відображає BO{N} (наприклад BO3, BO5) безпосередньо під текстом VS, вказуючи формат серії. Коли одна сторона на одну перемогу від перемоги у матчі, віджет перемикається на підсвічений напис МАТЧ ПОІНТ; коли обидві сторони одночасно на одну перемогу — напис стає ДЕСАЙДЕР. Напис зникає після завершення матчу. Обидва написи відображаються мовою, встановленою у програмі.

The widget auto-refreshes every 5 seconds. If you use OBS Studio with the WebSocket connection active, scores update immediately without any page reload after each round.

Віджет автоматично оновлюється кожні 5 секунд. Якщо ви використовуєте OBS Studio з активним підключенням WebSocket, рахунки оновлюються миттєво без жодного перезавантаження сторінки після кожного раунду.

HelpДовідка

Click the ? button in the bottom toolbar of the Versus tab to open a help window with a description of every control and how to use the tab.

Натисніть кнопку ? на нижній панелі вкладки Versus, щоб відкрити вікно довідки з описом усіх елементів керування та інструкцією з використання вкладки.

SettingsНалаштування

All persistent configuration is available in the Settings tab.

Усі постійні налаштування доступні у вкладці Налаштування.

World of Tanks PathШлях до World of Tanks

Click Browse to select your WoT installation folder. The app detects and displays the installed game version next to the path. This path is required for replay monitoring and automatic mod updates — if it is not set, tracking will not work.

Натисніть Огляд, щоб вибрати папку встановлення WoT. Програма визначає та відображає встановлену версію гри поруч із шляхом. Цей шлях необхідний для моніторингу реплеїв та автоматичного оновлення модів — якщо його не встановлено, відстеження не працюватиме.

OBS ConnectionПідключення до OBS

Enter the OBS WebSocket host, port, and password, then click Connect. The connection status is shown next to the button. Enable Auto-connect to connect automatically on app startup.

Введіть хост WebSocket OBS, порт та пароль, потім натисніть Підключити. Статус з'єднання відображається поруч із кнопкою. Увімкніть Авто-підключення для автоматичного підключення при запуску програми.

Minimize to TrayЗгорнути у системний лоток

When this option is enabled, clicking the window's close button minimizes WotStreamPlus to the system tray instead of exiting. The app continues running in the background — overlay data keeps updating, OBS stays connected, and all tracking continues uninterrupted. Click the tray icon to restore the window.

Коли цей параметр увімкнено, натискання кнопки закриття вікна згортає WotStreamPlus у системний лоток замість виходу. Програма продовжує працювати у фоновому режимі — дані оверлея оновлюються, OBS залишається підключеним, а всі відстеження тривають безперебійно. Натисніть значок у лотку, щоб відновити вікно.

LanguageМова

Select English or Українська from the language selector. The change applies immediately across the entire interface with no restart required.

Виберіть English або Українська у селекторі мови. Зміна застосовується негайно по всьому інтерфейсу без необхідності перезапуску.

YouTube IntegrationІнтеграція YouTube

The YouTube tab connects WotStreamPlus to your YouTube channel while you are live. It shows your stream's like count and concurrent viewer count in the app, writes a live stats widget for OBS, and runs a chat command system that lets viewers spend earned XP on sound effects played through your stream.

Вкладка YouTube підключає WotStreamPlus до вашого каналу YouTube під час прямого ефіру. Програма відображає кількість лайків і одночасних глядачів, записує живий віджет статистики для OBS та запускає систему команд чату, що дозволяє глядачам витрачати зароблений XP на звукові ефекти у стримі.

Connecting Your ChannelПідключення каналу

Open the YouTube tab and click Connect YouTube. Your default browser opens to Google's OAuth consent screen. Sign in with the Google account that owns your YouTube channel and grant the requested read-only access. Once you approve, the browser closes the redirect automatically and the app shows Connected.

Відкрийте вкладку YouTube і натисніть Підключити YouTube. Ваш браузер за замовчуванням відкриється на сторінці підтвердження OAuth Google. Увійдіть за допомогою облікового запису Google, якому належить ваш YouTube-канал, і надайте запитаний доступ лише для читання. Після підтвердження браузер автоматично завершить перенаправлення, а програма покаже Підключено.

• The connection is remembered across sessions — you will not need to re-authenticate unless you click Disconnect or revoke access from your Google account settings.
• З'єднання зберігається між сеансами — повторна автентифікація не потрібна, якщо ви не натиснете Відключити або не скасуєте доступ у налаштуваннях Google.
• The app detects your active live stream automatically on connect. If no stream is currently live, the tab shows No active live stream found — start your stream first, then reconnect.
• Програма автоматично виявляє ваш активний прямий ефір при підключенні. Якщо ефір не активний, вкладка показує Активний прямий ефір не знайдено — спочатку розпочніть ефір, потім підключіться знову.
• To disconnect, click Disconnect. This revokes the stored token and stops all polling immediately.
• Щоб відключитися, натисніть Відключити. Це скасовує збережений токен і негайно зупиняє все опитування.

Live Stats WidgetВіджет живої статистики

Once connected to an active stream, the app displays the current like count and concurrent viewer count. These update on the interval set by the Poll interval (s) field (default 15 s, minimum 10 s). At the same time, the app writes a youtube-widget.html file to the WotStreamPlus data folder that refreshes itself every 5 seconds.

Після підключення до активного ефіру програма відображає поточну кількість лайків і одночасних глядачів. Вони оновлюються з інтервалом, встановленим у полі Інтервал опитування (с) (за замовчуванням 15 с, мінімум 10 с). Водночас програма записує файл youtube-widget.html до папки даних WotStreamPlus, який автоматично оновлюється кожні 5 секунд.

To show it as an overlay in OBS:

Щоб відобразити його як оверлей в OBS:

1. Click Copy next to the widget path field to copy the file path.
2. Натисніть Copy поруч із полем шляху до віджета, щоб скопіювати шлях до файлу.
3. In OBS, add a Browser Source. Check Local file and paste the copied path.
4. В OBS додайте Browser Source. Увімкніть Local file та вставте скопійований шлях.
5. Set the source size to 360 × 120.
6. Встановіть розмір джерела 360 × 120.

If you use OBS mode (the radio button in the tab), the app also creates a browser source named WotStream_YouTube directly in your current OBS scene at the same size.

Якщо ви використовуєте режим OBS (перемикач у вкладці), програма також автоматично створює джерело браузера з назвою WotStream_YouTube у вашій поточній сцені OBS того ж розміру.

Chat CommandsКоманди чату

While a live stream is active, WotStreamPlus polls your stream's live chat for commands. Any viewer who types a command in chat triggers it — no sign-up or account linking is required.

Поки ефір активний, WotStreamPlus відстежує живий чат вашого стриму на наявність команд. Будь-який глядач, який вводить команду в чаті, активує її — реєстрація або прив'язка облікового запису не потрібна.

XP SystemСистема XP

Viewers earn XP after each World of Tanks battle you finish — regardless of the outcome. Any viewer who sent at least one chat message since your previous battle receives the configured XP amount. Set how much XP is awarded per battle using the XP per battle field in the YouTube tab (default: 10, range: 1–999).

Глядачі отримують XP після кожного завершеного вами бою в World of Tanks — незалежно від результату. Кожен глядач, який надіслав хоча б одне повідомлення в чаті з часу попереднього бою, отримує налаштовану кількість XP. Встановіть кількість XP за бій у полі XP за бій у вкладці YouTube (за замовчуванням: 10, діапазон: 1–999).

Command ReferenceДовідник команд

Sound Library SetupНалаштування бібліотеки звуків

Follow these steps to enable !sound commands:

Виконайте ці кроки, щоб увімкнути команди !sound:

1. Prepare a sounds folder — create a folder anywhere on your PC and add .mp3 or .wav files to it. File names become the default command names.
2. Підготуйте папку зі звуками — створіть папку будь-де на ПК та додайте до неї файли .mp3 або .wav. Назви файлів стають назвами команд за замовчуванням.
3. Point the app to it — in the YouTube tab, click Browse next to Sounds folder and select your folder. The app scans it and populates the sound list below.
4. Вкажіть шлях у програмі — у вкладці YouTube натисніть Огляд поруч із Папка звуків і виберіть папку. Програма просканує її та заповнить список звуків нижче.
5. Configure each sound — in the sound list, edit the Name column to set the display name viewers type in chat (e.g. !sound hype), and edit the XP Cost column to set how much XP the command costs. Changes save automatically.
6. Налаштуйте кожен звук — у списку звуків відредагуйте стовпець Назва, щоб встановити ім'я, яке глядачі вводять у чаті (наприклад !sound hype), і стовпець Вартість XP. Зміни зберігаються автоматично.
7. Add the OBS media source — WotStreamPlus controls sound playback through a single OBS Media Source named exactly WotStream_Sounds. Create it once:
   1. In OBS, right-click your scene → Add → Media Source.
   2. Name it WotStream_Sounds (exact spelling, case-sensitive).
   3. Uncheck Loop and uncheck Restart playback when source becomes active.
   4. Leave the file path blank — the app sets it automatically when a command fires.
   5. Click OK. The source does not need to be visible on screen; it can sit in any scene and will still play audio.
8. Додайте медіаджерело OBS — WotStreamPlus керує відтворенням через одне медіаджерело OBS з точною назвою WotStream_Sounds. Створіть його один раз:
   1. В OBS клацніть правою кнопкою на сцені → Додати → Media Source.
   2. Назвіть його WotStream_Sounds (точна назва з урахуванням регістру).
   3. Зніміть прапорці Loop і Restart playback when source becomes active.
   4. Залиште шлях до файлу порожнім — програма встановлює його автоматично під час виконання команди.
   5. Натисніть OK. Джерело не обов'язково показувати на екрані; воно може знаходитись у будь-якій сцені та відтворювати звук.
9. Test it — while you are live, type !sound <name> in your own chat. The bot should reply with a confirmation and the sound should play through OBS within a few seconds.
10. Перевірте — поки ви в ефірі, введіть !sound <назва> у власному чаті. Бот має відповісти підтвердженням, а звук відтворитися через OBS протягом кількох секунд.

TroubleshootingУсунення проблем

• No active live stream found — your stream must already be live before you click Connect. Start streaming in OBS first, wait for YouTube to confirm the stream is live, then connect.
• Активний прямий ефір не знайдено — ваш ефір має бути активним до натискання «Підключити». Спочатку розпочніть стрімінг в OBS, зачекайте, поки YouTube підтвердить активний ефір, потім підключайтесь.
• Sound doesn't play — verify that the OBS source is named exactly WotStream_Sounds (case-sensitive) and that OBS WebSocket is connected. The app shows a one-time warning in the status bar if it cannot find the source.
• Звук не відтворюється — переконайтеся, що джерело OBS називається точно WotStream_Sounds (з урахуванням регістру) і що OBS WebSocket підключено. Програма показує одноразове попередження у рядку стану, якщо джерело не знайдено.
• YouTube quota reached — the daily API quota has been exhausted. It resets at midnight Pacific Time. In the meantime, likes and chat commands stop updating. Increasing the poll interval before the next session reduces daily quota consumption.
• Ліміт YouTube вичерпано — денна квота API вичерпана. Вона скидається опівночі за тихоокеанським часом. Тим часом лайки та команди чату не оновлюються. Збільшення інтервалу опитування перед наступним сеансом зменшить щоденне споживання квоти.
• Viewer sees "not enough XP" — the viewer needs to be active in chat during more battles to accumulate enough XP. Their balance increases automatically after each battle you finish.
• Глядач бачить "not enough XP" — глядачеві потрібно бути активним у чаті під час більшої кількості боїв для накопичення XP. Баланс автоматично збільшується після кожного завершеного вами бою.
• Commands not responding — confirm the YouTube tab shows Connected and a live stream was detected. If the stream ended mid-session, disconnect and reconnect to pick up a new stream.
• Команди не реагують — переконайтеся, що вкладка YouTube показує Підключено і виявлено прямий ефір. Якщо ефір завершився під час сеансу, відключіться та підключіться знову, щоб виявити новий ефір.