1 157
51
1 157
51
zh:
我想说的话: 很高兴,能在三年后让 VehFuncsV能够重新回到GTAV中,由于 VehFuncsV没有开源,所有代码均由我编写,通过OpenAI的ChatGPT5.6sol辅助完成.所以几乎是重头开发，没有任何反编译与逆向原VehFuncsV。但也正是因为重头开发，所以SukiVFV可能并不能完全支持那些曾经的VehFuncsV配置文件。但是经过我的测试,大部分的VehFuncsV旧文件,你只需要更改键位也就是customkey即可。我不喜欢VehFuncsV那反向按键思路，所以我更改了。
由于从立项到开发，没有任何作者能够愿意将车辆提交给我测试，所以我无法保证原VehFuncsV大部分的功能都是否能运行，如果你在测试自己车辆时发现ScripthookV报错,那可能是不支持，你可以通过联系我，提交你的车辆dlc.rpf与ini配置文件，这样我会自己反复测试用于抓取车辆的骨骼节点与目标偏移值。（另外，谢谢你信任我:）
记住 这个VehFuncsV脚本现在叫SukiVFV,在你们制作带有该功能时的车辆发布时,可以添加[SukiVFV] ！
谢谢你尊重我的开发成果，我不知道我是否该采取付费更新，或许。。。我能坚持到这个插件接近完美的时刻？
在使用前请务必阅读md.，SukiVFVSampleCar.ini ，Code Explanations.ini,整体编写ini思路与VehFuncsV相符
————————
🧩 插件名称：SukiVFV
支持版本：🎮 Legacy 1.0.3889.0🎮 Enhanced 1.0.1158.13
开发版本： SukiVFV-0.7.0-Public-Beta
环境需求： ScriptHookV
————————————————————
✨ 插件特点
✅ 自动检测并支持RealZolika1351 VehFuncsV v1.44 格式编写的旧车辆 INI
✅ 完全支持增强版与传承版
🔥 支持热调试：修改配置后，将焦点重新切回游戏即可立即应用调整
🔧 几乎支持所有旧版本 VehFuncsV 编码，仅需修改键位即可使用
🚗 支持离开载具后自行设置是否恢复动画 由 RestoreOnVehicleExit 控制，可选择离车保持或恢复动画
⌨️ 支持多键组合绑定，键位设置更加符合逻辑
🚘 支持多车辆配置同时运行
🎬 已实测动画 包括但不限于：
🌧️ 雨刷动画
⬆️ 底盘升降
🪽 尾翼展开与收回
🪞 后视镜动画
🪟 玻璃升降
📈 RPM 指针动画与换挡回落
⚠️ 暂未充分测试的骨骼
由于暂无合适车辆进行测试，以下功能暂不保证可以正常运行：
move · gas · brake · steer · sequential_shifterhandbrake · rpm_move · door_link · popup_lightbone_link · turbo · engine_tempengine_health · headlights
📦 安装教程
将全部文件放入游戏根目录即可。
📄 文件说明
SukiVFV.asi：统一入口，版本 0.9.0，同时支持新版 SukiVFV 格式和 RealZolika1351 VehFuncsV v1.44 旧格式。
SukiVFV.ini：新旧两种格式共同使用的全局设置文件，包括离车后恢复部件状态等设置。
SukiVFV/Suki_VehFuncsV/：新版 SukiVFV 车辆 INI 的安装目录，内含代码说明与官方配置示例。
SukiVFV/Old_VehFuncsV/：VehFuncsV v1.44 旧格式车辆 INI 的安装目录。
SukiVFV/Old_VehFuncsV/VehFuncsV.ini：旧格式使用的全局键位和 NeutralIsRainy 设置。
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini：VehFuncsV v1.44 旧格式官方配置示例。
README.zh-CN.md 与 README.en.md：0.9.0 的中英文安装、目录结构和兼容性说明。
CHANGELOG-0.9.0.md：0.9.0 中英文更新日志，包含统一新旧格式、动画速度兼容、灯光 ID 检测和其他更新内容。
Credits.txt：项目贡献者、测试人员和赞助者名单。
SHA256SUMS.txt：发布包内所有主要文件的 SHA256 校验值。
注意：0.9.0 不再提供独立的 OldSukiVFV.asi。新版与旧版配置均由同一个 SukiVFV.asi 加载。旧的游戏根目录 VehFuncsV 不再被扫描。
📚 使用前须知
在使用插件前，请务必阅读：
📖 md.📖 SukiVFVSampleCar.ini📖 Code Explanations.ini
整体配置编写思路与 VehFuncsV 相符。
💬 如果你有车辆可以测试相关功能，或者暂时不会编写功能，欢迎在评论区留言交流！
——更新日志:0.9.0——
兼容性改进：
- [Legacy + Enhanced] 将 OldSukiVFV 旧格式功能合并进单一 `SukiVFV.asi`。统一入口严格扫描 `SukiVFV/Suki_VehFuncsV` 与 `SukiVFV/Old_VehFuncsV`，共享根目录 `SukiVFV.ini`，并在同车型冲突时优先使用 `Old_VehFuncsV`；旧根目录 `VehFuncsV` 不再扫描。
- [Legacy + Enhanced] 统一日志写入 `SukiVFV.log`；运行时消息按 `SukiVehFuncsV` 或 `OldSukiVehFuncsV` 来源标注，启动、内存探测和共享设置等无法归属单一格式的消息标注两套来源。
- [Legacy only] 新增 GTA V Legacy `1.0.2628.2` 和 `1.0.3725.0` 支持。它们使用与 Legacy `1.0.3889.0` 相同的骨骼布局，并继续经过完整车辆预检、矩阵验证和失败停写保护。Enhanced `1.0.1158.13` 不属于本条新增版本支持，但继续使用既有 Enhanced 后端和保护机制。
- [Legacy + Enhanced] `oscillate` 的 `Speed` 现在按照 RealZolika1351 VehFuncsV 的速度表现进行换算。该行为按运动类型应用于所有旋转和位移通道，不只限于雨刷；实际每秒循环数为 `Speed x 7 / 15`。
- [Legacy + Enhanced] `rpm_move` 的 `Speed` 现在按照 VehFuncsV 的速度表现进行换算；实际每秒速度为 `Speed x 20 x 当前归一化 RPM`。若当前游戏版本无法安全识别 RPM 数据，则仅停用相关 RPM 动画。
- [Legacy + Enhanced] 新增车辆灯光 ID `3`、`4`、`9`～`17` 的动画条件：尾灯、刹车灯、倒车灯和额外灯光均可通过语义名称或 `light_ID` 写入 INI。每个 ID 可独立绑定动画通道，但游戏反馈仍按车辆状态组共享：左右尾灯共享主灯状态，三只刹车灯共享制动状态，左右倒车灯共享倒车状态，四个额外灯共享主灯状态。
- [Legacy + Enhanced] SukiVFV 与 OldSukiVFV 共享上述换算。旧 VehFuncsV INI 中的 `oscillate` 和 `rpm_move` 速度值可直接使用，不再需要为这两种运动逐车手工调整。
- [Legacy + Enhanced] `move`、`toggle` 以及输入映射运动继续保持原有单位和行为；本次更新没有把所有运动类型强制改为统一速度单位。
修复：
- [Legacy + Enhanced] 修复配置目录中存在被拒绝的 INI 时，插件每次检查都会误判配置发生变化并重复加载全部文件的问题。被拒绝的文件现在同样会记录时间戳，只有实际新增、删除或修改 INI 时才重载，避免雨刷、`rpm_move` 和其他有状态动画反复复位、迟疑或卡顿。
文档与测试：
- [Legacy + Enhanced] 更新代码说明和示例，明确 `oscillate`、`rpm_move`、`move` 与 `toggle` 的不同速度语义。
- [Legacy + Enhanced] 将示例中的 `rpm_move Speed=18` 校准为最大 RPM 时每秒 360 度。
- [Legacy + Enhanced] 新增基于旧 VehFuncsV 车辆配置数值的速度兼容回归测试，并同步修正负角度摆动测试的周期时间步长。
- [Legacy only] 新增 Legacy `1.0.2628.2`、`1.0.3725.0` 的版本分类、骨骼布局和受保护写入权限回归测试。
——更新日志:0.8.1——
见[CHANGELOG-0.9.0.md]下方
en:
A Few Words From the Developer
I’m very happy to bring VehFuncsV back to GTA V after three years.
Since VehFuncsV was never open-source, all code in this project has been written by me, with assistance from OpenAI’s ChatGPT 5.6sol. This is almost a complete rebuild from scratch—none of the original VehFuncsV was decompiled or reverse-engineered.
Because it was rebuilt from the ground up, SukiVFV may not fully support every old VehFuncsV configuration file. However, based on my testing, most older VehFuncsV .ini files should work after updating the keybind setting, customkey. I didn’t like VehFuncsV’s reversed key-input logic, so I changed it in SukiVFV.
From planning through development, no vehicle creators were willing to submit vehicles for testing. As a result, I cannot guarantee that all original VehFuncsV features will work correctly with every vehicle.
If you encounter a ScriptHookV error while testing your vehicle, it may mean that a feature is not supported yet. You can contact me and submit your vehicle’s dlc.rpf file along with its .ini configuration file. I will test it repeatedly to identify the vehicle’s bone nodes and the required offset values.
Also, thank you for trusting me. :)
Please remember that this script is now called SukiVFV. When releasing vehicles that use its features, you may add [SukiVFV] to the release post or description.
Thank you for respecting my work. I’m still unsure whether I should eventually move to paid updates. Maybe… I can keep working on this until the plugin is close to perfect.
Before using SukiVFV, please make sure to read md.， SukiVFVSampleCar.ini and Code Explanations.ini. The overall .ini configuration approach remains consistent with VehFuncsV.
Plugin Information
🧩 Plugin Name: SukiVFV
Supported Versions:
🎮 Legacy 1.0.3889.0
🎮 Enhanced 1.0.1158.13
Development Version: SukiVFV-0.7.0-Public-Beta
Requirements: ScriptHookV
————————————————————
✨ Features
✅ Automatically detects and supports legacy vehicle .ini files written for RealZolika1351’s VehFuncsV v1.44 format.
✅ Full support for both GTA V Enhanced and Legacy
🔥 Supports hot reloading: after editing a configuration file, simply switch focus back to the game to apply the changes immediately
🔧 Supports almost all legacy VehFuncsV configurations; only the keybind settings need to be changed
🚗 Lets you choose whether animations are restored after leaving a vehicle
Controlled by RestoreOnVehicleExit, allowing animation states to either remain as they are or reset when exiting the vehicle
⌨️ Supports multi-key combinations with more logical keybind behavior
🚘 Supports multiple vehicle configurations running at the same time
🎬 Tested Animations Including, but not limited to:
🌧️ Windshield wipers
⬆️ Suspension height adjustment
🪽 Spoiler deployment and retraction
🪞 Rear-view mirror animations
🪟 Window roll-up and roll-down animations
📈 RPM needle animation and gear-shift drop
⚠️ Bone Functions Not Yet Fully Tested
Due to the lack of suitable test vehicles, the following functions are not guaranteed to work properly yet:
move · gas · brake · steer · sequential_shifter
handbrake · rpm_move · door_link · popup_light
bone_link · turbo · engine_temp
engine_health · headlights
📦 Installation
Extract all files to your GTA V root directory.
📄 File Description
SukiVFV.asi: Unified entry point, version 0.9.0. It supports both the new SukiVFV format and legacy RealZolika1351 VehFuncsV v1.44 configurations.
SukiVFV.ini: Shared global settings for both configuration formats, including restoration behavior after leaving a vehicle.
SukiVFV/Suki_VehFuncsV/: Installation directory for new-format SukiVFV vehicle INIs. It includes code explanations and an official configuration example.
SukiVFV/Old_VehFuncsV/: Installation directory for legacy VehFuncsV v1.44 vehicle INIs.
SukiVFV/Old_VehFuncsV/VehFuncsV.ini: Global key bindings and the NeutralIsRainy setting used by legacy-format configurations.
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini: Official VehFuncsV v1.44 legacy-format configuration example.
README.zh-CN.md and README.en.md: Chinese and English installation, directory layout, and compatibility documentation for version 0.9.0.
CHANGELOG-0.9.0.md: Chinese and English changelog covering unified format support, animation-speed compatibility, light ID detection, and other changes in version 0.9.0.
Credits.txt: List of project contributors, testers, and sponsors.
SHA256SUMS.txt: SHA256 checksums for the main files included in the release.
Note: Version 0.9.0 no longer includes a separate OldSukiVFV.asi. Both new and legacy configurations are loaded by the unified SukiVFV.asi. The former root-level VehFuncsV directory is no longer scanned.
📚 Before You Use It
Before using the plugin, please make sure to read:
📖 README.md
📖 SukiVFVSampleCar.ini
📖 Code Explanations.ini
The overall configuration structure follows the same general approach as VehFuncsV.
💬 If you have a vehicle that can be used to test these features, or if you are not yet sure how to write a configuration, feel free to leave a comment and join the discussion!
——CHANGELOG-0.9.0——
Compatibility improvements:
- [Legacy + Enhanced] Merged OldSukiVFV legacy-format support into a single `SukiVFV.asi`. The unified entry point strictly scans `SukiVFV/Suki_VehFuncsV` and `SukiVFV/Old_VehFuncsV`, shares the root `SukiVFV.ini`, and gives `Old_VehFuncsV` priority for duplicate models; the former root `VehFuncsV` directory is no longer scanned.
- [Legacy + Enhanced] Unified logging writes to `SukiVFV.log` and labels runtime messages as `SukiVehFuncsV` or `OldSukiVehFuncsV`; startup, memory-probe, and shared-setting messages that belong to both formats carry both source labels.
- [Legacy only] Added GTA V Legacy `1.0.2628.2` and `1.0.3725.0` support. These builds use the same bone layout as Legacy `1.0.3889.0` while retaining complete vehicle preflight, matrix validation, and fail-closed write protection. Enhanced `1.0.1158.13` is not a new target in this item; it continues to use the existing Enhanced backend and protection.
- [Legacy + Enhanced] `oscillate` `Speed` values now follow RealZolika1351 VehFuncsV timing. The conversion applies by motion type to every rotation and translation channel, not only to wipers; effective cycles per second are `Speed x 7 / 15`.
- [Legacy + Enhanced] `rpm_move` `Speed` values now follow VehFuncsV timing; effective speed per second is `Speed x 20 x current normalized RPM`. If RPM data cannot be identified safely for the current build, only the affected RPM animation is disabled.
- [Legacy + Enhanced] Added animation conditions for vehicle light IDs `3`, `4`, and `9`-`17`: tail lights, brake lights, reversing lights, and extra lights can be addressed by semantic names or `light_ID` in an INI. Each ID can be bound to its own animation channel, while game feedback remains grouped by vehicle state: both tail lights share the main-light state, the three brake lights share braking, the two reversing lights share reversing, and the four extra lights share the main-light state.
- [Legacy + Enhanced] SukiVFV and OldSukiVFV share these conversions. Existing VehFuncsV INIs can use their original `oscillate` and `rpm_move` speed values without per-vehicle edits for these two motion types.
- [Legacy + Enhanced] `move`, `toggle`, and input-mapped motions retain their existing units and behavior. This update does not force every motion type into one common speed unit.
Fixes:
- [Legacy + Enhanced] Fixed repeated full configuration reloads when the configuration directory contained a rejected INI. Rejected files now retain observed timestamps, so reloads occur only when an INI is actually added, removed, or modified. This prevents wipers, `rpm_move`, and other stateful animations from repeatedly resetting, hesitating, or stuttering.
Documentation and tests:
- [Legacy + Enhanced] Updated the code explanations and sample configuration to distinguish the speed semantics of `oscillate`, `rpm_move`, `move`, and `toggle`.
- [Legacy + Enhanced] Calibrated the sample `rpm_move Speed=18` to produce 360 degrees per second at maximum RPM.
- [Legacy + Enhanced] Added speed-compatibility regression coverage based on legacy VehFuncsV vehicle values and corrected the cycle time step in the negative-angle oscillation test.
- [Legacy only] Added regression coverage for Legacy `1.0.2628.2` and `1.0.3725.0` classification, bone layout, and guarded-write permission.
——CHANGELOG-0.8.1——
See below CHANGELOG-0.9.0.md
我想说的话: 很高兴,能在三年后让 VehFuncsV能够重新回到GTAV中,由于 VehFuncsV没有开源,所有代码均由我编写,通过OpenAI的ChatGPT5.6sol辅助完成.所以几乎是重头开发，没有任何反编译与逆向原VehFuncsV。但也正是因为重头开发，所以SukiVFV可能并不能完全支持那些曾经的VehFuncsV配置文件。但是经过我的测试,大部分的VehFuncsV旧文件,你只需要更改键位也就是customkey即可。我不喜欢VehFuncsV那反向按键思路，所以我更改了。
由于从立项到开发，没有任何作者能够愿意将车辆提交给我测试，所以我无法保证原VehFuncsV大部分的功能都是否能运行，如果你在测试自己车辆时发现ScripthookV报错,那可能是不支持，你可以通过联系我，提交你的车辆dlc.rpf与ini配置文件，这样我会自己反复测试用于抓取车辆的骨骼节点与目标偏移值。（另外，谢谢你信任我:）
记住 这个VehFuncsV脚本现在叫SukiVFV,在你们制作带有该功能时的车辆发布时,可以添加[SukiVFV] ！
谢谢你尊重我的开发成果，我不知道我是否该采取付费更新，或许。。。我能坚持到这个插件接近完美的时刻？
在使用前请务必阅读md.，SukiVFVSampleCar.ini ，Code Explanations.ini,整体编写ini思路与VehFuncsV相符
————————
🧩 插件名称：SukiVFV
支持版本：🎮 Legacy 1.0.3889.0🎮 Enhanced 1.0.1158.13
开发版本： SukiVFV-0.7.0-Public-Beta
环境需求： ScriptHookV
————————————————————
✨ 插件特点
✅ 自动检测并支持RealZolika1351 VehFuncsV v1.44 格式编写的旧车辆 INI
✅ 完全支持增强版与传承版
🔥 支持热调试：修改配置后，将焦点重新切回游戏即可立即应用调整
🔧 几乎支持所有旧版本 VehFuncsV 编码，仅需修改键位即可使用
🚗 支持离开载具后自行设置是否恢复动画 由 RestoreOnVehicleExit 控制，可选择离车保持或恢复动画
⌨️ 支持多键组合绑定，键位设置更加符合逻辑
🚘 支持多车辆配置同时运行
🎬 已实测动画 包括但不限于：
🌧️ 雨刷动画
⬆️ 底盘升降
🪽 尾翼展开与收回
🪞 后视镜动画
🪟 玻璃升降
📈 RPM 指针动画与换挡回落
⚠️ 暂未充分测试的骨骼
由于暂无合适车辆进行测试，以下功能暂不保证可以正常运行：
move · gas · brake · steer · sequential_shifterhandbrake · rpm_move · door_link · popup_lightbone_link · turbo · engine_tempengine_health · headlights
📦 安装教程
将全部文件放入游戏根目录即可。
📄 文件说明
SukiVFV.asi：统一入口，版本 0.9.0，同时支持新版 SukiVFV 格式和 RealZolika1351 VehFuncsV v1.44 旧格式。
SukiVFV.ini：新旧两种格式共同使用的全局设置文件，包括离车后恢复部件状态等设置。
SukiVFV/Suki_VehFuncsV/：新版 SukiVFV 车辆 INI 的安装目录，内含代码说明与官方配置示例。
SukiVFV/Old_VehFuncsV/：VehFuncsV v1.44 旧格式车辆 INI 的安装目录。
SukiVFV/Old_VehFuncsV/VehFuncsV.ini：旧格式使用的全局键位和 NeutralIsRainy 设置。
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini：VehFuncsV v1.44 旧格式官方配置示例。
README.zh-CN.md 与 README.en.md：0.9.0 的中英文安装、目录结构和兼容性说明。
CHANGELOG-0.9.0.md：0.9.0 中英文更新日志，包含统一新旧格式、动画速度兼容、灯光 ID 检测和其他更新内容。
Credits.txt：项目贡献者、测试人员和赞助者名单。
SHA256SUMS.txt：发布包内所有主要文件的 SHA256 校验值。
注意：0.9.0 不再提供独立的 OldSukiVFV.asi。新版与旧版配置均由同一个 SukiVFV.asi 加载。旧的游戏根目录 VehFuncsV 不再被扫描。
📚 使用前须知
在使用插件前，请务必阅读：
📖 md.📖 SukiVFVSampleCar.ini📖 Code Explanations.ini
整体配置编写思路与 VehFuncsV 相符。
💬 如果你有车辆可以测试相关功能，或者暂时不会编写功能，欢迎在评论区留言交流！
——更新日志:0.9.0——
兼容性改进：
- [Legacy + Enhanced] 将 OldSukiVFV 旧格式功能合并进单一 `SukiVFV.asi`。统一入口严格扫描 `SukiVFV/Suki_VehFuncsV` 与 `SukiVFV/Old_VehFuncsV`，共享根目录 `SukiVFV.ini`，并在同车型冲突时优先使用 `Old_VehFuncsV`；旧根目录 `VehFuncsV` 不再扫描。
- [Legacy + Enhanced] 统一日志写入 `SukiVFV.log`；运行时消息按 `SukiVehFuncsV` 或 `OldSukiVehFuncsV` 来源标注，启动、内存探测和共享设置等无法归属单一格式的消息标注两套来源。
- [Legacy only] 新增 GTA V Legacy `1.0.2628.2` 和 `1.0.3725.0` 支持。它们使用与 Legacy `1.0.3889.0` 相同的骨骼布局，并继续经过完整车辆预检、矩阵验证和失败停写保护。Enhanced `1.0.1158.13` 不属于本条新增版本支持，但继续使用既有 Enhanced 后端和保护机制。
- [Legacy + Enhanced] `oscillate` 的 `Speed` 现在按照 RealZolika1351 VehFuncsV 的速度表现进行换算。该行为按运动类型应用于所有旋转和位移通道，不只限于雨刷；实际每秒循环数为 `Speed x 7 / 15`。
- [Legacy + Enhanced] `rpm_move` 的 `Speed` 现在按照 VehFuncsV 的速度表现进行换算；实际每秒速度为 `Speed x 20 x 当前归一化 RPM`。若当前游戏版本无法安全识别 RPM 数据，则仅停用相关 RPM 动画。
- [Legacy + Enhanced] 新增车辆灯光 ID `3`、`4`、`9`～`17` 的动画条件：尾灯、刹车灯、倒车灯和额外灯光均可通过语义名称或 `light_ID` 写入 INI。每个 ID 可独立绑定动画通道，但游戏反馈仍按车辆状态组共享：左右尾灯共享主灯状态，三只刹车灯共享制动状态，左右倒车灯共享倒车状态，四个额外灯共享主灯状态。
- [Legacy + Enhanced] SukiVFV 与 OldSukiVFV 共享上述换算。旧 VehFuncsV INI 中的 `oscillate` 和 `rpm_move` 速度值可直接使用，不再需要为这两种运动逐车手工调整。
- [Legacy + Enhanced] `move`、`toggle` 以及输入映射运动继续保持原有单位和行为；本次更新没有把所有运动类型强制改为统一速度单位。
修复：
- [Legacy + Enhanced] 修复配置目录中存在被拒绝的 INI 时，插件每次检查都会误判配置发生变化并重复加载全部文件的问题。被拒绝的文件现在同样会记录时间戳，只有实际新增、删除或修改 INI 时才重载，避免雨刷、`rpm_move` 和其他有状态动画反复复位、迟疑或卡顿。
文档与测试：
- [Legacy + Enhanced] 更新代码说明和示例，明确 `oscillate`、`rpm_move`、`move` 与 `toggle` 的不同速度语义。
- [Legacy + Enhanced] 将示例中的 `rpm_move Speed=18` 校准为最大 RPM 时每秒 360 度。
- [Legacy + Enhanced] 新增基于旧 VehFuncsV 车辆配置数值的速度兼容回归测试，并同步修正负角度摆动测试的周期时间步长。
- [Legacy only] 新增 Legacy `1.0.2628.2`、`1.0.3725.0` 的版本分类、骨骼布局和受保护写入权限回归测试。
——更新日志:0.8.1——
见[CHANGELOG-0.9.0.md]下方
en:
A Few Words From the Developer
I’m very happy to bring VehFuncsV back to GTA V after three years.
Since VehFuncsV was never open-source, all code in this project has been written by me, with assistance from OpenAI’s ChatGPT 5.6sol. This is almost a complete rebuild from scratch—none of the original VehFuncsV was decompiled or reverse-engineered.
Because it was rebuilt from the ground up, SukiVFV may not fully support every old VehFuncsV configuration file. However, based on my testing, most older VehFuncsV .ini files should work after updating the keybind setting, customkey. I didn’t like VehFuncsV’s reversed key-input logic, so I changed it in SukiVFV.
From planning through development, no vehicle creators were willing to submit vehicles for testing. As a result, I cannot guarantee that all original VehFuncsV features will work correctly with every vehicle.
If you encounter a ScriptHookV error while testing your vehicle, it may mean that a feature is not supported yet. You can contact me and submit your vehicle’s dlc.rpf file along with its .ini configuration file. I will test it repeatedly to identify the vehicle’s bone nodes and the required offset values.
Also, thank you for trusting me. :)
Please remember that this script is now called SukiVFV. When releasing vehicles that use its features, you may add [SukiVFV] to the release post or description.
Thank you for respecting my work. I’m still unsure whether I should eventually move to paid updates. Maybe… I can keep working on this until the plugin is close to perfect.
Before using SukiVFV, please make sure to read md.， SukiVFVSampleCar.ini and Code Explanations.ini. The overall .ini configuration approach remains consistent with VehFuncsV.
Plugin Information
🧩 Plugin Name: SukiVFV
Supported Versions:
🎮 Legacy 1.0.3889.0
🎮 Enhanced 1.0.1158.13
Development Version: SukiVFV-0.7.0-Public-Beta
Requirements: ScriptHookV
————————————————————
✨ Features
✅ Automatically detects and supports legacy vehicle .ini files written for RealZolika1351’s VehFuncsV v1.44 format.
✅ Full support for both GTA V Enhanced and Legacy
🔥 Supports hot reloading: after editing a configuration file, simply switch focus back to the game to apply the changes immediately
🔧 Supports almost all legacy VehFuncsV configurations; only the keybind settings need to be changed
🚗 Lets you choose whether animations are restored after leaving a vehicle
Controlled by RestoreOnVehicleExit, allowing animation states to either remain as they are or reset when exiting the vehicle
⌨️ Supports multi-key combinations with more logical keybind behavior
🚘 Supports multiple vehicle configurations running at the same time
🎬 Tested Animations Including, but not limited to:
🌧️ Windshield wipers
⬆️ Suspension height adjustment
🪽 Spoiler deployment and retraction
🪞 Rear-view mirror animations
🪟 Window roll-up and roll-down animations
📈 RPM needle animation and gear-shift drop
⚠️ Bone Functions Not Yet Fully Tested
Due to the lack of suitable test vehicles, the following functions are not guaranteed to work properly yet:
move · gas · brake · steer · sequential_shifter
handbrake · rpm_move · door_link · popup_light
bone_link · turbo · engine_temp
engine_health · headlights
📦 Installation
Extract all files to your GTA V root directory.
📄 File Description
SukiVFV.asi: Unified entry point, version 0.9.0. It supports both the new SukiVFV format and legacy RealZolika1351 VehFuncsV v1.44 configurations.
SukiVFV.ini: Shared global settings for both configuration formats, including restoration behavior after leaving a vehicle.
SukiVFV/Suki_VehFuncsV/: Installation directory for new-format SukiVFV vehicle INIs. It includes code explanations and an official configuration example.
SukiVFV/Old_VehFuncsV/: Installation directory for legacy VehFuncsV v1.44 vehicle INIs.
SukiVFV/Old_VehFuncsV/VehFuncsV.ini: Global key bindings and the NeutralIsRainy setting used by legacy-format configurations.
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini: Official VehFuncsV v1.44 legacy-format configuration example.
README.zh-CN.md and README.en.md: Chinese and English installation, directory layout, and compatibility documentation for version 0.9.0.
CHANGELOG-0.9.0.md: Chinese and English changelog covering unified format support, animation-speed compatibility, light ID detection, and other changes in version 0.9.0.
Credits.txt: List of project contributors, testers, and sponsors.
SHA256SUMS.txt: SHA256 checksums for the main files included in the release.
Note: Version 0.9.0 no longer includes a separate OldSukiVFV.asi. Both new and legacy configurations are loaded by the unified SukiVFV.asi. The former root-level VehFuncsV directory is no longer scanned.
📚 Before You Use It
Before using the plugin, please make sure to read:
📖 README.md
📖 SukiVFVSampleCar.ini
📖 Code Explanations.ini
The overall configuration structure follows the same general approach as VehFuncsV.
💬 If you have a vehicle that can be used to test these features, or if you are not yet sure how to write a configuration, feel free to leave a comment and join the discussion!
——CHANGELOG-0.9.0——
Compatibility improvements:
- [Legacy + Enhanced] Merged OldSukiVFV legacy-format support into a single `SukiVFV.asi`. The unified entry point strictly scans `SukiVFV/Suki_VehFuncsV` and `SukiVFV/Old_VehFuncsV`, shares the root `SukiVFV.ini`, and gives `Old_VehFuncsV` priority for duplicate models; the former root `VehFuncsV` directory is no longer scanned.
- [Legacy + Enhanced] Unified logging writes to `SukiVFV.log` and labels runtime messages as `SukiVehFuncsV` or `OldSukiVehFuncsV`; startup, memory-probe, and shared-setting messages that belong to both formats carry both source labels.
- [Legacy only] Added GTA V Legacy `1.0.2628.2` and `1.0.3725.0` support. These builds use the same bone layout as Legacy `1.0.3889.0` while retaining complete vehicle preflight, matrix validation, and fail-closed write protection. Enhanced `1.0.1158.13` is not a new target in this item; it continues to use the existing Enhanced backend and protection.
- [Legacy + Enhanced] `oscillate` `Speed` values now follow RealZolika1351 VehFuncsV timing. The conversion applies by motion type to every rotation and translation channel, not only to wipers; effective cycles per second are `Speed x 7 / 15`.
- [Legacy + Enhanced] `rpm_move` `Speed` values now follow VehFuncsV timing; effective speed per second is `Speed x 20 x current normalized RPM`. If RPM data cannot be identified safely for the current build, only the affected RPM animation is disabled.
- [Legacy + Enhanced] Added animation conditions for vehicle light IDs `3`, `4`, and `9`-`17`: tail lights, brake lights, reversing lights, and extra lights can be addressed by semantic names or `light_ID` in an INI. Each ID can be bound to its own animation channel, while game feedback remains grouped by vehicle state: both tail lights share the main-light state, the three brake lights share braking, the two reversing lights share reversing, and the four extra lights share the main-light state.
- [Legacy + Enhanced] SukiVFV and OldSukiVFV share these conversions. Existing VehFuncsV INIs can use their original `oscillate` and `rpm_move` speed values without per-vehicle edits for these two motion types.
- [Legacy + Enhanced] `move`, `toggle`, and input-mapped motions retain their existing units and behavior. This update does not force every motion type into one common speed unit.
Fixes:
- [Legacy + Enhanced] Fixed repeated full configuration reloads when the configuration directory contained a rejected INI. Rejected files now retain observed timestamps, so reloads occur only when an INI is actually added, removed, or modified. This prevents wipers, `rpm_move`, and other stateful animations from repeatedly resetting, hesitating, or stuttering.
Documentation and tests:
- [Legacy + Enhanced] Updated the code explanations and sample configuration to distinguish the speed semantics of `oscillate`, `rpm_move`, `move`, and `toggle`.
- [Legacy + Enhanced] Calibrated the sample `rpm_move Speed=18` to produce 360 degrees per second at maximum RPM.
- [Legacy + Enhanced] Added speed-compatibility regression coverage based on legacy VehFuncsV vehicle values and corrected the cycle time step in the negative-angle oscillation test.
- [Legacy only] Added regression coverage for Legacy `1.0.2628.2` and `1.0.3725.0` classification, bone layout, and guarded-write permission.
——CHANGELOG-0.8.1——
See below CHANGELOG-0.9.0.md
Первая загрузка: 3 августа 2026
Последнее обновление: 18 августа 2026
Последнее скачивание: час назад
54 комментария
zh:
我想说的话: 很高兴,能在三年后让 VehFuncsV能够重新回到GTAV中,由于 VehFuncsV没有开源,所有代码均由我编写,通过OpenAI的ChatGPT5.6sol辅助完成.所以几乎是重头开发，没有任何反编译与逆向原VehFuncsV。但也正是因为重头开发，所以SukiVFV可能并不能完全支持那些曾经的VehFuncsV配置文件。但是经过我的测试,大部分的VehFuncsV旧文件,你只需要更改键位也就是customkey即可。我不喜欢VehFuncsV那反向按键思路，所以我更改了。
由于从立项到开发，没有任何作者能够愿意将车辆提交给我测试，所以我无法保证原VehFuncsV大部分的功能都是否能运行，如果你在测试自己车辆时发现ScripthookV报错,那可能是不支持，你可以通过联系我，提交你的车辆dlc.rpf与ini配置文件，这样我会自己反复测试用于抓取车辆的骨骼节点与目标偏移值。（另外，谢谢你信任我:）
记住 这个VehFuncsV脚本现在叫SukiVFV,在你们制作带有该功能时的车辆发布时,可以添加[SukiVFV] ！
谢谢你尊重我的开发成果，我不知道我是否该采取付费更新，或许。。。我能坚持到这个插件接近完美的时刻？
在使用前请务必阅读md.，SukiVFVSampleCar.ini ，Code Explanations.ini,整体编写ini思路与VehFuncsV相符
————————
🧩 插件名称：SukiVFV
支持版本：🎮 Legacy 1.0.3889.0🎮 Enhanced 1.0.1158.13
开发版本： SukiVFV-0.7.0-Public-Beta
环境需求： ScriptHookV
————————————————————
✨ 插件特点
✅ 自动检测并支持RealZolika1351 VehFuncsV v1.44 格式编写的旧车辆 INI
✅ 完全支持增强版与传承版
🔥 支持热调试：修改配置后，将焦点重新切回游戏即可立即应用调整
🔧 几乎支持所有旧版本 VehFuncsV 编码，仅需修改键位即可使用
🚗 支持离开载具后自行设置是否恢复动画 由 RestoreOnVehicleExit 控制，可选择离车保持或恢复动画
⌨️ 支持多键组合绑定，键位设置更加符合逻辑
🚘 支持多车辆配置同时运行
🎬 已实测动画 包括但不限于：
🌧️ 雨刷动画
⬆️ 底盘升降
🪽 尾翼展开与收回
🪞 后视镜动画
🪟 玻璃升降
📈 RPM 指针动画与换挡回落
⚠️ 暂未充分测试的骨骼
由于暂无合适车辆进行测试，以下功能暂不保证可以正常运行：
move · gas · brake · steer · sequential_shifterhandbrake · rpm_move · door_link · popup_lightbone_link · turbo · engine_tempengine_health · headlights
📦 安装教程
将全部文件放入游戏根目录即可。
📄 文件说明
SukiVFV.asi：统一入口，版本 0.9.0，同时支持新版 SukiVFV 格式和 RealZolika1351 VehFuncsV v1.44 旧格式。
SukiVFV.ini：新旧两种格式共同使用的全局设置文件，包括离车后恢复部件状态等设置。
SukiVFV/Suki_VehFuncsV/：新版 SukiVFV 车辆 INI 的安装目录，内含代码说明与官方配置示例。
SukiVFV/Old_VehFuncsV/：VehFuncsV v1.44 旧格式车辆 INI 的安装目录。
SukiVFV/Old_VehFuncsV/VehFuncsV.ini：旧格式使用的全局键位和 NeutralIsRainy 设置。
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini：VehFuncsV v1.44 旧格式官方配置示例。
README.zh-CN.md 与 README.en.md：0.9.0 的中英文安装、目录结构和兼容性说明。
CHANGELOG-0.9.0.md：0.9.0 中英文更新日志，包含统一新旧格式、动画速度兼容、灯光 ID 检测和其他更新内容。
Credits.txt：项目贡献者、测试人员和赞助者名单。
SHA256SUMS.txt：发布包内所有主要文件的 SHA256 校验值。
注意：0.9.0 不再提供独立的 OldSukiVFV.asi。新版与旧版配置均由同一个 SukiVFV.asi 加载。旧的游戏根目录 VehFuncsV 不再被扫描。
📚 使用前须知
在使用插件前，请务必阅读：
📖 md.📖 SukiVFVSampleCar.ini📖 Code Explanations.ini
整体配置编写思路与 VehFuncsV 相符。
💬 如果你有车辆可以测试相关功能，或者暂时不会编写功能，欢迎在评论区留言交流！
——更新日志:0.9.0——
兼容性改进：
- [Legacy + Enhanced] 将 OldSukiVFV 旧格式功能合并进单一 `SukiVFV.asi`。统一入口严格扫描 `SukiVFV/Suki_VehFuncsV` 与 `SukiVFV/Old_VehFuncsV`，共享根目录 `SukiVFV.ini`，并在同车型冲突时优先使用 `Old_VehFuncsV`；旧根目录 `VehFuncsV` 不再扫描。
- [Legacy + Enhanced] 统一日志写入 `SukiVFV.log`；运行时消息按 `SukiVehFuncsV` 或 `OldSukiVehFuncsV` 来源标注，启动、内存探测和共享设置等无法归属单一格式的消息标注两套来源。
- [Legacy only] 新增 GTA V Legacy `1.0.2628.2` 和 `1.0.3725.0` 支持。它们使用与 Legacy `1.0.3889.0` 相同的骨骼布局，并继续经过完整车辆预检、矩阵验证和失败停写保护。Enhanced `1.0.1158.13` 不属于本条新增版本支持，但继续使用既有 Enhanced 后端和保护机制。
- [Legacy + Enhanced] `oscillate` 的 `Speed` 现在按照 RealZolika1351 VehFuncsV 的速度表现进行换算。该行为按运动类型应用于所有旋转和位移通道，不只限于雨刷；实际每秒循环数为 `Speed x 7 / 15`。
- [Legacy + Enhanced] `rpm_move` 的 `Speed` 现在按照 VehFuncsV 的速度表现进行换算；实际每秒速度为 `Speed x 20 x 当前归一化 RPM`。若当前游戏版本无法安全识别 RPM 数据，则仅停用相关 RPM 动画。
- [Legacy + Enhanced] 新增车辆灯光 ID `3`、`4`、`9`～`17` 的动画条件：尾灯、刹车灯、倒车灯和额外灯光均可通过语义名称或 `light_ID` 写入 INI。每个 ID 可独立绑定动画通道，但游戏反馈仍按车辆状态组共享：左右尾灯共享主灯状态，三只刹车灯共享制动状态，左右倒车灯共享倒车状态，四个额外灯共享主灯状态。
- [Legacy + Enhanced] SukiVFV 与 OldSukiVFV 共享上述换算。旧 VehFuncsV INI 中的 `oscillate` 和 `rpm_move` 速度值可直接使用，不再需要为这两种运动逐车手工调整。
- [Legacy + Enhanced] `move`、`toggle` 以及输入映射运动继续保持原有单位和行为；本次更新没有把所有运动类型强制改为统一速度单位。
修复：
- [Legacy + Enhanced] 修复配置目录中存在被拒绝的 INI 时，插件每次检查都会误判配置发生变化并重复加载全部文件的问题。被拒绝的文件现在同样会记录时间戳，只有实际新增、删除或修改 INI 时才重载，避免雨刷、`rpm_move` 和其他有状态动画反复复位、迟疑或卡顿。
文档与测试：
- [Legacy + Enhanced] 更新代码说明和示例，明确 `oscillate`、`rpm_move`、`move` 与 `toggle` 的不同速度语义。
- [Legacy + Enhanced] 将示例中的 `rpm_move Speed=18` 校准为最大 RPM 时每秒 360 度。
- [Legacy + Enhanced] 新增基于旧 VehFuncsV 车辆配置数值的速度兼容回归测试，并同步修正负角度摆动测试的周期时间步长。
- [Legacy only] 新增 Legacy `1.0.2628.2`、`1.0.3725.0` 的版本分类、骨骼布局和受保护写入权限回归测试。
——更新日志:0.8.1——
见[CHANGELOG-0.9.0.md]下方
en:
A Few Words From the Developer
I’m very happy to bring VehFuncsV back to GTA V after three years.
Since VehFuncsV was never open-source, all code in this project has been written by me, with assistance from OpenAI’s ChatGPT 5.6sol. This is almost a complete rebuild from scratch—none of the original VehFuncsV was decompiled or reverse-engineered.
Because it was rebuilt from the ground up, SukiVFV may not fully support every old VehFuncsV configuration file. However, based on my testing, most older VehFuncsV .ini files should work after updating the keybind setting, customkey. I didn’t like VehFuncsV’s reversed key-input logic, so I changed it in SukiVFV.
From planning through development, no vehicle creators were willing to submit vehicles for testing. As a result, I cannot guarantee that all original VehFuncsV features will work correctly with every vehicle.
If you encounter a ScriptHookV error while testing your vehicle, it may mean that a feature is not supported yet. You can contact me and submit your vehicle’s dlc.rpf file along with its .ini configuration file. I will test it repeatedly to identify the vehicle’s bone nodes and the required offset values.
Also, thank you for trusting me. :)
Please remember that this script is now called SukiVFV. When releasing vehicles that use its features, you may add [SukiVFV] to the release post or description.
Thank you for respecting my work. I’m still unsure whether I should eventually move to paid updates. Maybe… I can keep working on this until the plugin is close to perfect.
Before using SukiVFV, please make sure to read md.， SukiVFVSampleCar.ini and Code Explanations.ini. The overall .ini configuration approach remains consistent with VehFuncsV.
Plugin Information
🧩 Plugin Name: SukiVFV
Supported Versions:
🎮 Legacy 1.0.3889.0
🎮 Enhanced 1.0.1158.13
Development Version: SukiVFV-0.7.0-Public-Beta
Requirements: ScriptHookV
————————————————————
✨ Features
✅ Automatically detects and supports legacy vehicle .ini files written for RealZolika1351’s VehFuncsV v1.44 format.
✅ Full support for both GTA V Enhanced and Legacy
🔥 Supports hot reloading: after editing a configuration file, simply switch focus back to the game to apply the changes immediately
🔧 Supports almost all legacy VehFuncsV configurations; only the keybind settings need to be changed
🚗 Lets you choose whether animations are restored after leaving a vehicle
Controlled by RestoreOnVehicleExit, allowing animation states to either remain as they are or reset when exiting the vehicle
⌨️ Supports multi-key combinations with more logical keybind behavior
🚘 Supports multiple vehicle configurations running at the same time
🎬 Tested Animations Including, but not limited to:
🌧️ Windshield wipers
⬆️ Suspension height adjustment
🪽 Spoiler deployment and retraction
🪞 Rear-view mirror animations
🪟 Window roll-up and roll-down animations
📈 RPM needle animation and gear-shift drop
⚠️ Bone Functions Not Yet Fully Tested
Due to the lack of suitable test vehicles, the following functions are not guaranteed to work properly yet:
move · gas · brake · steer · sequential_shifter
handbrake · rpm_move · door_link · popup_light
bone_link · turbo · engine_temp
engine_health · headlights
📦 Installation
Extract all files to your GTA V root directory.
📄 File Description
SukiVFV.asi: Unified entry point, version 0.9.0. It supports both the new SukiVFV format and legacy RealZolika1351 VehFuncsV v1.44 configurations.
SukiVFV.ini: Shared global settings for both configuration formats, including restoration behavior after leaving a vehicle.
SukiVFV/Suki_VehFuncsV/: Installation directory for new-format SukiVFV vehicle INIs. It includes code explanations and an official configuration example.
SukiVFV/Old_VehFuncsV/: Installation directory for legacy VehFuncsV v1.44 vehicle INIs.
SukiVFV/Old_VehFuncsV/VehFuncsV.ini: Global key bindings and the NeutralIsRainy setting used by legacy-format configurations.
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini: Official VehFuncsV v1.44 legacy-format configuration example.
README.zh-CN.md and README.en.md: Chinese and English installation, directory layout, and compatibility documentation for version 0.9.0.
CHANGELOG-0.9.0.md: Chinese and English changelog covering unified format support, animation-speed compatibility, light ID detection, and other changes in version 0.9.0.
Credits.txt: List of project contributors, testers, and sponsors.
SHA256SUMS.txt: SHA256 checksums for the main files included in the release.
Note: Version 0.9.0 no longer includes a separate OldSukiVFV.asi. Both new and legacy configurations are loaded by the unified SukiVFV.asi. The former root-level VehFuncsV directory is no longer scanned.
📚 Before You Use It
Before using the plugin, please make sure to read:
📖 README.md
📖 SukiVFVSampleCar.ini
📖 Code Explanations.ini
The overall configuration structure follows the same general approach as VehFuncsV.
💬 If you have a vehicle that can be used to test these features, or if you are not yet sure how to write a configuration, feel free to leave a comment and join the discussion!
——CHANGELOG-0.9.0——
Compatibility improvements:
- [Legacy + Enhanced] Merged OldSukiVFV legacy-format support into a single `SukiVFV.asi`. The unified entry point strictly scans `SukiVFV/Suki_VehFuncsV` and `SukiVFV/Old_VehFuncsV`, shares the root `SukiVFV.ini`, and gives `Old_VehFuncsV` priority for duplicate models; the former root `VehFuncsV` directory is no longer scanned.
- [Legacy + Enhanced] Unified logging writes to `SukiVFV.log` and labels runtime messages as `SukiVehFuncsV` or `OldSukiVehFuncsV`; startup, memory-probe, and shared-setting messages that belong to both formats carry both source labels.
- [Legacy only] Added GTA V Legacy `1.0.2628.2` and `1.0.3725.0` support. These builds use the same bone layout as Legacy `1.0.3889.0` while retaining complete vehicle preflight, matrix validation, and fail-closed write protection. Enhanced `1.0.1158.13` is not a new target in this item; it continues to use the existing Enhanced backend and protection.
- [Legacy + Enhanced] `oscillate` `Speed` values now follow RealZolika1351 VehFuncsV timing. The conversion applies by motion type to every rotation and translation channel, not only to wipers; effective cycles per second are `Speed x 7 / 15`.
- [Legacy + Enhanced] `rpm_move` `Speed` values now follow VehFuncsV timing; effective speed per second is `Speed x 20 x current normalized RPM`. If RPM data cannot be identified safely for the current build, only the affected RPM animation is disabled.
- [Legacy + Enhanced] Added animation conditions for vehicle light IDs `3`, `4`, and `9`-`17`: tail lights, brake lights, reversing lights, and extra lights can be addressed by semantic names or `light_ID` in an INI. Each ID can be bound to its own animation channel, while game feedback remains grouped by vehicle state: both tail lights share the main-light state, the three brake lights share braking, the two reversing lights share reversing, and the four extra lights share the main-light state.
- [Legacy + Enhanced] SukiVFV and OldSukiVFV share these conversions. Existing VehFuncsV INIs can use their original `oscillate` and `rpm_move` speed values without per-vehicle edits for these two motion types.
- [Legacy + Enhanced] `move`, `toggle`, and input-mapped motions retain their existing units and behavior. This update does not force every motion type into one common speed unit.
Fixes:
- [Legacy + Enhanced] Fixed repeated full configuration reloads when the configuration directory contained a rejected INI. Rejected files now retain observed timestamps, so reloads occur only when an INI is actually added, removed, or modified. This prevents wipers, `rpm_move`, and other stateful animations from repeatedly resetting, hesitating, or stuttering.
Documentation and tests:
- [Legacy + Enhanced] Updated the code explanations and sample configuration to distinguish the speed semantics of `oscillate`, `rpm_move`, `move`, and `toggle`.
- [Legacy + Enhanced] Calibrated the sample `rpm_move Speed=18` to produce 360 degrees per second at maximum RPM.
- [Legacy + Enhanced] Added speed-compatibility regression coverage based on legacy VehFuncsV vehicle values and corrected the cycle time step in the negative-angle oscillation test.
- [Legacy only] Added regression coverage for Legacy `1.0.2628.2` and `1.0.3725.0` classification, bone layout, and guarded-write permission.
——CHANGELOG-0.8.1——
See below CHANGELOG-0.9.0.md
我想说的话: 很高兴,能在三年后让 VehFuncsV能够重新回到GTAV中,由于 VehFuncsV没有开源,所有代码均由我编写,通过OpenAI的ChatGPT5.6sol辅助完成.所以几乎是重头开发，没有任何反编译与逆向原VehFuncsV。但也正是因为重头开发，所以SukiVFV可能并不能完全支持那些曾经的VehFuncsV配置文件。但是经过我的测试,大部分的VehFuncsV旧文件,你只需要更改键位也就是customkey即可。我不喜欢VehFuncsV那反向按键思路，所以我更改了。
由于从立项到开发，没有任何作者能够愿意将车辆提交给我测试，所以我无法保证原VehFuncsV大部分的功能都是否能运行，如果你在测试自己车辆时发现ScripthookV报错,那可能是不支持，你可以通过联系我，提交你的车辆dlc.rpf与ini配置文件，这样我会自己反复测试用于抓取车辆的骨骼节点与目标偏移值。（另外，谢谢你信任我:）
记住 这个VehFuncsV脚本现在叫SukiVFV,在你们制作带有该功能时的车辆发布时,可以添加[SukiVFV] ！
谢谢你尊重我的开发成果，我不知道我是否该采取付费更新，或许。。。我能坚持到这个插件接近完美的时刻？
在使用前请务必阅读md.，SukiVFVSampleCar.ini ，Code Explanations.ini,整体编写ini思路与VehFuncsV相符
————————
🧩 插件名称：SukiVFV
支持版本：🎮 Legacy 1.0.3889.0🎮 Enhanced 1.0.1158.13
开发版本： SukiVFV-0.7.0-Public-Beta
环境需求： ScriptHookV
————————————————————
✨ 插件特点
✅ 自动检测并支持RealZolika1351 VehFuncsV v1.44 格式编写的旧车辆 INI
✅ 完全支持增强版与传承版
🔥 支持热调试：修改配置后，将焦点重新切回游戏即可立即应用调整
🔧 几乎支持所有旧版本 VehFuncsV 编码，仅需修改键位即可使用
🚗 支持离开载具后自行设置是否恢复动画 由 RestoreOnVehicleExit 控制，可选择离车保持或恢复动画
⌨️ 支持多键组合绑定，键位设置更加符合逻辑
🚘 支持多车辆配置同时运行
🎬 已实测动画 包括但不限于：
🌧️ 雨刷动画
⬆️ 底盘升降
🪽 尾翼展开与收回
🪞 后视镜动画
🪟 玻璃升降
📈 RPM 指针动画与换挡回落
⚠️ 暂未充分测试的骨骼
由于暂无合适车辆进行测试，以下功能暂不保证可以正常运行：
move · gas · brake · steer · sequential_shifterhandbrake · rpm_move · door_link · popup_lightbone_link · turbo · engine_tempengine_health · headlights
📦 安装教程
将全部文件放入游戏根目录即可。
📄 文件说明
SukiVFV.asi：统一入口，版本 0.9.0，同时支持新版 SukiVFV 格式和 RealZolika1351 VehFuncsV v1.44 旧格式。
SukiVFV.ini：新旧两种格式共同使用的全局设置文件，包括离车后恢复部件状态等设置。
SukiVFV/Suki_VehFuncsV/：新版 SukiVFV 车辆 INI 的安装目录，内含代码说明与官方配置示例。
SukiVFV/Old_VehFuncsV/：VehFuncsV v1.44 旧格式车辆 INI 的安装目录。
SukiVFV/Old_VehFuncsV/VehFuncsV.ini：旧格式使用的全局键位和 NeutralIsRainy 设置。
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini：VehFuncsV v1.44 旧格式官方配置示例。
README.zh-CN.md 与 README.en.md：0.9.0 的中英文安装、目录结构和兼容性说明。
CHANGELOG-0.9.0.md：0.9.0 中英文更新日志，包含统一新旧格式、动画速度兼容、灯光 ID 检测和其他更新内容。
Credits.txt：项目贡献者、测试人员和赞助者名单。
SHA256SUMS.txt：发布包内所有主要文件的 SHA256 校验值。
注意：0.9.0 不再提供独立的 OldSukiVFV.asi。新版与旧版配置均由同一个 SukiVFV.asi 加载。旧的游戏根目录 VehFuncsV 不再被扫描。
📚 使用前须知
在使用插件前，请务必阅读：
📖 md.📖 SukiVFVSampleCar.ini📖 Code Explanations.ini
整体配置编写思路与 VehFuncsV 相符。
💬 如果你有车辆可以测试相关功能，或者暂时不会编写功能，欢迎在评论区留言交流！
——更新日志:0.9.0——
兼容性改进：
- [Legacy + Enhanced] 将 OldSukiVFV 旧格式功能合并进单一 `SukiVFV.asi`。统一入口严格扫描 `SukiVFV/Suki_VehFuncsV` 与 `SukiVFV/Old_VehFuncsV`，共享根目录 `SukiVFV.ini`，并在同车型冲突时优先使用 `Old_VehFuncsV`；旧根目录 `VehFuncsV` 不再扫描。
- [Legacy + Enhanced] 统一日志写入 `SukiVFV.log`；运行时消息按 `SukiVehFuncsV` 或 `OldSukiVehFuncsV` 来源标注，启动、内存探测和共享设置等无法归属单一格式的消息标注两套来源。
- [Legacy only] 新增 GTA V Legacy `1.0.2628.2` 和 `1.0.3725.0` 支持。它们使用与 Legacy `1.0.3889.0` 相同的骨骼布局，并继续经过完整车辆预检、矩阵验证和失败停写保护。Enhanced `1.0.1158.13` 不属于本条新增版本支持，但继续使用既有 Enhanced 后端和保护机制。
- [Legacy + Enhanced] `oscillate` 的 `Speed` 现在按照 RealZolika1351 VehFuncsV 的速度表现进行换算。该行为按运动类型应用于所有旋转和位移通道，不只限于雨刷；实际每秒循环数为 `Speed x 7 / 15`。
- [Legacy + Enhanced] `rpm_move` 的 `Speed` 现在按照 VehFuncsV 的速度表现进行换算；实际每秒速度为 `Speed x 20 x 当前归一化 RPM`。若当前游戏版本无法安全识别 RPM 数据，则仅停用相关 RPM 动画。
- [Legacy + Enhanced] 新增车辆灯光 ID `3`、`4`、`9`～`17` 的动画条件：尾灯、刹车灯、倒车灯和额外灯光均可通过语义名称或 `light_ID` 写入 INI。每个 ID 可独立绑定动画通道，但游戏反馈仍按车辆状态组共享：左右尾灯共享主灯状态，三只刹车灯共享制动状态，左右倒车灯共享倒车状态，四个额外灯共享主灯状态。
- [Legacy + Enhanced] SukiVFV 与 OldSukiVFV 共享上述换算。旧 VehFuncsV INI 中的 `oscillate` 和 `rpm_move` 速度值可直接使用，不再需要为这两种运动逐车手工调整。
- [Legacy + Enhanced] `move`、`toggle` 以及输入映射运动继续保持原有单位和行为；本次更新没有把所有运动类型强制改为统一速度单位。
修复：
- [Legacy + Enhanced] 修复配置目录中存在被拒绝的 INI 时，插件每次检查都会误判配置发生变化并重复加载全部文件的问题。被拒绝的文件现在同样会记录时间戳，只有实际新增、删除或修改 INI 时才重载，避免雨刷、`rpm_move` 和其他有状态动画反复复位、迟疑或卡顿。
文档与测试：
- [Legacy + Enhanced] 更新代码说明和示例，明确 `oscillate`、`rpm_move`、`move` 与 `toggle` 的不同速度语义。
- [Legacy + Enhanced] 将示例中的 `rpm_move Speed=18` 校准为最大 RPM 时每秒 360 度。
- [Legacy + Enhanced] 新增基于旧 VehFuncsV 车辆配置数值的速度兼容回归测试，并同步修正负角度摆动测试的周期时间步长。
- [Legacy only] 新增 Legacy `1.0.2628.2`、`1.0.3725.0` 的版本分类、骨骼布局和受保护写入权限回归测试。
——更新日志:0.8.1——
见[CHANGELOG-0.9.0.md]下方
en:
A Few Words From the Developer
I’m very happy to bring VehFuncsV back to GTA V after three years.
Since VehFuncsV was never open-source, all code in this project has been written by me, with assistance from OpenAI’s ChatGPT 5.6sol. This is almost a complete rebuild from scratch—none of the original VehFuncsV was decompiled or reverse-engineered.
Because it was rebuilt from the ground up, SukiVFV may not fully support every old VehFuncsV configuration file. However, based on my testing, most older VehFuncsV .ini files should work after updating the keybind setting, customkey. I didn’t like VehFuncsV’s reversed key-input logic, so I changed it in SukiVFV.
From planning through development, no vehicle creators were willing to submit vehicles for testing. As a result, I cannot guarantee that all original VehFuncsV features will work correctly with every vehicle.
If you encounter a ScriptHookV error while testing your vehicle, it may mean that a feature is not supported yet. You can contact me and submit your vehicle’s dlc.rpf file along with its .ini configuration file. I will test it repeatedly to identify the vehicle’s bone nodes and the required offset values.
Also, thank you for trusting me. :)
Please remember that this script is now called SukiVFV. When releasing vehicles that use its features, you may add [SukiVFV] to the release post or description.
Thank you for respecting my work. I’m still unsure whether I should eventually move to paid updates. Maybe… I can keep working on this until the plugin is close to perfect.
Before using SukiVFV, please make sure to read md.， SukiVFVSampleCar.ini and Code Explanations.ini. The overall .ini configuration approach remains consistent with VehFuncsV.
Plugin Information
🧩 Plugin Name: SukiVFV
Supported Versions:
🎮 Legacy 1.0.3889.0
🎮 Enhanced 1.0.1158.13
Development Version: SukiVFV-0.7.0-Public-Beta
Requirements: ScriptHookV
————————————————————
✨ Features
✅ Automatically detects and supports legacy vehicle .ini files written for RealZolika1351’s VehFuncsV v1.44 format.
✅ Full support for both GTA V Enhanced and Legacy
🔥 Supports hot reloading: after editing a configuration file, simply switch focus back to the game to apply the changes immediately
🔧 Supports almost all legacy VehFuncsV configurations; only the keybind settings need to be changed
🚗 Lets you choose whether animations are restored after leaving a vehicle
Controlled by RestoreOnVehicleExit, allowing animation states to either remain as they are or reset when exiting the vehicle
⌨️ Supports multi-key combinations with more logical keybind behavior
🚘 Supports multiple vehicle configurations running at the same time
🎬 Tested Animations Including, but not limited to:
🌧️ Windshield wipers
⬆️ Suspension height adjustment
🪽 Spoiler deployment and retraction
🪞 Rear-view mirror animations
🪟 Window roll-up and roll-down animations
📈 RPM needle animation and gear-shift drop
⚠️ Bone Functions Not Yet Fully Tested
Due to the lack of suitable test vehicles, the following functions are not guaranteed to work properly yet:
move · gas · brake · steer · sequential_shifter
handbrake · rpm_move · door_link · popup_light
bone_link · turbo · engine_temp
engine_health · headlights
📦 Installation
Extract all files to your GTA V root directory.
📄 File Description
SukiVFV.asi: Unified entry point, version 0.9.0. It supports both the new SukiVFV format and legacy RealZolika1351 VehFuncsV v1.44 configurations.
SukiVFV.ini: Shared global settings for both configuration formats, including restoration behavior after leaving a vehicle.
SukiVFV/Suki_VehFuncsV/: Installation directory for new-format SukiVFV vehicle INIs. It includes code explanations and an official configuration example.
SukiVFV/Old_VehFuncsV/: Installation directory for legacy VehFuncsV v1.44 vehicle INIs.
SukiVFV/Old_VehFuncsV/VehFuncsV.ini: Global key bindings and the NeutralIsRainy setting used by legacy-format configurations.
SukiVFV/Old_VehFuncsV/VehFuncsVSampleCar.ini: Official VehFuncsV v1.44 legacy-format configuration example.
README.zh-CN.md and README.en.md: Chinese and English installation, directory layout, and compatibility documentation for version 0.9.0.
CHANGELOG-0.9.0.md: Chinese and English changelog covering unified format support, animation-speed compatibility, light ID detection, and other changes in version 0.9.0.
Credits.txt: List of project contributors, testers, and sponsors.
SHA256SUMS.txt: SHA256 checksums for the main files included in the release.
Note: Version 0.9.0 no longer includes a separate OldSukiVFV.asi. Both new and legacy configurations are loaded by the unified SukiVFV.asi. The former root-level VehFuncsV directory is no longer scanned.
📚 Before You Use It
Before using the plugin, please make sure to read:
📖 README.md
📖 SukiVFVSampleCar.ini
📖 Code Explanations.ini
The overall configuration structure follows the same general approach as VehFuncsV.
💬 If you have a vehicle that can be used to test these features, or if you are not yet sure how to write a configuration, feel free to leave a comment and join the discussion!
——CHANGELOG-0.9.0——
Compatibility improvements:
- [Legacy + Enhanced] Merged OldSukiVFV legacy-format support into a single `SukiVFV.asi`. The unified entry point strictly scans `SukiVFV/Suki_VehFuncsV` and `SukiVFV/Old_VehFuncsV`, shares the root `SukiVFV.ini`, and gives `Old_VehFuncsV` priority for duplicate models; the former root `VehFuncsV` directory is no longer scanned.
- [Legacy + Enhanced] Unified logging writes to `SukiVFV.log` and labels runtime messages as `SukiVehFuncsV` or `OldSukiVehFuncsV`; startup, memory-probe, and shared-setting messages that belong to both formats carry both source labels.
- [Legacy only] Added GTA V Legacy `1.0.2628.2` and `1.0.3725.0` support. These builds use the same bone layout as Legacy `1.0.3889.0` while retaining complete vehicle preflight, matrix validation, and fail-closed write protection. Enhanced `1.0.1158.13` is not a new target in this item; it continues to use the existing Enhanced backend and protection.
- [Legacy + Enhanced] `oscillate` `Speed` values now follow RealZolika1351 VehFuncsV timing. The conversion applies by motion type to every rotation and translation channel, not only to wipers; effective cycles per second are `Speed x 7 / 15`.
- [Legacy + Enhanced] `rpm_move` `Speed` values now follow VehFuncsV timing; effective speed per second is `Speed x 20 x current normalized RPM`. If RPM data cannot be identified safely for the current build, only the affected RPM animation is disabled.
- [Legacy + Enhanced] Added animation conditions for vehicle light IDs `3`, `4`, and `9`-`17`: tail lights, brake lights, reversing lights, and extra lights can be addressed by semantic names or `light_ID` in an INI. Each ID can be bound to its own animation channel, while game feedback remains grouped by vehicle state: both tail lights share the main-light state, the three brake lights share braking, the two reversing lights share reversing, and the four extra lights share the main-light state.
- [Legacy + Enhanced] SukiVFV and OldSukiVFV share these conversions. Existing VehFuncsV INIs can use their original `oscillate` and `rpm_move` speed values without per-vehicle edits for these two motion types.
- [Legacy + Enhanced] `move`, `toggle`, and input-mapped motions retain their existing units and behavior. This update does not force every motion type into one common speed unit.
Fixes:
- [Legacy + Enhanced] Fixed repeated full configuration reloads when the configuration directory contained a rejected INI. Rejected files now retain observed timestamps, so reloads occur only when an INI is actually added, removed, or modified. This prevents wipers, `rpm_move`, and other stateful animations from repeatedly resetting, hesitating, or stuttering.
Documentation and tests:
- [Legacy + Enhanced] Updated the code explanations and sample configuration to distinguish the speed semantics of `oscillate`, `rpm_move`, `move`, and `toggle`.
- [Legacy + Enhanced] Calibrated the sample `rpm_move Speed=18` to produce 360 degrees per second at maximum RPM.
- [Legacy + Enhanced] Added speed-compatibility regression coverage based on legacy VehFuncsV vehicle values and corrected the cycle time step in the negative-angle oscillation test.
- [Legacy only] Added regression coverage for Legacy `1.0.2628.2` and `1.0.3725.0` classification, bone layout, and guarded-write permission.
——CHANGELOG-0.8.1——
See below CHANGELOG-0.9.0.md
Первая загрузка: 3 августа 2026
Последнее обновление: 18 августа 2026
Последнее скачивание: час назад
5mods on Discord
@SukiHateProm1se 👍
@SukiHateProm1se helloo
[2026-08-21 00:34:52] [OldSukiVehFuncsV] Vehicle matched: rev (handle 189955, model 0x4053821C)
[2026-08-21 00:34:52] [OldSukiVehFuncsV] bone [1] wing_l -> index 91
[2026-08-21 00:34:52] [OldSukiVehFuncsV] bone [2] wing_r -> index 90
[2026-08-21 00:34:52] [OldSukiVehFuncsV] bone [3] wing_rr -> index 54
[2026-08-21 00:34:52] [OldSukiVehFuncsV] configured bone probes do not share one matrix array
[2026-08-21 00:34:52] [OldSukiVehFuncsV] motion pipeline: 3 active channels, 0/3 active bones probe-ready; 0 missing bones and 0 channels skipped; guarded writes disabled
[2026-08-21 00:34:52] [OldSukiVehFuncsV] engine running: false
[2026-08-21 00:34:52] [OldSukiVehFuncsV] raining: true
[2026-08-21 00:34:53] [OldSukiVehFuncsV] engine running: true
the wipers not working, can u help me?
Hi there. I’m having trouble getting the spoiler from your mod to work on my car—it won't open, and I don't know what the problem is. I can send you my model file to see if it can be fixed somehow; I’m not sure why it isn't working. I transferred it directly from the old VehFuncs setup where it worked fine, but here it doesn't.
Of course, that’s if you’re able to help—if not, well, nothing we can do. I'm using Enhanced 1.1.1013.29.
Subject: SukiVFV / Gen 9 Memory Layout issue on game build 1.0.1013.29 (Guarded writes disabled / Index 52 override)Hi! First of all, thank you for developing SukiVFV. It's an amazing tool for vehicle modders.I am currently developing a high-quality vehicle mod (Audi RS7) with custom animations for the Enhanced Edition (Gen 9 PC build), running on game executable version 1.0.1013.29 (internal build 3411).I have perfectly set up my 3D model hierarchy in ZModeler3 (chassis -> boot -> spoiler with official ID = 0 / standard bone properties), but I am hitting a hard block with memory protection on this specific game build.Here are the technical details from my SukiVFV.log:Memory Layout Protection: The plugin initializes but states: No bone layout is enabled for this game version; Runtime motion evaluation active; Guarded bone writes require complete vehicle validation.The "Index 52" Override Bug: Whenever I use RotXType=speed for the custom spoiler bone in my .ini configuration file, the plugin automatically forces and overrides the bone index to index 52 (which is hardlocked as wing_rr pool in Gen 9).Guarded Writes Block: Because of this hardcoded index redirection, the updated Next-Gen engine security kicks in and completely locks the matrix write access, returning: configured bone probes do not share one matrix array; motion pipeline: guarded writes disabled; all probes coherent; write permission remains disabled by version policy.What I need help with:Since I am running on build 1.0.1013.29, is there a specific update or a memory offsets map I should be using? Alternatively, is there an undocumented custom animation type or a specific memory offset bypass parameter (like RotXSource redirection or alternative matrix pools) that I can use inside the .ini file to make the script rotate the bone safely without triggering the protected Index 52 body block?Thank you for your time and support!
Hi, my rear trunk spoiler still isn't working. The system says it's reading the vehicle but returns code 52. Please let me know where I can send you my model details so you can test it. Thanks for your attention.
You have to appreciate this work—it’s excellent. It just needs to be finished somehow, especially for the Enhanced version of GTA 5 It’s not working yet, even though I’ve tested it extensively; I changed the trunk spoiler setting on the car and updated the naming hierarchy, but it still doesn't work.
@atuli You can add me on Discord.
最有实力的一集
这个脚本是否支持增强版的1.0.1013.34版本？
@197586 并没有放开支持,我建议你更新到最新版本,如有需要,我会放开对于1.0.1013.34版本的支持.因为旧版本有很多不确定因素,可能会导致游戏崩溃,而且由于版本迭代,后续收到的bug反馈应该是跟着游戏版本前进的,旧版本的bug反馈有时候会影响对现版本的一些判断
不过应该不会到崩溃游戏的程度,脚本做了接受到未知信息的时候会切断脚本运行的保护措施
我的增强版34版本成功运行了，但是脚本识别不到尾翼骨骼，没有其它任何bug，就是单纯的识别不到车辆骨骼才不起作用的，我看了脚本日志才发现的
@197586 如果其他骨骼能识别到可能是车辆部件ID问题
我加了4个车的ini文件，日志给的结果都是定位不到骨骼
@197586 加我discord 发给我 我来测试
@SukiHateProm1se 就是我之前在评论区里告诉你的那两辆尾翼，其余两辆车只有雨刷，它们四个一个都不工作
@197586 我转换不了,你发给我吧
discord我进不去，我的vpn唯独进不去那个
@197586 QQ:2122612459
@SukiHateProm1se You can make your ecosystem version-agnostic, you must remove hardcoded hex offsets entirely.
Instead of guessing the memory location, the code can implement a native C++ Pattern Scanner.
When the game initializes, the .asi plugin scans the game's actual machine code for
a unique bite-signature left behind by the vehicle matrix rendering functions.
Once it locates that function signature, it dynamically extracts the exact offset,
whether you are running 1.0.1013.20, 1.0.1158.13, or any future next-gen game version.