C4 Quick Actions — 可自定义投掷 / 引爆按键
作者：GPT6-Astra + 茄酱馒头
版本：0.2.9-public.1
功能
• 在 MDL3 内修改引爆、投掷、启用／重新校准键，支持键盘单键和鼠标五键，自动保存。
• 默认右键投掷、左键切换并引爆，然后返回投掷模式；默认 F6 启用。
• 投掷期间可排队一次引爆；切回同一把 C4 自动恢复；后台可随 Windows 登录启动。
• 地图保护保持开启：开图按键开启保护，镜头响应只确认关图，关图确认与松键检查并行。
本工具是 MDL3 只读数据桥 + 无窗口外部输入辅助。
必需前置
Windows 10/11 x64、Steam PC 版 Helldivers 2、Arsenal。
已验证组合：MDL3 3.0.0-dev.43 + HD2 Data Hub 0.6.0。旧 dev.33 / Hub 0.3.0 请先升级；其他版本需提供兼容的按键绑定和镜头数据接口。
MDL3 / Data Hub 官方页面：https://ayakamods.com/mods/mdl3-preview-麦当劳3-预览版！.5710/
Arsenal 官方下载：https://rsnl.gg/
包内已含 Python 3.13.17 x64 运行时，无需另装 Python、AutoHotkey 或 Codex。MDL3 / Data Hub 本体不包含在包内。
安装与升级
1. 安装前置，确认游戏中 MDL3 设置可用，然后正常退出游戏。
2. 完整解压 HD2-C4-QuickActions-0.2.9-public.1.zip，运行 INSTALL.bat。
3. 将包内 C4-Context-Bridge.zip 导入 Arsenal，再从游戏 MDL3 库启动 C4 Quick Actions。数据桥可只导入、不部署；MDL3 / Data Hub 本体仍需正确部署。
4. 游戏“快速向左转动武器轮盘”（WeaponFunctionCycleLeft）绑定为 F7，普通开火保留鼠标左键。
5. 进入地面任务，手持处于投掷模式的 C4，关闭地图和菜单，松开按键，按 F6 校准；需要时轻转视角完成地图确认。
从 0.2.6 升级：新 INSTALL.bat 会停止旧公开版后台、备份安装并保留偏好。必须同时重新导入新版数据桥，以同一 Guid 更新旧桥，并确认 MDL3 中只启用一个 C4 Quick Actions。实验版 C4/Solo 后台需先从自己的入口退出，避免两套辅助同时运行。
在 MDL3 内改键
ESC → MDL3 设置 → C4 Quick Actions → 按键绑定。
选择“引爆”“投掷”或“启用／重新校准”，点击后松开鼠标，再按新键。
触发方式保持“按住”：本辅助按下一次执行一次，不会按住连发；点按、长按、双击、切换模式暂不支持。
三项非空绑定不能重复；地图、菜单、修饰键、Win、Pause、F7、F10 为保留键。不支持组合键、滚轮或手柄。
Esc 取消录入，Backspace 清空。动作可留空，启用键必须绑定。可用“恢复默认按键”回到左键／右键／F6。
改键会取消旧校准、丢弃旧排队动作。关闭菜单后，手持 C4 投掷模式，按新启用键重新校准。启用键是手动确认，不是开关切换；Pause 停用。
仍需匹配的游戏键位
快速向左转动武器轮盘：F7；普通开火：鼠标左键。
地图：Tab 开关；聊天：Enter；菜单：Esc。
武器设置：鼠标侧键1（Mouse4）；战略配备：按住鼠标侧键2（Mouse5）。
换枪：1–5 / 滚轮。辅助触发键与上述游戏执行键是两层设置，安装器不会替你改游戏键位。
使用限制与排错
• 新任务、复活、新 C4、手动改变 C4 模式、打开 C4 武器设置、Pause 或重启后台后，确认投掷模式并重新校准。辅助不能直接识别武器真实类型或当前模式。
• 地图、菜单、聊天、失焦、上下文过期时暂停快捷动作。关图仍需足够的镜头移动证据；静止、极小幅移动或快速连续 Tab 可能延迟恢复。
• 本工具未移除投掷动画，不承诺瞬时爆炸或固定的关图恢复时限。
• 能投掷不能引爆：检查游戏实际采用的 F7 绑定。改键后无响应：检查“按住”方式、重复／保留键、新数据桥与重新校准。STATUS.bat 可显示当前三键和暂停原因。
• 标准 LOCALAPPDATA 路径受支持；MDL3 的 ProgramData 路径回退暂不支持。
• 公开包只包含 C4 辅助，不包含单人驾驶、载弹量或补给量补丁；本版依赖 MDL3，未移植 Hellforge。
启动、停止与卸载
包内提供 START、STOP、STATUS、自启动开关与 UNINSTALL 批处理入口。退出游戏后，从最初解压包运行 UNINSTALL.bat；数据桥可另在 Arsenal 移除。日志、设置和升级备份会保留。完整说明见中英文 README。
验证与致谢
自定义启用、投掷与引爆已获使用者实机确认。公开包通过 137 项回归、改键、地图与安装检查，包含从 0.2.6 升级测试；未声称多机器全面验证。
本辅助和桥接代码为项目制作；OpenAI Codex 协助实现、调试与说明。
MDL3 / HD2 Data Hub：M!ni$try0fSc!eиce。Python：Python Software Foundation，随包保留许可证。
English summary
Configure detonate, throw and activation keys inside MDL3. Defaults: LMB detonate, RMB throw, F6 activate/recalibrate. Keep trigger mode at HOLD (once per press). Settings persist; recalibrate with the new activation key after changing bindings. Improved map-close confirmation retains map protection.
Requires Windows x64, Steam Helldivers 2, Arsenal, MDL3 dev.43 and HD2 Data Hub 0.6.0 (tested). Python is bundled. Close the game, extract the full archive, run INSTALL.bat and import/replace C4-Context-Bridge.zip in Arsenal; enable one C4 Quick Actions bridge in MDL3. Upgrade both helper and bridge. Native WeaponFunctionCycleLeft must remain F7 and primary fire LMB. See README_EN.txt for complete bindings, upgrade instructions and limitations.
作者：GPT6-Astra + 茄酱馒头
版本：0.2.9-public.1
功能
• 在 MDL3 内修改引爆、投掷、启用／重新校准键，支持键盘单键和鼠标五键，自动保存。
• 默认右键投掷、左键切换并引爆，然后返回投掷模式；默认 F6 启用。
• 投掷期间可排队一次引爆；切回同一把 C4 自动恢复；后台可随 Windows 登录启动。
• 地图保护保持开启：开图按键开启保护，镜头响应只确认关图，关图确认与松键检查并行。
本工具是 MDL3 只读数据桥 + 无窗口外部输入辅助。
必需前置
Windows 10/11 x64、Steam PC 版 Helldivers 2、Arsenal。
已验证组合：MDL3 3.0.0-dev.43 + HD2 Data Hub 0.6.0。旧 dev.33 / Hub 0.3.0 请先升级；其他版本需提供兼容的按键绑定和镜头数据接口。
MDL3 / Data Hub 官方页面：https://ayakamods.com/mods/mdl3-preview-麦当劳3-预览版！.5710/
Arsenal 官方下载：https://rsnl.gg/
包内已含 Python 3.13.17 x64 运行时，无需另装 Python、AutoHotkey 或 Codex。MDL3 / Data Hub 本体不包含在包内。
安装与升级
1. 安装前置，确认游戏中 MDL3 设置可用，然后正常退出游戏。
2. 完整解压 HD2-C4-QuickActions-0.2.9-public.1.zip，运行 INSTALL.bat。
3. 将包内 C4-Context-Bridge.zip 导入 Arsenal，再从游戏 MDL3 库启动 C4 Quick Actions。数据桥可只导入、不部署；MDL3 / Data Hub 本体仍需正确部署。
4. 游戏“快速向左转动武器轮盘”（WeaponFunctionCycleLeft）绑定为 F7，普通开火保留鼠标左键。
5. 进入地面任务，手持处于投掷模式的 C4，关闭地图和菜单，松开按键，按 F6 校准；需要时轻转视角完成地图确认。
从 0.2.6 升级：新 INSTALL.bat 会停止旧公开版后台、备份安装并保留偏好。必须同时重新导入新版数据桥，以同一 Guid 更新旧桥，并确认 MDL3 中只启用一个 C4 Quick Actions。实验版 C4/Solo 后台需先从自己的入口退出，避免两套辅助同时运行。
在 MDL3 内改键
ESC → MDL3 设置 → C4 Quick Actions → 按键绑定。
选择“引爆”“投掷”或“启用／重新校准”，点击后松开鼠标，再按新键。
触发方式保持“按住”：本辅助按下一次执行一次，不会按住连发；点按、长按、双击、切换模式暂不支持。
三项非空绑定不能重复；地图、菜单、修饰键、Win、Pause、F7、F10 为保留键。不支持组合键、滚轮或手柄。
Esc 取消录入，Backspace 清空。动作可留空，启用键必须绑定。可用“恢复默认按键”回到左键／右键／F6。
改键会取消旧校准、丢弃旧排队动作。关闭菜单后，手持 C4 投掷模式，按新启用键重新校准。启用键是手动确认，不是开关切换；Pause 停用。
仍需匹配的游戏键位
快速向左转动武器轮盘：F7；普通开火：鼠标左键。
地图：Tab 开关；聊天：Enter；菜单：Esc。
武器设置：鼠标侧键1（Mouse4）；战略配备：按住鼠标侧键2（Mouse5）。
换枪：1–5 / 滚轮。辅助触发键与上述游戏执行键是两层设置，安装器不会替你改游戏键位。
使用限制与排错
• 新任务、复活、新 C4、手动改变 C4 模式、打开 C4 武器设置、Pause 或重启后台后，确认投掷模式并重新校准。辅助不能直接识别武器真实类型或当前模式。
• 地图、菜单、聊天、失焦、上下文过期时暂停快捷动作。关图仍需足够的镜头移动证据；静止、极小幅移动或快速连续 Tab 可能延迟恢复。
• 本工具未移除投掷动画，不承诺瞬时爆炸或固定的关图恢复时限。
• 能投掷不能引爆：检查游戏实际采用的 F7 绑定。改键后无响应：检查“按住”方式、重复／保留键、新数据桥与重新校准。STATUS.bat 可显示当前三键和暂停原因。
• 标准 LOCALAPPDATA 路径受支持；MDL3 的 ProgramData 路径回退暂不支持。
• 公开包只包含 C4 辅助，不包含单人驾驶、载弹量或补给量补丁；本版依赖 MDL3，未移植 Hellforge。
启动、停止与卸载
包内提供 START、STOP、STATUS、自启动开关与 UNINSTALL 批处理入口。退出游戏后，从最初解压包运行 UNINSTALL.bat；数据桥可另在 Arsenal 移除。日志、设置和升级备份会保留。完整说明见中英文 README。
验证与致谢
自定义启用、投掷与引爆已获使用者实机确认。公开包通过 137 项回归、改键、地图与安装检查，包含从 0.2.6 升级测试；未声称多机器全面验证。
本辅助和桥接代码为项目制作；OpenAI Codex 协助实现、调试与说明。
MDL3 / HD2 Data Hub：M!ni$try0fSc!eиce。Python：Python Software Foundation，随包保留许可证。
English summary
Configure detonate, throw and activation keys inside MDL3. Defaults: LMB detonate, RMB throw, F6 activate/recalibrate. Keep trigger mode at HOLD (once per press). Settings persist; recalibrate with the new activation key after changing bindings. Improved map-close confirmation retains map protection.
Requires Windows x64, Steam Helldivers 2, Arsenal, MDL3 dev.43 and HD2 Data Hub 0.6.0 (tested). Python is bundled. Close the game, extract the full archive, run INSTALL.bat and import/replace C4-Context-Bridge.zip in Arsenal; enable one C4 Quick Actions bridge in MDL3. Upgrade both helper and bridge. Native WeaponFunctionCycleLeft must remain F7 and primary fire LMB. See README_EN.txt for complete bindings, upgrade instructions and limitations.
