﻿绝世好武功修改器（Matchless KungFu Trainer）1.0.0
作者：Gutwormy
=================================================

这是《绝世好武功》（The Matchless KungFu）的游戏内修改器，仅限单人游戏。
进入游戏并读取存档后按 F2 即可打开，无需运行其他程序。
面板支持简体中文和 English。


所需条件
--------
- Steam 版《绝世好武功》。适用于当前 Steam 版本（2026 年 10 月），游戏版本
  1.4.0.7。
- Windows 10 或 11。
- 无需其他工具：修改器直接在游戏自身的脚本中运行。


安装方法
--------
1. 关闭游戏。

2. 打开游戏文件夹：在 Steam 库中右键点击游戏，选择“管理 > 浏览本地文件”。
   能看到 HMS_00.exe 和名为“HMS_00”的文件夹，就说明位置正确。

3. 把下载内容中的“HMS_00”文件夹复制到游戏文件夹中。如果 Windows 询问是否合并
   文件夹或替换文件，选择“是”。

   完成后，HMS_00\Content\Paks\~mods 文件夹中应有：
       MatchlessKungFuTrainer_P.pak
   ~mods 文件夹原本不存在，是这次新加的。

4. 启动游戏，读取存档，按 F2。
   第一次进入世界时，左上角会弹出“绝世好武功修改器”的提示，表示已经加载。

更新旧版本：按同样的步骤操作，替换文件即可。


功能（默认按键）
----------------
F2  打开或关闭修改器（面板打开时游戏暂停）
F3  无敌模式  - 战斗中不受伤害，也不会死亡
F4  无限内力  - 内力永不下降，内力不足时也能照常出招
F6  无限真气  - 连接经脉不消耗真气；开启期间连好的经脉，关闭后依然保留
F7  一击必杀  - 你的攻击可彻底击杀任何敌人，不会伤到己方。被你击中的 NPC 会真
                正死亡，在回合制战斗之外击中也一样。

面板内的功能（默认无按键）：
- 每回合抽满招式：每回合都抽满 20 个招式
- 无负重限制：忽略负重，骑坐骑时同样有效
- 时间静止：非战斗时世界时间暂停
- 清除战争迷雾：点“清除”揭开全图（需点两次确认）；“恢复迷雾”把迷雾恢复到上
  次清除前的样子
- 修改铜钱（0 至 9,999,999）和修改天命点（0 至 99,999）：输入数值后点“应用”
- 页面：另有 10 个功能页面（见“页面”一节），打开后替换主面板显示，点“< 返回”
  回到主面板

鼠标悬停在功能名称上可查看简短说明。
拖动标题栏可移动面板，按 Esc 关闭。操作结果显示在底部的状态栏，可“撤销”最近
一次修改。
更改按键：点击面板中的按键框，再按下新的键（Esc 取消）。如果这个键已被其他功能
占用，两者会互换按键，面板会提示；如果这个键也是游戏按键，面板也会提醒。每回合
抽满招式、无负重限制和时间静止也可以用同样的方法设置按键。
顶部的“热键:开/关”可关闭功能热键，F2 始终有效。
每次启动游戏时，所有开关都处于关闭状态。按键、热键开关和语言保存在修改器文件夹
的 settings.json 中。

游戏自己使用 F1、F5、F8 和 F9，Steam 使用 F12 和 Shift+Tab，修改器的默认按键都
避开了这些键。

语言：面板默认跟随游戏。游戏为中文时显示简体中文，其他语言时显示 English。在
“存档与选项”中选好后会一直保持。物品、绝学、人物和地点的名称来自游戏本身，显
示为游戏的语言。


页面
----
角色
  16 项属性（气血、内力、心境、真气、五项攻击、最大负重、移动速度等），可
  “应用”“撤销”和“锁定”；锁定在战斗中也有效。“自定义属性”可为游戏中的任
  意属性添加加成，可按名称或编号搜索。另有“全部恢复”和“清除罪恶值”。

经脉
  显示存档中的经脉图：点击穴位可切换类型（奇穴 > 经穴 > 阿是穴）。还有
  “清除所有隐疾”、四种真气等级（0 至 5），以及内功的“学艺”“满级”
  “全部学艺”。

能力
  全部 33 项能力等级，可升可降，立即生效；另有“全部满级”。游戏已经发放的奖励
  会保留。

绝学
  95 门绝学，可搜索，并按“全部 / 已学会 / 未学会”筛选：学艺、等级（0 至 9；
  游戏自带的绝学界面最高只到 6）、升至满级、废除、全部学艺。

背包
  你的背包（全部 / 物品 / 装备 / 已装备）和负重。可修改物品数量；装备可修改品
  质（粗制、精制、传说）、主属性和最多 5 条词条（修改、重洗、添加词条、移
  除）。“移除物品”需点两次；已装备的会先卸下，剧情物品会先提醒。

生成物品
  游戏中的所有物品和装备，可用中文、英文或编号搜索，并按游戏的背包分类筛选。
  “放入背包”、“丢在脚下”（地上的包裹，取空之前一直都在）、“赠予NPC”（赠
  给在人物页面选中的人）、“全部传说装备”（共 46 件，需点两次）。

人物
  世界中的所有人物，可搜索，并按“全部 / 门派中 / 附近”筛选。对选中的人物可修
  改最大气血、最大内力、真气、五项攻击和好感；还有治疗、消除恩怨、传送、召唤、
  招收弟子（需点两次；超过人数上限或对方是其他门派的掌门时会提醒）。

门派
  所有门派，你的门派排在最前。任何门派都可修改门派善名和门派恶名。你自己的门派
  还可修改树木、矿石、草药、动物、蛊虫、渔业、铜币（可撤销、可锁定）和人数上限
  （只能提高），另有“无视门派禁忌”和“在此创立门派”（打开游戏自己的命名面
  板，免费；该地块必须无主）。

世界
  传送到地图标记、驿站和区域，也可“返回原处”（战斗中和过场动画中不可用）。时
  间：+1小时、到早晨、+1天。天气：晴天、雨、暴雨、雪、暴雪。倍率 x0.1 至 x10
  （游戏重启后恢复为 x1）：游戏时间、能力经验、作物与产出、开辟领地速度。添加
  宠物（12 种）。解锁地块（免费，打开游戏自己的地块地图）。

存档与选项
  备份列表，可“恢复”和“删除”（都需点两次），以及“立即备份”；自动备份
  “首次修改前”和“每 30 分钟”；3 个预设（7 个开关、4 个倍率和无视门派禁
  忌）；语言（English / 简体中文）；修改记录和“撤销上次修改”。


备份与恢复
----------
- 备份是整个游戏存档的副本，包括所有世界和天命点。备份保存在
  %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer\backups
- “首次修改前”默认开启：每次读取存档后，在你第一次修改之前自动备份一次。
- “每 30 分钟”（默认关闭）在游戏存档后备份，最多每 30 分钟一次。每种自动备份
  各保留最近 10 个。
- “立即备份”复制的是磁盘上最近一次的存档，不会替你存档：想把最新进度备份进
  去，请先在游戏中存档。
- “恢复”（需点两次）和游戏自带的 F8 读档一样：面板关闭，游戏读取备份，你会回
  到那个世界。恢复之前会先自动做一个“恢复前”备份。注意：上次游戏存档之后的进
  度会丢失。
- “恢复”不会还原战争迷雾（请用“恢复迷雾”），也不会还原修改器自己的文件。
- 备份只保存在这台电脑上，不在 Steam 云存档文件夹中。恢复之后，Steam 云会像同
  步普通存档一样同步你的存档。


须知
----
- 以下修改会写入存档，删除修改器后依然保留：铜钱、天命点、属性、经脉、能力、绝
  学、物品和装备、人物和门派的修改、无限真气期间连好的经脉、丢在脚下的包裹、解
  锁的地块、宠物和推进的时间。如果以后可能想恢复原样，请先备份。
- 以下不会写入存档：各项开关、锁定、倍率、自定义属性、一回合招式数量 + 和提高
  后的人数上限。其中自定义属性、一回合招式数量 + 和人数上限由修改器按世界分别
  保存，删除修改器后就会消失。
- 天命点和战争迷雾都由所有存档共用（游戏本身就是这样设计的）。
- 修改器的操作可能会提前解锁 Steam 成就。
- 游戏会向发行商发送游戏数据，修改器不会干预这部分。
- 游戏自带的 F9 作弊面板与修改器共用无敌模式和无限内力：两边改的是同一个设置。
- 仅限单人游戏。
- 如果出现异常，请先在不加载其他 Mod 的情况下试一试。
- 游戏更新后：如果游戏运行异常，请删除修改器的 .pak 文件（见“卸载方法”），等
  待修改器更新。
- 修改器文件夹位于
  %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer
  其中有 settings.json、trainer.log、你的备份和预设，不在 Steam 云同步范围内。


已知问题
--------
- 作物与产出只影响你的田地收获和你自己门派的门派税收，不影响门派建筑的产出，也
  不影响大世界的收税任务。
- 天气为一次性更改：几分钟后游戏会按自己的规律再次改变天气。暴雨会引来雷击，可
  能伤到你。
- 传送列表中的地点名称，以及物品、绝学和人物的名称，跟随游戏语言，而不是面板语
  言。中文名称按字符编码排序，而不是按拼音。
- 时间只能向前推进。
- 清除战争迷雾对所有存档生效（游戏的所有存档共用一张迷雾图），游戏会在下次存档
  时保留清除后的地图。
- 写入存档的修改在删除修改器后依然保留（见“须知”）。
- 少数情况：添加宠物时如果驯服失败，你脚边会出现一只野生动物。


卸载方法
--------
关闭游戏，然后从游戏文件夹中删除这个文件：
    HMS_00\Content\Paks\~mods\MatchlessKungFuTrainer_P.pak
空的 ~mods 文件夹也可以一起删除。
可选：删除 %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer 文件夹（你的备份
和设置都在里面，以后可能用到的话请保留）。
修改器不会改动磁盘上的任何游戏文件。


常见问题
--------
- 按 F2 没反应：确认 MatchlessKungFuTrainer_P.pak 位于游戏文件夹中的
  HMS_00\Content\Paks\~mods（“~mods”带 ~）。请先读取存档：在标题画面、载入
  中、过场动画中或游戏界面被隐藏（P 键）时，面板不会打开。
- 状态栏显示“未测试的游戏版本”：说明游戏在这个修改器发布后更新过。修改器仍会
  加载；缺少所需游戏功能的页面或功能会变灰（“不可用 - 请查看日志”），
  “首次修改前”备份会保持开启。请到修改器的 Nexus 页面查看是否有更新。
- 杀毒软件报毒：修改器没有任何程序文件（没有 .exe，也没有 .dll），只有一个游戏
  数据文件，所以这是误报。修改器不联网，只在游戏内运行。
- 反馈问题时，请附上 %LOCALAPPDATA%\HMS_00\Saved\MatchlessKungFuTrainer 中的
  trainer.log（以及上一次运行的 trainer.prev.log），并写明游戏版本和你装的其他
  Mod。日志里有你的文件夹路径，发布前可以把其中的 Windows 用户名删去。


制作信息
--------
绝世好武功修改器（Matchless KungFu Trainer），作者 Gutwormy。
不含任何第三方代码。
