sevrlbats/smtvv-superjump
GitHub: sevrlbats/smtvv-superjump
一个基于代理 DLL 注入的《真·女神转生 V:复仇》运行时飞行 mod,通过 hook 玩家移动组件实现空中自由飞行与转向。
Stars: 0 | Forks: 0
# SMTVV 飞行
适用于**真·女神转生 V:复仇**(Steam / Windows)的飞行 mod。
基于 MIT License 开源。
在半空中按住 **B**(手柄)或 **SPACE**(键盘)即可上升,同时可在空中进行
转向和掉头(包含 180 度)。松开按键即可下落。
## 操作
| 输入 | 动作 |
|-------|--------|
| 按住 **B** / **SPACE** | 在半空中向上飞行并进行转向 |
| **F8** | 在游戏内关闭 / 开启此 mod |
## 安装说明
1. 关闭游戏。
2. 运行 `install.bat` 并选择 **[1] Install**。它会自动在
常规的 Steam 路径下检测 SMT5V;如果未能找到,它会提示你粘贴你的 SMT5V 文件夹
路径(Steam → 右键点击 SMT5V → 管理 → 浏览本地文件,然后从
地址栏复制路径)。
3. 启动游戏,跳跃,并按住 B / SPACE。
预编译的 `xinput1_3.dll` 可直接使用——无需额外的构建步骤。
## 卸载说明
运行 `uninstall.bat`,或在 `install.bat` 中选择 **[2] Uninstall**。(或者直接从
`SMT5V\Project\Binaries\Win64\` 中删除
`xinput1_3.dll`。) Steam → 验证游戏文件完整性
也可以将其移除。
## 工作原理
该 mod 以 `xinput1_3.dll` 的形式提供,这是一个游戏已导入的代理 DLL。它
原封不动地转发每一个真实的 XInput 调用,并在
游戏进程内运行飞行逻辑:它会轮询 B / SPACE 按键,当在空中按住其中任意一个时,它会反转
玩家移动组件的跳跃重力以实现上升,并驱动水平
速度轴进行转向。它不会修改任何可执行文件的字节,也不会修改任何存档数据,因此
随时添加或移除都是安全的。
## 从源码构建
需要安装带有“Desktop development with C++”工作负载的 **Visual Studio Build Tools**。接着执行:
```
build.bat
```
这会将 `src/` 编译为位于脚本旁的 `xinput1_3.dll`。源码目录结构:
- `src/xinput_proxy.cpp` — XInput 代理及 DLL 入口点
- `src/flight_backend.cpp` — 飞行逻辑、手柄/键盘轮询、移动 hooks
- `src/flight_backend.h`, `src/xinput_proxy.def`
`tools/` 包含了用于定位
移动组件反射表并针对发布版可执行文件验证 hook 地址的
离线逆向工程脚本;`RESEARCH_NOTES.md` 记录了具体的操作过程。(这些是
研究产物,并包含特定于机器的路径。)
## 注意事项
- 单人游戏体验优化 mod。请勿在任何联机环境中使用。
- 游戏 EXE 同级目录下会生成一个小型的 `SMTVVFlight.log` 文件(方便用于反馈
问题)。
## 许可证
MIT — 详见 [LICENSE](LICENSE)。你可自由使用、修改和重新分发它。
标签:C++, DLL劫持, 内存修改, 数据擦除, 游戏Mod, 真女神转生5, 飞行功能