生化危机4模组菜单

RE4R Mod Menu

一个用于《生化危机4 重制版》的自包含作弊菜单，绘制在自己的标签窗口中，
而不是嵌在 REFramework 面板里。按 HOME 打开，再按 HOME 关闭。

## 安装

无论哪种方式都需要 REFramework。如果你还没安装，请先安装，也就是让 dinput8.dll
与 re4.exe 放在一起。

### Fluffy Mod Manager

1. 将 RE4R Mod Menu 1.3.zip 拖入 Fluffy 的 Games/RE4R/Mods 文件夹，或使用
Add mod 并选择该 zip。
2. 在模组列表中勾选它，然后按 Install mods。
3. 启动游戏。按 HOME。

Fluffy 会从压缩包根目录读取 modinfo.ini 和 screenshot.png 作为元数据，并只将
reframework 目录树部署到游戏文件夹中。取消勾选该模组即可干净地将其移除。

### 手动安装

解压 zip，并将其中的 reframework 文件夹复制到游戏文件夹中，与
re4.exe 放在一起，这样文件会落在 re4/reframework/autorun/ 中。忽略 modinfo.ini
和 screenshot.png，它们只是为了 Fluffy 而存在。

### 无论哪种方式

请先从 reframework/autorun/ 中移除旧的 Infinite Ammo & Durability.lua。它
挂钩了相同的两个方法，两个脚本会因此相互冲突。

## 操作

| 按键 | 操作 |
| --- | --- |
| HOME | 打开和关闭菜单 |
| 左和右 | 切换标签页 |
| 上和下 | 在行之间移动 |
| Enter | 切换当前聚焦的行 |

鼠标也可以使用，但仅在 REFramework 自己的叠加层打开时（Insert），因为
游戏在其他情况下会占用光标。键盘导航是可靠的途径。

打开按键可以在 Settings 标签页中更改。

## 功能

| 标签页 | 选项 | 作用 |
| --- | --- | --- |
| Combat | Invincibility | 提升引擎的无敌标志并阻止死亡调用，包括脚本化死亡 |
| Combat | Instakill | 你造成伤害的任何目标立即降至零生命值 |
| Weapons | Infinite Ammo | 枪械始终报告弹匣已满 |
| Weapons | No Reload | 开火时补充弹匣，因此永远不会开始装填 |
| Weapons | Hide Ammo Counter | 在无限弹药开启时淡出 HUD 计数器 |
| Gear | Infinite Durability | 刀具和可修复装备永不磨损 |
| Economy | Unlimited Pesetas | 每当你消费时，钱包会自动补满 |

设置会保存到 reframework/data/re4_modmenu.json，并在下次启动时恢复。

## 当标题更新导致某些功能失效时

Capcom 会在更新之间重命名内部方法，这就是你之前拥有的 "Game Update Fix"
版本所处理的问题。此模组中的每次查找都会尝试一组已知名称，而不是
一个硬编码名称，Diagnostics 标签页会准确显示绑定了什么。

如果某个功能在该处显示 FAIL，请按 Write type dump for repair。它会写入
reframework/data/re4_modmenu_types.json，其中包含此模组涉及的每个类型的
真实方法和字段名称、实时玩家和敌人上下文的运行时类型、
每个键盘源的状态，以及在整个类型数据库中搜索任何
匹配 damage、health 或 input 的内容。修复方法则是
对 reframework/autorun/re4_modmenu/ 下对应文件中候选列表
进行一行修改。

根据 2026-09-20 转储的版本确认的名称：

| 用途 | 真实名称 |
| --- | --- |
| 钱包 | chainsaw.InventoryManager.get_CurrPTAS 和 setPTAS，包括大写字母 |
| 生命值 | get_HitPoint 返回 chainsaw.HitPoint 对象，而不是数字 |
| 无敌 | chainsaw.HitPoint.set_Invincible 和 PlayerBaseContext.set_IsInvincible |
| 死亡 | chainsaw.HitPoint.dead，为玩家挂钩，并对敌人调用 |
| 敌人 | chainsaw.CharacterManager.get_EnemyContextList |
| 弹匣 | chainsaw.WeaponItem.setAmmoCount，容量则使用 get_CurrentAmmoMax |

在这个版本上不存在 chainsaw.HitPointController，也不存在 chainsaw.PlayerContext，
尽管两者在其他 RE Engine 作品中都很常见。生命值存在于角色
上下文本身，实时子类是 Leon 的 chainsaw.PlayerBaseContext 以及
按敌人类型区分的 chainsaw.Ch1c0z0Context 等。

所有逐帧工作都在 re.on_frame 上运行。UpdateBehavior 应用程序入口确实会
触发，但从它读取的键盘状态不是当前的，因此热键从未在那里注册。
Diagnostics 标签页会统计两个回调，某个功能抛出异常时会被捕获
并在那里报告，而不会连带使菜单崩溃。

致谢：为脚本化死亡阻止 chainsaw.HitPoint.dead 是
Paltryweasel 的 True Invincible 所使用的技术。

## 布局

| 文件 | 职责 |
| --- | --- |
| re4_modmenu.lua | 入口点，注册回调，除此之外没有其他内容 |
| re4_modmenu/state.lua | 设置及其 JSON 持久化 |
| re4_modmenu/input.lua | 键盘轮询和按键按下边沿 |
| re4_modmenu/game.lua | 访问玩家和敌人上下文及其生命值 |
| re4_modmenu/sdkutil.lua | 在重命名候选中查找方法 |
| re4_modmenu/theme.lua | ImGui 颜色和圆角 |
| re4_modmenu/ui.lua | 标签窗口 |
| re4_modmenu/diagnostics.lua | 用于修复的类型转储 |
| re4_modmenu/features/*.lua | 每个功能一个文件，每个都带有 install 和 update |

只有入口点有副作用，因此这些模块可以安全地多次加载。

## 重新打包

modinfo.ini 和 screenshot.png 位于压缩包根目录，供 Fluffy 使用。screenshot.png
是菜单布局的渲染预览，而不是运行中游戏的截图，因此
在你拥有真实截图后请将其替换。

要在编辑后重新构建压缩包，请将 modinfo.ini、screenshot.png 和
reframework 文件夹压缩，并让这三者位于顶层。加一层包装文件夹会导致 Fluffy
无法识别该模组。

## 注意事项

- Invincibility 会设置引擎自身的无敌标志并阻止玩家的死亡
调用，因此抓取、处决和失败的 QTE 也无法杀死你。它会在你
关闭时立即解除，不影响游戏正常的无敌帧。
- Instakill 会读取敌人生命值以察觉命中，然后将其归零并发出引擎死亡
调用。如果 Diagnostics 标签页报告没有绑定生命值获取器，它会列出
chainsaw.HitPoint 提供的真实方法名称，以便修正候选列表。
- No Reload 会在 HUD 弹药检查期间写入武器，因此它只在该
武器被取出时生效。
- 菜单通过 REFramework 暴露的任一输入源读取键盘。如果
热键没有反应，请打开 REFramework，展开 RE4R Mod Menu，然后展开 Keyboard，并
按住该键，同时观察代码行。
- 在线或排行榜模式不是此模组的目标。请在单人游戏中使用。