zebkii的冲撞发射 - 让汽车飞起来

交通现在只是一种建议。

Zebkii 的冲撞发射（Ram Launch）会在其他车辆与你正在行驶的车相撞时将它们撞飞。坐上驾驶座，开启它，让一次普通的自由城驾驶变成彻头彻尾的胡闹。

根据你希望自己的通勤有多不讲道理，选择 Gentle、Big 或 Wild。

特性
• 接触时将其他车辆从你的车旁撞飞并抛向空中。
• 三种强度预设：Gentle、Big 和 Wild。
• 游戏过程中可切换该效果。
• 可在 INI 中自定义发射高度、距离、最低速度和热键。
• 适用于你正在驾驶的任何车辆；无需特定车型。
• 不修改 handling.dat，也不替换原始游戏文件。
• 每次脚本加载时默认为关闭。
• 仅限单人游戏；多人游戏中该效果被禁用。

要求
• PC 版 GTA IV。Zebkii 已在 Steam 完整版 1.2.0.59 上确认可用。
• 一个 ASI 加载器，例如 Ultimate ASI Loader。
• Aru 的 ScriptHook.dll。
• HazardX ScriptHookDotNet。对于完整版，请使用兼容 CE 的配置，包含 aCompleteEditionHook.asi 和更新后的 ScriptHookDotNet.asi。

依赖项需单独下载，不包含在本模组中。
此脚本不要求 FusionFix 和 Liberty's Legacy。该模组在 Zebkii 的配置上安装它们后进行了测试；这并不保证与所有模组组合都兼容。

依赖链接：
Ultimate ASI Loader：https://github.com/ThirteenAG/Ultimate-ASI-Loader/releases
HazardX .Net ScriptHook 包：https://hazardx.com/files/gta4_net_scripthook-83
完整版兼容补丁：https://www.lcpdfr.com/downloads/gta4mods/g17media/26726-compatibility-patch-for-gta-iv-complete-edition/

CE 补丁包含更新后的 ScriptHookDotNet.asi 和 aCompleteEditionHook.asi；仍然需要 Aru 的原始 ScriptHook.dll。请遵循依赖作者的说明。如果你的 .NET 脚本已经可以运行，请保持该可用配置。

安装
• 关闭 GTA IV。
• 下载并解压 Zebkii-RamLaunch-v0.2.zip。
• 将包含的 scripts 文件夹复制到包含 GTAIV.exe 的文件夹中。
• 如果你已有 scripts 文件夹，请合并这些文件夹。
• 启动游戏并加载你的存档。
• 坐进驾驶座并按 F9 启用 Ram Launch。
• 开车撞向另一辆车。

你的文件应位于：
GTAIV\scripts\ZebkiiRamLaunch.cs
GTAIV\scripts\ZebkiiRamLaunch.ini

不要将外层下载文件夹放入 scripts 中。不要将 .cs 文件重命名为 .asi 或 .dll。ScriptHookDotNet 会在加载时编译该 C# 源代码。

操作
F9 — 开启或关闭 Ram Launch。
F10 — 循环切换 Gentle / Big / Wild。

起始强度为 Big，因此你第一次按 F10 会选择 Wild。强度更改仅在当前游戏会话中有效。
你可以使用控制器驾驶，但默认情况下，切换和更改强度使用键盘热键。

自定义
关闭游戏，并用记事本打开 scripts\ZebkiiRamLaunch.ini。

HorizontalForce=35.0 — 增大可让向外推的力更强。
UpwardForce=18.0 — 增大可让发射高度更高。
MinimumSpeed=2.0 — 你自己车辆的最低速度，单位为米每秒。
SkipMissionVehicles=false — 设为 true 可排除被标记为任务所需的车辆。
ToggleKey=F9 — 更改切换键。
StrengthKey=F10 — 更改强度键。

使用诸如 F6 或 F8 之类的键名。编辑后请重启游戏。
力值为冲量，不保证实际移动速度或距离。结果会因车辆和碰撞而异。三个预设会同时按比例缩放两个力值。

工作原理 / 限制
该脚本会在你驾驶且速度高于最低速度时检查实际车辆接触。它会向另一辆车施加向外和向上的力，并带有冷却时间，以防止同一次接触期间重复发射。

• 另一辆车撞上你正在行驶的车也可能触发该效果。它不会判定是谁造成了碰撞。
• 你自己的车仍会受到正常损伤。此模组不会启用无敌模式。
• 不会修改 NPC 与 NPC 之间的碰撞。
• 极短暂的接触可能会在脚本更新之间被遗漏。
• 该效果可能干扰任务车辆和脚本化序列。必要时在任务期间将其关闭；可选的任务过滤器并不能保证万无一失。
• 如果其他碰撞力模组或 Showtime 风格脚本的效果会叠加，请在使用它们时禁用此模组。
• 较旧的游戏补丁以及 Episodes from Liberty City 战役尚未单独测试。

故障排除
F9 无反应 / 没有加载消息：
检查上述文件路径，并确保 ScriptHookDotNet 已安装并正在加载。尝试该模组后，打开 GTAIV.exe 旁的 ScriptHookDotNet.log。报告问题时请附上相关错误。

错误提到 HashSet：
你使用的是旧的测试脚本。用 v0.2 中包含的版本替换 scripts\ZebkiiRamLaunch.cs。移除任何重复的旧版 Ram Launch 脚本副本。

菜单显示 ON 但车辆不会被撞飞：
确保你是驾驶员，你的车正在移动，并且你实际接触到了另一辆车。尝试另一辆车。检查 INI 中的 MinimumSpeed 和 SkipMissionVehicles。

热键与其他模组冲突：
在 INI 中更改 ToggleKey 或 StrengthKey 并重启。

报告问题时，请附上你的游戏版本、ScriptHookDotNet.log、其他玩法模组，以及所发生情况的简短描述。

更新
关闭游戏，并替换 scripts 中的旧 ZebkiiRamLaunch.cs。如果你想保留自定义设置，请先备份你的 INI。只保留该脚本的一份副本。

卸载
关闭游戏并移除以下两个文件：
scripts\ZebkiiRamLaunch.cs
scripts\ZebkiiRamLaunch.ini

如果其他模组使用共享依赖项，请保留它们。

更新日志
v0.2 — 修复了由 HashSet/System.Core 引起的源加载器编译错误。修复后由 Zebkii 在游戏中确认可用。与原始测试版本相比没有玩法更改。
v0.1 — 初始私人测试版本，包含接触发射、三种强度预设、热键和 INI 设置。

鸣谢
Zebkii — 概念、指导和游戏内测试。
ChatGPT / Codex — 自定义脚本实现和调试协助。
HazardX — GTA IV .Net ScriptHook。
Aru — GTA IV C++ ScriptHook。
LMS — 完整版兼容补丁。
ThirteenAG — Ultimate ASI Loader。