空气悬挂双向系统

《侠盗猎车手V》空气悬挂双轴控制 MOD 使用指南
【核心介绍】
提供真实车辆姿态调节（前/后独立升降）、动态刮擦音效、精准火花粒子及可开关HUD，显著提升空气悬挂的视觉反馈与操控沉浸感。
【安装指南】
1. 必备前置依赖：本MOD安装前，需同步安装前置依赖的MOD「VStancer」；并确保已安装「ScriptHookV」、「ScriptHookVDotNet3」（夜间构建 v3.7.0 或更高）、「NAudio.dll」、「NativeUI.dll」；
2. 将以下文件复制到游戏根目录 `/scripts` 文件夹中：
– `AirSuspension2way.dll`
– `AirSuspension2way.ini`
– `Audio2Way/` 文件夹（含全部音效文件）
3. 启动《侠盗猎车手V》，MOD 即可运行 —— 缺一不可，路径错误将导致功能失效。
【功能详情】
✅ 已优化：
– 前/后独立升降控制（数字键盘 8/2、I/K/O/L）
– 新HUD界面（可按键开关）
– 刮擦音效 + 火花粒子（基于车辆局部坐标系生成，消除侧向偏差，贴地更精准）
– 垂直偏移使用车辆上方向向量计算，底部位置通过局部偏移校准
– 横向抖动降低，车道宽度保持初始设定范围
❌ 未修改：
– 车辆基础物理参数（如重心、悬挂刚度）
– 轮胎模型、底盘结构等原生车辆定义文件
✨ 额外调整：
– 新增两种阀门响应模式（慢速/快速），按数字键盘 / = 切换
– 所有音效音量、粒子密度/尺寸/扩散范围、金属效果缩放等均支持 `.ini` 文件精细调节
【使用要求】
– 游戏版本：《侠盗猎车手V》PC 正版（含最新更新）
– 必装组件：「ScriptHookV」、「ScriptHookVDotNet3」（v3.7.0+ 夜间构建）、「NAudio.dll」、「NativeUI.dll」
– 依赖模组：必须已安装并启用「VStancer」（用于外倾角、轮距等协同调校）
【兼容性说明】
– 兼容范围：所有使用标准 ScriptHookVDotNet3 加载机制的脚本模组
– 不兼容模组：「VStancer」旧版（v1.x）、非官方精简版 ScriptHookVDotNet
– 兼容补丁：暂未推出（请务必使用推荐版本组合）
【注意事项】
– 刮擦音效与粒子仅在车辆低速拖底或剧烈颠簸时触发，属正常行为
– HUD 默认开启；按 F5 可开关 HUD 显示（详见 `AirSuspension2way.ini` 中 `ShowHUD` 设置）
– 若粒子缺失或音效无声，请检查 `/scripts/Audio2Way/` 文件夹是否完整、路径大小写是否一致
– 调整过程中若出现异常抖动，建议先关闭 `DebugMode = true` 并重启游戏
【更新日志】
2024 年 X 月 X 日 v2.0.5
– 新增慢速/快速两种阀门响应模式，按数字键盘 `/ =` 切换
2024 年 X 月 X 日 v2.0.4
– 重制 HUD 界面，支持开关控制
– 新增刮擦音效与火花粒子效果
– 改用车辆局部坐标系生成火花，消除侧向偏差；垂直偏移与底盘贴地逻辑全面重构
– 优化横向稳定性，锁定车道宽度一致性
2024 年 X 月 X 日 v2.0.3（测试版）
– 首次公开测试版，上线基础刮擦/释放音效
– 开放粒子字典、扩散范围、图层及音量等配置项