Matchless KungFu Trainer 1.0.0
by Gutwormy
==============================

An in-game trainer for The Matchless KungFu (绝世好武功), single-player.
Press F2 in a loaded game to open it. There is no extra program to run.
The panel is in English and 简体中文.


WHAT YOU NEED
-------------
- The Matchless KungFu on Steam. Works with the current Steam version
  (October 2026), game version 1.4.0.7.
- Windows 10 or 11.
- Nothing else: the trainer runs inside the game's own scripts.


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

2. Open the game's folder: right-click the game in your Steam Library,
   then choose Manage > Browse local files.
   You are in the right place if you can see HMS_00.exe and a folder
   called "HMS_00".

3. Copy the "HMS_00" folder from this download into the game's folder.
   If Windows asks whether to merge folders or replace files, choose Yes.

   When you are done, the folder HMS_00\Content\Paks\~mods contains:
       MatchlessKungFuTrainer_P.pak
   The ~mods folder is new: the game does not have it until you add it.

4. Start the game, load a save, and press F2.
   The first time you enter a world, a small "Matchless KungFu Trainer"
   message at the top left says that the trainer is loaded.

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


FEATURES (default keys)
-----------------------
F2  Open or close the trainer (the game pauses while it is open)
F3  God Mode            - no damage in combat, no death
F4  Infinite Energy     - Energy (内力) never drops, and low Energy no
                          longer blocks your skills
F6  Infinite Chi        - meridian links cost no Chi; links you make
                          while it is on stay after you switch it off
F7  One-Hit Kill        - your hits kill any foe, never your own side.
                          NPCs you hit die for good, also outside turn
                          combat.

In the panel (no key by default):
- Max Moves per Turn: a full move hand (20 moves) every turn
- No Load Limit: carry weight ignored, also for the mount you ride
- Stop Time: the world clock stops outside combat
- Clear Fog of War: Clear reveals the whole map (click twice to
  confirm); Restore Fog puts the fog back as it was before the last Clear
- Edit Coin (0 to 9,999,999) and Edit Karma Points (0 to 99,999):
  type an amount, then click Apply
- Pages: 10 pages with much more (see PAGES). Each opens in place of
  the panel; "< Back" returns.

Hover the mouse over a feature name for a short explanation.
Drag the title to move the panel; Esc closes it. Results show on the
status line at the bottom, with Undo for the last change.
To change a key, click its key box in the panel and press the new key
(Esc cancels). If another feature already has that key, the two swap
keys and the panel says so; it also warns when the key is a game key
too. Max Moves per Turn, No Load Limit and Stop Time can get a key the
same way.
"Hotkeys: On/Off" at the top switches the feature keys off; F2 always
works.
Switches start off each time the game starts. Keys, "Hotkeys: On/Off"
and the language are saved in settings.json in the trainer's folder.

The game uses F1, F5, F8 and F9, and Steam uses F12 and Shift+Tab, so
the trainer keeps away from them.

Language: the panel follows the game. A game in Chinese starts it in
简体中文, any other language in English. Pick one on Saves & Options to
keep it. Item, skill, NPC and place names come from the game, in the
game's language.


PAGES
-----
Character
  Your 16 stats (Vigor, Energy, Spirits, Chi, the five ATK stats, Max
  Load, MSPD and more) with Apply, Undo and Lock; Locks hold through
  fights. Custom Stat Values adds a bonus to any of the game's
  attributes, searched by name or ID. Heal to Full, Clear Sin Value.

Meridians
  The meridian map from your save: click an acupoint to change its type
  (Horn > Square > Round). Cleanse all Ailments, the four Chi levels
  (0 to 5), and Inner Kungfu: Learn, Max, Learn All.

Abilities
  All 33 ability levels, raised or lowered at once, and Max All.
  Rewards the game already gave you stay.

Skills
  95 skills with search and All / Known / Not Known: Learn, Level (0 to
  9; the game's own skill screen stops at 6), Max Level, Forget, Learn
  All.

Inventory
  Your bag (All / Items / Gear / Worn) and your Load. Amount for stacks;
  for gear the Grade (Crude, Refined, Legendary), the main attribute and
  up to 5 Modifiers (edit, Reroll, Add Modifier, remove). Remove Item
  (click twice; worn gear is taken off first; story items warn you).

Spawn Item
  Every item and gear piece, searched in English, Chinese or by ID and
  filtered by the game's bag categories. Add to Bag, Drop at Feet (a bag
  on the ground that stays until you empty it), Give to NPC (the person
  you picked on NPCs), All Legendary Gear (46 pieces, click twice).

NPCs
  Everyone in the world, with search and All / In a Sect / Nearby. For
  the person you pick: Max Vigor, Max Energy, Chi, the five ATK stats and
  Affinity; Heal, Clear Grudges, Teleport To, Summon and Recruit (click
  twice; it warns over your Member Cap or for another sect's Master).

Sect
  Every sect, yours first. Fame and Infamy on any sect. For your own
  sect: Wood, Ores, Herbs, Animals, Worms, Fishery and Coin with Undo and
  Lock, Member Cap (raise only), Ignore Taboos, and Found Sect Here (the
  game's own naming panel, free; the lot must be unowned).

World
  Teleport to map markers, Post Stations and regions, and Back to where
  you were (not in combat or cutscenes). Time: +1 Hour, To Morning,
  +1 Day. Weather: Sunny, Rain, Rainstorm, Snow, Snowstorm. Multipliers
  from x0.1 to x10 (back to x1 when the game restarts): Game Time,
  Ability EXP, Crop & Production, Expand Territory Speed. Give a Pet
  (12 kinds). Place Plot (free, opens the game's own plot map).

Saves & Options
  Your backups with Restore and Delete (click twice each) and Back Up
  Now; the automatic backups Before First Edit and Every 30 Minutes;
  3 presets (the 7 switches, the 4 multipliers and Ignore Taboos);
  the language (English / 简体中文); the change log with Undo Last Change.


BACKUPS AND RESTORE
-------------------
- A backup is a copy of your whole game save: every world and your
  Karma Points. Backups are kept in
  %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer\backups
- Before First Edit is on by default: the trainer makes a backup once
  per loaded save, before your first change.
- Every 30 Minutes (off by default) makes a backup after a game save, at
  most once every 30 minutes. The newest 10 of each automatic kind are
  kept.
- Back Up Now copies your last save on disk. It does not save the game
  for you: save in the game first if you want your latest progress in
  the backup.
- Restore (click twice) works like the game's own F8 Load: the panel
  closes, the game loads the backup and you are back in that world. A
  Before Restore backup is made first. Progress since your last game save
  is lost.
- Restore does not bring back the fog of war (use Restore Fog for that)
  or the trainer's own files.
- Backups stay on this PC: they are outside the Steam Cloud folder.
  After a Restore, Steam Cloud syncs your save like any other save.


GOOD TO KNOW
------------
- Saved with your game, so they stay after you remove the trainer:
  Coin, Karma Points, stats, meridians, abilities, skills, items and
  gear, NPC and sect changes, Infinite Chi links, Drop at Feet bags,
  placed plots, pets and moved time. Back up first if you may want them
  back as they were.
- Not saved with your game: the switches, Locks, multipliers, Custom
  Stat Values, Moves Per Turn + and the raised Member Cap. Custom Stat
  Values, Moves Per Turn + and the Member Cap are kept by the trainer
  for each world and go away when you remove the trainer.
- Karma Points and the fog of war are each one value shared by all your
  saves (the game keeps them that way).
- Trainer actions can unlock Steam achievements early.
- The game sends gameplay data to its publisher; the trainer does not
  touch it.
- The game's own F9 cheat panel shares God Mode and Infinite Energy with
  the trainer: both change the same setting.
- Single-player only.
- If something misbehaves, try without other mods first.
- After a game patch: if the game misbehaves, delete the trainer's .pak
  (see HOW TO UNINSTALL) and wait for a trainer update.
- The trainer's folder is
  %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer
  It holds settings.json, trainer.log, your backups and presets. It is
  outside the Steam Cloud folder.


KNOWN ISSUES
------------
- Crop & Production scales your farmland harvest and your own sect's
  Lot Taxes only: not sect building output and not the Big World tax
  missions.
- Weather is one-shot: the game's own weather changes it again after a
  few minutes. Rainstorm brings lightning that can hurt you.
- Place names on Teleport, and item, skill and NPC names, follow the
  game's language, not the panel's. Chinese names are sorted by
  character code, not by pinyin.
- Time moves forward only.
- Clear Fog of War applies to every save (the game has one fog map for
  all save slots) and the game keeps the cleared map at its next save.
- Changes written to your save stay after the trainer is removed (see
  GOOD TO KNOW).
- Rare: if the taming in Give a Pet fails, a wild animal stands at your
  feet instead.


HOW TO UNINSTALL
----------------
Close the game, then delete this file from the game's folder:
    HMS_00\Content\Paks\~mods\MatchlessKungFuTrainer_P.pak
You can delete the empty ~mods folder too.
Optional: delete %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer
(your backups and settings are in it, so keep it if you may need them).
The trainer does not change any game files on disk.


TROUBLESHOOTING
---------------
- F2 does nothing: check that MatchlessKungFuTrainer_P.pak is in
  HMS_00\Content\Paks\~mods inside the game's folder (with the ~ in
  "~mods"). Load a save first: the panel does not open on the title
  screen, while loading, during cutscenes or while the game's UI is
  hidden (P key).
- "Untested game build" on the status line: the game was updated after
  this trainer. The trainer still loads; a page or feature whose game
  part is missing is greyed out ("Unavailable - check log"), and Before
  First Edit stays on. Look for a trainer update on its Nexus page.
- Antivirus: the trainer has no program file (no .exe, no .dll), only
  a game data file, so a warning is a false positive. The trainer does
  not connect to the internet and only runs inside the game.
- When reporting a problem, include trainer.log (and trainer.prev.log,
  the run before) from %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer
  plus the game version and any other mods you use. The log shows your
  folder paths: you can blank out your Windows user name before you post
  it.


CREDITS
-------
Matchless KungFu Trainer by Gutwormy. No third-party code.
