脚本作者：Lisztdreams
联系方式：5Mods账号ID：Lisztdreams
QQ邮箱：757946163@qq.com
哔哩哔哩uid：452301387
脚本更新时间：2026.04.26
(未经作者同意，禁止修改以及打包传播和售卖)

------------------脚本基本介绍---------------------

VehicleMileage — GTA V 车辆里程记录脚本

这是一个轻量级的 ScriptHookVDotNet 脚本，能够自动统计每辆载具的本次驾驶里程和累计行驶总里程。所有里程数据都会自动保存到配置文件中，即便切换车辆、角色死亡或重启游戏，已累积的里程记录依然保留，不会丢失。为了避免偶尔乘坐陌生载具就产生无效记录，脚本只会将累计行驶超过 1 公里的载具数据写入配置文件，保持数据整洁。

前置插件要求：
ScriptHookV（最新版本，与当前游戏版本匹配）
ScriptHookVDotNet（v3 版本，基于 .NET Framework 4.8；如果使用旧版 v2 请酌情调整）

主要功能：
1.本段行程 & 累计总里程
每一辆载具都会独立统计从上车开始的本段驾驶距离以及历史累计总里程，累计里程跨驾驶环节永久保留。
2.双单位显示
屏幕 HUD 同时显示公里和英里，免去手动换算。
3.自动保存且不丢失
每 30 秒自动保存一次里程数据，角色死亡时也会立即保存。即便切换车辆、死亡或重启游戏，所有已记录的累计里程都会被完整保留。
4.智能过滤零散载具
为避免只乘坐过一次的陌生车辆污染配置文件，脚本仅在载具累计里程达到 1 公里以上时才会将其写入 INI 文件。
5.车辆名称自定义
可将难记的模型哈希值（如 0xB2C046E5）通过配置文件映射为自定义名称（例如“旋风 斗殴者”），HUD上将直接显示友好名称。
6.热键重载配置
默认按下 F5 即可重新读取 INI，无需重启脚本或游戏，方便实时调整 HUD 位置、名称映射等。
7.HUD 位置/大小可调
可通过配置文件自由定制显示坐标和缩放。

------------------脚本配置文件注释---------------------

配置文件说明（scripts/VehicleMileage.ini）：
脚本首次运行时会自动生成默认配置文件，您也可以手动修改。文件采用标准 INI 格式，分为四个节：

[HUD]
HUD=0.25,0.972,0.3
控制屏幕文字的位置和大小，三个值用逗号分隔，依次为：横坐标 X、纵坐标 Y、缩放 Scale。
坐标范围 0.0 ~ 1.0（屏幕左下角为 (0, 0)，右上角为 (1, 1)）。默认放在屏幕底部中央偏左。

[Keys]
ReloadKey=F5
重载配置的热键，可改为任意 System.Windows.Forms.Keys 枚举值（如 F6、R、F9 等，建议使用功能键避免冲突）。

[Names]
0xB2C046E5=旋风 斗殴者
0x1234ABCD=我的爱车
此节用于给载具模型哈希指定一个友好的显示名称。
等号左边必须为模型哈希值（带或不带 0x 前缀均可，脚本会自动补全），右边为自定义名称。
如果某车辆未在此定义，HUD上将直接显示其十六进制哈希。

[Mileage]
0xB2C046E5=123.456
0x1234ABCD=9.870
记录每辆车的累计行驶总里程（单位：公里）。
脚本仅在载具累计行驶超过 1 公里后才会将其写入此节，避免出现大量只驾驶了几米的临时车辆条目。
如需手动修改某辆车的总里程，可直接调整数值并重载配置；若想删除某辆车的记录，移除对应行即可。

安装与使用方法：
1.确保已正确安装 ScriptHookV 和 ScriptHookVDotNet。
2.将 VehicleMileage.dll 复制到游戏根目录下的 scripts 文件夹中（如果没有请手动创建）。
3.启动游戏并进入故事模式（注意：线上模式使用 Mod 有封号风险，请仅在单人模式或自行衡量风险的环境中使用）。
4.进入任意载具，HUD 会立刻显示当前车辆的本段行程和累计总里程。所有记录都会自动在后台保存，累计里程不会因换车、死亡或退出游戏而丢失。
按键重载：修改 INI 文件后，在游戏中按下 F5（或你自定义的热键）即可生效，无需重新进游戏。
5.数据管理：只有行驶里程超过 1 公里的载具才会出现在配置文件中，临时驾驶的陌生车辆不会留下痕迹。若需要清理旧数据，直接编辑 [Mileage] 节并保存，再按热键重载即可。
6.祝你在洛圣都的每一公里都充满回忆！