moe-calculator

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

SKILL.md

GitHub

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 8.0.0).
  • Client: WoT EU 2.4.1.0. Runtime Python 2.7 (BigWorld); tests on Python 3.13.
  • Hard dep: OpenWG GameFace ≥ 1.2.2 (import openwg_gameface raises if absent; 1.1.6 dies on 2.4.1). Soft dep: ModsSettingsAPI — bundled aslain.modmenu_2.1.04 + modslistapi_1.8.0 (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/gui/gen_resources/com.14th_ua.moe_calculator.json   declares the 3 battle views (R.mods.com_14th_ua_moe_calculator.views.*)

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.4.1.0 (reads deploy.local.json if no args)
Garage hot-reload <py3> tools\dev\sync_gameface.py "D:/Games/World_of_Tanks_EU" 2.4.1.0 (front-end only; battle window can't hot-reload)
Tests <py3> -m pytest -q
Live REPL harness-owned repl_client.py (see wotmod:debug-repl) — needs com.wotmod_harness.debug_repl on TCP :2223
  • WoT install: D:/Games/World_of_Tanks_EU. Decompiled client source: C:\Users\Dmytro Vasylkivskyi\wot-src-eu\sources\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.