| name | moe-calculator |
| description | Use when working anywhere in the 14th_ua MoE Calculator repo and you need orientation — the mod's identity, versions, dependencies, the src/ tree, the shared cross-feature modules, the MoE data source, or the exact dev/deploy/test/REPL commands. Start here, then branch to moe-garage, moe-battle, moe-progress, moe-settings, or moe-build-release. |
14th_ua's MoE Calculator — project map
A World of Tanks Garage + in-battle Marks-of-Excellence mod. This skill is the
orientation; the concrete patterns live in the harness skill wotmod-basics. The two
features and the build each have their own project skill:
moe-garage — the hangar percentile-bar widget, end-to-end.moe-battle — the in-battle live-MoE corner overlay, end-to-end.moe-progress — the two centre-screen transient battle bars (Moving Average / Damage Efficiency), end-to-end.moe-settings — the MSA settings panel + its 4 toggles, end-to-end.moe-build-release — packaging, deploy, version files, dev loop, release.
Identity (facts)
- Mod id:
com.14th_ua.moe_calculator (src/meta.xml is the canonical version, currently 3.1.0).
- Client: WoT EU 2.3.1.2. Runtime Python 2.7 (BigWorld); tests on Python 3.13.
- Hard dep: OpenWG GameFace ≥ 1.1.6 (
import openwg_gameface raises if absent). Soft dep:
ModsSettingsAPI — bundled aslain.modssettingsapi_1.6.4 + modslistapi_1.7.8 (absent → mod runs
with default settings, no panel). See moe-settings, and wotmod-msa-settings for the mechanics.
- MoE data source (official WG API, single build): per-tank combined-damage thresholds keyed by intCD, each row keyed by PERCENTILE
{20,40,55,65,75,85,95,100} (the 8 anchors WG actually stores; 65/85/95/100 required all-or-nothing, the rest optional enrichment), come from the Wargaming public API's wot/tanks/mastery method (distribution=damage&percentile=20,40,55,65,75,85,95,100) via adapter/moe_wgapi.py — the sole provider, no facade. On garage entry it fetches the selected tank, then warms the 100 most-recently-played owned vehicles (adapter/garage_roster.py, ranked by dossier getLastBattleTime()); an uncached selection fetches that one tank. Worker-thread fetch + BigWorld.callback poll; results persisted (mods_data/14th_ua_moe/moe_wgapi_cache.json) and revalidated 24h after the reply's updated_at. On a request error, engine_adapter extrapolates from the player's own dossier point via domain/moe_estimate.py. GitHub and WGMods ship the identical build. See [[moe-build-release]].
The tree
src/res/scripts/client/
gui/mods/mod_moe_calculator.py entry: _install() garage + _install_battle() overlay
moe_calculator/
domain/ engine-free, pytest-able (NO game imports)
constants.py wire contract: MARK_PERCENTS=(65,85,95), GOALPOST_PERCENTILE, EWMA, anchors
types.py builder.py garage data + build_model
battle_types.py battle_builder.py battle data + CD/EWMA/percent math
positioning.py overlay anchor + damage-log-collapse predicate
placement.py overlay placement math
moe_estimate.py error-fallback threshold estimator (inv-CDF + OLS + prior)
rounding.py py2/py3-stable rounding
fetch_list.py WG-API warm-fetch ranking
adapter/ the ONLY read-side layer touching live game symbols (fail-soft via _safe)
engine_adapter.py garage dossier read battle_adapter.py in-battle efficiency read
moe_wgapi.py WG-API fetch/parse/cache (the SOLE threshold source; no facade)
garage_roster.py selected + recent intCDs format.py pure formatters
baseline_cache.py garage→battle baseline i18n.py localized label bundle
battle_input.py Alt-key peek input sample_log.py battle_samples.jsonl append
settings_i18n.py MSA panel prose bundle
bridge/ marshals model → Wulf ViewModels (PC-only)
gameface_bridge.py garage inject+push battle_bridge.py battle lifecycle+push
battle_view.py registered window host view_models.py MoEVM/MarkTickVM/BattleMoEVM
bar_window.py shared bar window host progress_view.py mark-axis bar view
efficiency_view.py damage-efficiency bar view
mod_settings.py MSA registration + flag getters
wulf_args.py (reverse-channel helpers; unused — v1 is read-only)
build_config.py build-injected WG_APPLICATION_ID
_compat.py LOG_* shim + _safe/_safe_int
src/res/gui/gameface/mods/14th_ua/MoECalculator/ the two front-ends + assets (see moe-garage / moe-battle)
src/res/mods/configs/res_map/MoEBattleView.json registers the in-battle view
Shared (cross-feature) modules
domain/constants.py (mark percents, EWMA, anchors), adapter/moe_wgapi.py (the threshold
source), adapter/format.py (thousands/percent/
signed_percent/mark_icon_url), adapter/i18n.py (label bundle), adapter/baseline_cache.py
(career baseline keyed by intCD, bridging garage read → battle read), _compat.py. Everything
else is feature-specific.
Dev quickref
Deploy yourself — never ask the user to run these (run the commands directly via the shell):
| Task | Command |
|---|
| Package + deploy | C:\Python27\python.exe build\deploy_wotmod.py "D:/Games/World_of_Tanks_EU" 2.3.1.2 (reads deploy.local.json if no args) |
| Garage hot-reload | <py3> tools\dev\sync_gameface.py "D:/Games/World_of_Tanks_EU" 2.3.1.2 (front-end only; battle window can't hot-reload) |
| Tests | <py3> -m pytest -q |
| Live REPL | <py3> tools\dev\repl_client.py "<expr>" — needs com.14th_ua.moe_calculator_debug.wotmod on TCP :2224 |
- WoT install:
D:/Games/World_of_Tanks_EU. Decompiled client source: C:\Users\Dmytro Vasylkivskyi\wot-eu\source\res\scripts\client\.
- Sibling repo with portable code (garage widget's DOM Ctrl+drag,
installDrag):
C:\Users\Dmytro Vasylkivskyi\wgmod-research-progress. The in-battle bars' Ctrl+drag is a
separate, Python-owned absolute-placement design (no DOM drag, no JS delta) — see moe-battle.
- Deploy needs
WorldOfTanks.exe closed (file locks); the wgc launcher may stay open.
- Backlog + research notes live in
TASKS/ (TASKS/shipped/ = archived). Planner role: see wotmod-planner.
