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.claude/skills/moe-calculator/SKILL.md
GitHub14th_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.xmlis 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_gamefaceraises if absent; 1.1.6 dies on 2.4.1). Soft dep: ModsSettingsAPI — bundledaslain.modmenu_2.1.04+modslistapi_1.8.0(absent → mod runs with default settings, no panel). Seemoe-settings, andwotmod:msa-settingsfor 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'swot/tanks/masterymethod (distribution=damage&percentile=20,40,55,65,75,85,95,100) viaadapter/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 dossiergetLastBattleTime()); an uncached selection fetches that one tank. Worker-thread fetch +BigWorld.callbackpoll; results persisted (mods_data/14th_ua_moe/moe_wgapi_cache.json) and revalidated 24h after the reply'supdated_at. On a request error,engine_adapterextrapolates from the player's own dossier point viadomain/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) — seemoe-battle. - Deploy needs
WorldOfTanks.execlosed (file locks); thewgclauncher may stay open. - Backlog + research notes live in
TASKS/(TASKS/shipped/= archived). Planner role: seewotmod:planner.