================================================================
  Vae Victis - Khan: Cheat Panel Mod
================================================================

A drop-in cheat trainer for the Ren'Py game "Vae Victis - Khan".
Adds an in-game panel of buttons and keyboard shortcuts for:
gold, troops, HP, winning battles, winning duels, finishing
construction instantly, and buffing fiefs (morale, obedience,
yields).

Everything is a toggle - delete the file and the game is back
to its original state.


REQUIREMENTS
----------------------------------------------------------------
- A legitimate installed copy of Vae Victis - Khan (any version
  built on Ren'Py 7.6.x should work; tested against the Steam
  release, Ren'Py 7.6.3).
- Write access to the game's "game" subfolder (the one that
  contains options.rpy and scripts.rpa).

No external libraries, no DLL swaps, no save-game edits, no
third-party tools. Everything is a single plain-text .rpy script
that Ren'Py loads at startup like any other game file.


INSTALL
----------------------------------------------------------------
1. Close the game if it is running.

2. Locate the game folder. On a default Steam install:
     Steam -> Library -> Vae Victis - Khan -> right-click ->
     Manage -> Browse local files

3. Open the "game" subfolder inside that folder. You should see
   files like options.rpy, options.rpyc, scripts.rpa, and the
   "tl", "audio", "images" subfolders.

4. Copy cheats.rpy into that "game" subfolder.

5. Launch the game. Load any save (or start a new game).

6. In the top-right corner you should see an orange [Cheats]
   button. Click it to open the panel. Click again (or press
   Alt+H) to hide it.


UNINSTALL
----------------------------------------------------------------
Delete cheats.rpy from the "game" subfolder. The game reverts
to vanilla on next launch. Your saves are untouched.

(Ren'Py may have cached a compiled copy as cheats.rpyc next to
it on first launch - delete that too if present.)


FEATURES
----------------------------------------------------------------

Panel toggle:
  Alt+H                       - open / close the cheat panel
  Click the corner [Cheats] button - same thing

Resources & Hero:
  Alt+G                       - +1000 gold
  (button only)               - +10000 gold
  Alt+U                       - uncap gold (removes maxGold limit)
  Alt+T                       - +100 troops
  (button only)               - +1000 troops
  Alt+S                       - Super MC (9999 HP, 9999 damage)
  Alt+F                       - full heal MC

Combat:
  Alt+D                       - instantly win the current RPS duel
  Alt+1                       - instantly win current Mk1 (dice) battle
  Alt+2                       - instantly win current Mk2 (grid) battle
  Alt+3                       - switch future battles to Mk2 grid combat
  Alt+K                       - toggle "skip all RPS duels"
  Alt+V                       - toggle vnMode (easy-mode master switch)

Selected fief (open a fief's management screen first):
  Alt+M                       - max morale (clamped to maxMorale cap)
  Alt+O                       - max obedience (clamped to maxObedience cap)
  Alt+Y                       - set gold yield to 99
  Alt+Q                       - set troop yield to 99
  Alt+B                       - instantly finish current construction

All owned fiefs (blanket):
  Alt+A                       - max morale, obedience, and both yields
                                across every fief you own
  Alt+X                       - finish construction in every owned fief


NOTES / GOTCHAS
----------------------------------------------------------------
- "Win Mk1 Battle" and "Win Mk2 Battle" only work when you are
  actually inside that type of battle. The notification tells
  you if nothing is happening.

- Morale and obedience setters clamp to the fief's maxMorale /
  maxObedience, which depend on your fame, palace harem, and
  buildings (temple, Nahir in the palace, etc.). "Max" here
  means "as high as the game currently allows in each fief".
  To push the ceiling itself up, set fame to 200 ("saint" tier)
  first:  khaganate.fame = 200  in the console.

- The game's Ren'Py console (Shift+O) is enabled by this mod,
  so you can also run commands manually there.

- vnMode is an existing developer easy-mode switch in the game.
  It has strong side effects: minimum 2000 gold, no fame limits,
  10x gold yield from fiefs, defenders start battles with 0
  troops. Treat the Alt+V button as a "do everything at once"
  nuke, not a precision tool.

- "Skip all duels" (Alt+K) blocks the Braveheart achievement
  (the game tracks a "chickened" counter). Super MC + manual
  duels preserves achievements.

- Steam may list the mod as "unrecognised file" if you run
  "Verify integrity of game files". It won't delete it; you'll
  just need to re-add it if a game update replaces the whole
  "game" folder.


COMPATIBILITY
----------------------------------------------------------------
This mod reads a few internal class names from the game:
  khaganate, khanArmy, territoryList, mc_hp, wolf_hp,
  mcBaseDamage, _battle, combat_mk2_fact, rps_disable, vnMode,
  Khaganate._gold, Khaganate.maxGold, Khaganate.goldLimit,
  KhanArmy._totatlArmyCap, Territory.morale, Territory.obedience,
  Territory.yild, Territory.construction, Building.constructed()

If a future game update renames any of these, the specific
cheat that uses the renamed name will show an error in its
notification popup, but the rest of the mod will still work.


CREDIT / LICENCE
----------------------------------------------------------------
Freely redistributable. Modify as you like.
Not affiliated with the developers of Vae Victis - Khan.
Use at your own risk; always back up your saves.
