Men of War 2 Trainer 1.0.0
by Gutwormy
==========================

An in-game trainer for Men of War: Assault Squad 2 (single-player and skirmish).
Press F10 in the game to open it. There is no extra program to run.


WHAT YOU NEED
-------------
- Men of War: Assault Squad 2. Made and tested on the current Steam
  version (3.262). Other versions (GOG, other patches) work too, as far
  as the trainer finds what it needs in them: it looks for each feature
  in the game when it starts, and greys out the ones it cannot find
  ("Not found in this game version"). The panel then says
  "Untested game version" and how many feature groups it found.
  The Cold War standalone is a different game and is not supported.
- Windows 10 or 11.


HOW TO INSTALL
--------------
1. Close the game.

2. Open the game's folder.
   Steam: right-click the game in your Library, then choose
   Manage > Browse local files.

   You are in the right place if you can see mowas_2.exe.

3. Copy winmm.dll and the MenOfWar2Trainer folder from this download into the
   game's folder.

   When you are done, the game's folder contains:
       mowas_2.exe
       winmm.dll
       MenOfWar2Trainer

4. Start the game. Once you are in the game, press F10.

Updating from an older version: do the same and replace the files. Your keys
and language in MenOfWar2Trainer.ini are kept if you keep that file.


HOW TO UNINSTALL
----------------
Close the game, then delete these two from the game's folder:

winmm.dll and MenOfWar2Trainer   (the whole folder)

The trainer does not change any game files or save files.


WHAT IT DOES
------------
Main page (the first eleven switches have hotkeys, Num 1 - Num 0 and Num . by
default; click a key box to set or change one):
- God Mode, Unlimited Ammo, Unlimited Fuel, Unlimited Items, Instant Repair,
  Instant Build, Unlimited Stamina, Instant Reload, No Call-in Cooldown,
  One-Hit Kills, Reveal Map, Stealth, Freeze Mission Timer.
- Edit Manpower, Command Pts and Unit Cap for the current battle.
- Selected Units: Heal, Refill (ammo, kits, fuel) and Crew (fills empty crew
  seats of the selected vehicles).
- Hotkeys On / Off in the title bar (the panel key always works).

Spawn Units: every unit of the game's armies and your mods, with crews and
squads, for any side in the mission (enemy and allied units get AI orders),
with Rank, Facing (a preview on the ground), Copy Unit, Delete Unit and
Teleport.

Give Items: weapons, ammo, grenades, kits and tools into your selected units,
with a Fits filter for the selected vehicle and Undo Last.

Buildings: place the game's buildings, defences, walls, props and trees with a
see-through preview that follows the mouse (Q / E turn it), remove objects
(whole buildings, foundation included) and Undo Last.

Mods: the mods in your mods folder and whether the game has them on.


MOD SUPPORT
-----------
- Units, items and buildings added by the mods you have turned on in the game
  are listed on the Mods tab of each page, as Name [Mod name].
- Content of a mod that is installed but turned off is greyed out.
- After turning mods on or off in the game's Mod Manager, close the game and
  start it again (the Mod Manager's own restart keeps the old unit lists; the
  Mods page warns you in amber).
- Mod support is best effort: big mods can change how the game works. Some
  vehicles of the UMW 40k mod can still be destroyed with God Mode on.
- Mods with a DLL plugin: the trainer's winmm.dll also loads other mods'
  plugins from the MenOfWar2Trainer\plugins folder. If a mod comes with its own
  winmm.dll, don't copy it over the trainer's; put its DLL in that plugins
  folder instead.


LANGUAGES
---------
Click the globe button at the top of the trainer, or set Language= in
MenOfWar2Trainer.ini (auto follows your Windows language). English, Russian,
Ukrainian, Simplified Chinese, Korean, French, German, Spanish and Turkish.
The translations are drafts written with AI and no native speaker has checked
them yet, so some wording may be odd or wrong. Corrections are very welcome:
post in the mod's Posts tab on Nexus with the language, the text as shown and
what it should say.
Unit and item names come from the game, in the language it runs in. Building
names stay in English. Mod names and mod content stay as the mod writes them.


GOOD TO KNOW
------------
- Single-player and skirmish only. In a multiplayer session the trainer turns
  every switch off and stays off until the session ends.
- God Mode keeps your vehicles whole and their crews inside when they are hit.
  A vehicle that ends up on its roof still loses its crew, as in the game.
- Stealth hides your units from enemy eyes; artillery, scripted attacks and
  return fire after a hit may still find them.
- Freeze Mission Timer stops the countdowns a mission shows (hold out,
  reinforcements arriving, time limits).


ANTIVIRUS WARNING (FALSE POSITIVE)
----------------------------------
Some antivirus programs may flag winmm.dll or MenOfWar2Trainer.dll. This is a
false positive.

The trainer does not connect to the internet, does not change game files and
only runs inside the game.


Troubleshooting
-----------------------

-F10 does nothing: check that winmm.dll and the MenOfWar2Trainer folder are both in the game's folder (the one containing mowas_2.exe), and not in a folder inside it.
-Some switches or buttons are greyed with "Not found in this game version": your game is another version than the one the trainer was made on, and the trainer could not find those features in it (MenOfWar2Trainer\log.txt lists what was not found). It never changes a part of the game it did not find, to keep your game and saves safe. Post the log on Nexus so it can be added.
-If your antivirus removes a file: add the game's folder as an exception (an "exclusion") in your antivirus and copy the file again.
-Mods not showing up in the lists: ensure the mods are inside the mods folder and turned on in the game, then close the game and start it again.
-F10 stopped working after installing a mod: the mod's own winmm.dll probably replaced the trainer's. Copy the trainer's winmm.dll back; put the mod's DLL in MenOfWar2Trainer\plugins.
-Something went wrong: MenOfWar2Trainer\log.txt says what the trainer did. Post it in the mod's Posts tab on Nexus.


CREDITS
-------
Men of War 2 Trainer by Gutwormy.
Dear ImGui by Omar Cornut and contributors (MIT licence, LICENSE-imgui.txt).
