Symphony of War Trainer 1.0.0
by Gutwormy
=============================

An in-game trainer for Symphony of War: The Nephilim Saga (single-player).
Press F10 in the game to open it. There is no extra program to run.


WHAT YOU NEED
-------------
- Symphony of War: The Nephilim Saga. Made and checked on version 1.10.23
  (GOG). Steam and the Legends DLC have not been checked yet.
- Windows 10 or 11.

The trainer finds what it needs in the game by name, so it should keep
working after game updates. Anything it cannot find is greyed out with
"Not found in this game version"; the rest keeps working.


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.
   GOG Galaxy: select the game, click the settings icon next to Play,
   then Manage installation > Show folder.

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

3. Copy version.dll and the SoWTrainer folder from this download into
   the game's folder (next to SymphonyOfWar.exe).
   If Windows asks whether to replace files, choose Yes.

4. Start the game and press F10. Most features need a loaded save.

Updating from an older version: do the same and replace the files.


FEATURES (keys)
---------------
F10 Open or close the trainer. Drag it by its title.

Main page:
F6  God Mode           - your units stay at full health
F7  Unlimited Moves    - your squads can move, attack and use their
                         once-per-turn actions again (tactics excluded)
F9  One-Hit Kills      - your squads' hits defeat what they hit
                         (misses still miss)
F3  Max Morale         - your squads' morale stays at the maximum
F4  Easy XP            - XP and class mastery (CP) x10
=   Free Purchases     - shops, techs, class changes, revives and arena
                         entry cost nothing
- Edit Gold            - type an amount, then click Apply
- Game Speed           - x1, x2, x4 or x8

Pages (buttons on the main page):
- Resources   Iron, Horses, Gems, Sunstone, Obsidian, Pyrocite, Tech
              Points, Faction XP, Proof of Merit, Medal of Valor, Memory
              Fragments and the arena tokens. Max All fills the six
              materials.
- Tech Tree   unlock or lock any tech, a whole branch or everything,
              without spending Tech Points.
- Items       every item and artifact, with search and the game's own
              icons. Set an amount and Add; Undo Last takes it back.
- Add Units   recruit any recruitable class with level, trait, affinity,
              loyalty and amount, up to your army limit. Copy Unit makes
              an exact copy of a unit (not story characters).
- Edit Units  level, class mastery, class, affinity, stats, loyalty and
              traits of any unit; per-unit God Mode; Full Heal.
- Operations  on the tactical map: Win Battle Now (click twice), Refresh
              All Squads, Heal All Squads, Restore Morale, Rout Enemy
              Squad (then click an enemy squad), Weather and Turn.
              With a save loaded: Faction Rank, Unlock All Classes,
              Revive Fallen Units (permadeath), Restock Shops and
              Befriend All.
              Rates: XP and CP gained x1-x10, resources from mines
              x1-x10, shop prices 25-200%, squad capacity +0 to +50.

Hover the mouse over a feature for a short explanation; a greyed-out
feature says why. While the mouse is over the trainer, the game ignores
your clicks. The keys cannot be changed in this version, and Alt
combinations are left to Windows (Alt+F4 still closes the game).
Switches and Rates start off each time the game starts.


GOOD TO KNOW
------------
- Back up your saves first. Saves are in %APPDATA%\Nephilim (paste it
  into the Explorer address bar). Everything you change in the game
  (gold, resources, items, techs, units, rank, bonds, revived units) is
  saved with your game. The switches and Rates are never saved.
- The trainer stores nothing of its own in your saves.
- Edit Units has no undo. Locking a tech keeps the effects it already
  had.
- Win Battle Now and Turn can skip story scenes and mission events you
  have not reached yet.
- Restock Shops rolls new random stock (it can be better or worse).
- Shop prices below 50% let you sell items back for a profit.
- With a squad capacity bonus, the game's own automatic squad fills can
  hire extra units.
- Cheats can unlock Steam achievements early (for example a faction
  rank or Queen of Dragons).


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

version.dll and SoWTrainer   (the whole folder)

The trainer does not change any game files.


TROUBLESHOOTING
---------------
- F10 does nothing: check that version.dll and the SoWTrainer folder are
  both in the game's folder, next to SymphonyOfWar.exe, and not in a
  folder inside it. Then start the game normally (from Steam, GOG Galaxy
  or its shortcut). SoWTrainer\proxy.log shows whether the trainer was
  started.
- A feature is greyed out with "Not found in this game version": your
  version of the game lacks something that feature uses. The rest still
  works.
- Another mod also has a version.dll: only one of them can be in the
  game's folder.
- Antivirus removed a file: this is a false positive. Add the game folder
  as an exception and copy the file again. version.dll only starts the
  trainer inside the game; the trainer does not connect to the internet.
- When reporting a problem, include SoWTrainer.log and proxy.log from
  the SoWTrainer folder.


CREDITS
-------
Symphony of War Trainer by Gutwormy.
Uses Dear ImGui (MIT licence, see SoWTrainer\LICENSE-imgui.txt).
Symphony of War: The Nephilim Saga is by Dancing Dragon Games. This
trainer is not affiliated with them.
