https://github.com/drizzer14/moe-calculator

https://github.com/drizzer14/moe-calculator

worldoftanks wot wotmod

Last synced: 4 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/drizzer14/moe-calculator
• Owner: drizzer14
• License: other
• Created: 2026-07-08T08:18:03.000Z (16 days ago)
• Default Branch: main
• Last Pushed: 2026-07-20T17:54:57.000Z (4 days ago)
• Last Synced: 2026-07-20T23:38:13.148Z (4 days ago)
• Topics: worldoftanks, wot, wotmod
• Language: Python
• Homepage: https://wgmods.net/7745/
• Size: 6.38 MB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# 14th_ua's MoE Calculator — World of Tanks mod

Track your **Marks of Excellence (MoE)** progress for the vehicle you have selected,

in the Garage and live in battle. The mod reads the game's own MoE data and renders it

with the client's own mark art and interface styling, so it looks like a built-in part

of the interface rather than an add-on.

**English** · [Українська](#14th_uas-moe-calculator--українська)

|  |  |

|:--:|:--:|

| ![Garage MoE bar](assets/screenshots/garage.png) | ![In-battle MoE overlay](assets/screenshots/battle.png) |

| Garage MoE bar | In-battle overlay |

## What it shows

### Garage MoE bar

A percentile bar in the vehicle-parameters panel with milestone ticks at **65% / 85% /

95%** — the 1 / 2 / 3-mark thresholds — each drawn with the client's own mark art. Every

tick is labelled with the combined damage that mark requires, and the bar fills to your

current standing. Above it, a readout shows your current average combined damage and your

current mark percentage for the selected vehicle.

### In-battle overlay

A compact overlay over the HUD with two lines (an optional third row shows counted

assistance — see Settings):

- **Live combined damage vs your projected average** — the number is coloured by sign

  (red below your projection, white at it, green above).

- **Your projected MoE percentage** with the signed change versus where you started the

  battle.

## Compatibility

| Requirement | Detail |

|-------------|--------|

| **Game** | World of Tanks **EU 2.3.1.0** (Wargaming global client). Built and tested against this version. |

| **Required** | **OpenWG GameFace** 1.1.6+ — install it first, or the widget will not appear. From [wgmods.net](https://wgmods.net) or [gitlab.com/openwg/wot.gameface](https://gitlab.com/openwg/wot.gameface). |

## Download & install

**Easiest — the one-click installer (Windows).** Download the latest

**`MoECalculator-Setup-.exe`** from the

[**GitHub Releases**](https://github.com/drizzer14/moe-calculator/releases) page and run

it (close the game first). It finds your World of Tanks folder, installs the mod into

`mods\\`, and adds its bundled dependencies — **OpenWG GameFace**,

**ModsSettingsAPI**, and **ModsList** — for any you don't already have. On each

run it also checks GitHub and offers to fetch the newest

installer, so a copy you keep around stays current.

**Manual installation.** Grab `com.14th_ua.moe_calculator_.wotmod` from the same

Releases page and follow **[`INSTALL.md`](./INSTALL.md)** — it covers the manual copy,

verifying it works, troubleshooting, and uninstalling.

## Settings

The mod adds a settings panel to the in-game **mod-settings menu**, provided by

**ModsSettingsAPI (MSA)** — the standard settings host bundled with the installer. If MSA

isn't loaded, the mod still runs with both widgets on by default; you just won't see the panel.

The panel has two columns:

**In-Battle Widget** *(on by default)* — shows the live MoE overlay during battle. Uncheck to

hide it and disable the two options below. When it's on, these become available:

- **Show on Alt Key** *(off by default)* — shows the in-battle overlay only while the **Alt**

  key is held. When off, the overlay is shown at all times.

- **Counted Assistance** *(off by default)* — adds a third row to the battle overlay showing

  your counted assistance: the higher of tracking, spotting or stun assist, with an icon for

  whichever is leading.

**In-Garage Widget** *(on by default)* — shows the MoE percentile bar in the Garage, on the

selected vehicle. Uncheck to hide it.

## Notes

- **After a game update**, move the `.wotmod` to the new `mods\\` folder. A new

  client version may need a rebuilt mod — check the Releases page.

## MoE data source

The per-tank mark thresholds (the combined damage each mark needs) come from the **official

Wargaming API** — the real damage distribution, so the numbers are authoritative and current.

Thresholds are cached locally so switching vehicles is instant.

## Modpacks & license

Free to use, redistribute, and include in modpacks as long as it stays free and credits the

author (**14th_ua**) with a link back to this repository — see [`LICENSE.md`](./LICENSE.md).

For modpacks, add only the `.wotmod` and list OpenWG GameFace as a required dependency; don't

bundle GameFace yourself.

## Contributing / developers

Building, deploying, testing, and the repo layout are documented in

[`CLAUDE.md`](./CLAUDE.md) (and the dev loop in [`tools/dev/README.md`](./tools/dev/README.md)).

---

# 14th_ua's MoE Calculator — Українська

Відстежуйте прогрес **Знаків Класності** (Marks of Excellence) для обраної техніки — в

Ангарі та наживо в бою. Мод читає власні дані гри про класність і малює їх рідними іконками

та стилем інтерфейсу клієнта, тож він виглядає як вбудована частина інтерфейсу, а не

стороннє доповнення.

[English](#14th_uas-moe-calculator--world-of-tanks-mod) · **Українська**

## Що показує

### Смуга класності в Ангарі

Смуга за перцентилем у панелі параметрів техніки з позначками на **65% / 85% / 95%** —

пороги 1 / 2 / 3 знаків — кожна намальована рідною іконкою знака з клієнта. Кожна позначка

підписана комбінованою шкодою, потрібною для цього знака, а смуга заповнюється до вашого

поточного стану. Над нею — ваша поточна середня комбінована шкода й поточний відсоток знака

для обраної техніки.

### Оверлей у бою

Компактний оверлей над HUD із двома рядками (необов'язковий третій рядок показує зараховану

допомогу — див. Налаштування):

- **Поточна комбінована шкода проти прогнозованого середнього** — число забарвлене за знаком

  (червоне нижче прогнозу, біле на рівні, зелене вище).

- **Прогнозований відсоток знака** зі знаком зміни відносно початку бою.

## Сумісність

| Вимога | Деталі |

|--------|--------|

| **Гра** | World of Tanks **EU 2.3.1.0** (глобальний клієнт Wargaming). Зібрано й перевірено для цієї версії. |

| **Обов'язково** | **OpenWG GameFace** 1.1.6+ — встановіть першим, інакше віджет не з'явиться. З [wgmods.net](https://wgmods.net) або [gitlab.com/openwg/wot.gameface](https://gitlab.com/openwg/wot.gameface). |

## Завантаження та встановлення

**Найпростіше — інсталятор в один клік (Windows).** Завантажте найновіший

**`MoECalculator-Setup-.exe`** зі сторінки

[**релізів на GitHub**](https://github.com/drizzer14/moe-calculator/releases) і запустіть

(спершу закрийте гру). Він знаходить папку World of Tanks, встановлює мод у `mods\\`

і додає вкладені залежності — **OpenWG GameFace**, **ModsSettingsAPI** та **ModsList** — для

тих, яких ще немає. Під час кожного запуску

він також перевіряє GitHub і пропонує завантажити найновіший інсталятор, тож збережена копія

залишається актуальною.

**Встановлення вручну.** Візьміть `com.14th_ua.moe_calculator_.wotmod` з тієї ж

сторінки релізів і дотримуйтесь **[`INSTALL.md`](./INSTALL.md)** — там описано ручне

копіювання, перевірку роботи, усунення несправностей і видалення.

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

Мод додає панель до внутрішньоігрового **меню налаштувань модів**, яке надає

**ModsSettingsAPI (MSA)** — стандартний застосунок налаштувань, що йде разом з інсталятором.

Якщо MSA не завантажено, мод усе одно працює з увімкненими за замовчуванням віджетами — просто

не буде панелі.

Панель складається з двох стовпців:

**Віджет у бою** *(увімкнено за замовчуванням)* — показує накладання класності наживо в бою.

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

доступними:

- **Показувати по клавіші Alt** *(вимкнено за замовчуванням)* — показує бойове накладання лише

  поки утримується клавіша **Alt**. Коли вимкнено, накладання показується постійно.

- **Зарахована допомога** *(вимкнено за замовчуванням)* — додає третій рядок до накладання в

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

  піктограмою відповідного типу.

**Віджет в ангарі** *(увімкнено за замовчуванням)* — показує смугу процентиля класності в

Ангарі на вибраній машині. Зніміть позначку, щоб сховати.

## Примітки

- **Після оновлення гри** перемістіть `.wotmod` у нову папку `mods\<версія>\`. Нова версія

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

## Джерело даних класності

Пороги знаків для кожної техніки (комбінована шкода, потрібна для знака) беруться з

**офіційного API Wargaming** — це реальний розподіл шкоди, тож числа автентичні й актуальні.

Пороги кешуються локально, тож перемикання техніки миттєве.

## Модпаки та ліцензія

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

зазначає автора (**14th_ua**) з посиланням на цей репозиторій — див. [`LICENSE.md`](./LICENSE.md).

Для модпаків додавайте лише `.wotmod` і вкажіть OpenWG GameFace як обов'язкову залежність; не

вкладайте GameFace самі.

## Розробка

Збірка, розгортання, тести та структура репозиторію описані в [`CLAUDE.md`](./CLAUDE.md) (а

цикл розробки — у [`tools/dev/README.md`](./tools/dev/README.md)).