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

AdvancedFuelSystem (AFS) v3.0.0 更新日志
提示：本版本为完全重写，并非以旧版代码缝缝补补，关于旧版FuelAndElectricSystem不再维护。接下去会以v3.0.0版本(AFS)，进行修复与优化和更新，以下列出从旧版升级至新版的所有功能变更与新增内容。
--为每种载具类型（汽车/直升机/飞机/船只）单独设计物理计算逻辑（所有模型均参考相应工程领域常识，更贴近真实驾驶体验）
--新增对直升机的完整支持，包含悬停与高空飞行油耗模型（高度越高油耗越大，悬停状态消耗显著高于前飞）
--新增对固定翼飞机的完整支持，模拟高空巡航效率与加力消耗（高空空气稀薄、阻力小，巡航油耗降低，加力时消耗剧增）
--新增对船只的完整支持，考虑波浪起伏对油耗的影响（波浪起伏增加阻力，油耗随海况动态变化）
--新增电动车独立电耗模型，并模拟动能回收效应
--优化了燃油汽车的原有油耗模型公式（首次引入了爬坡/下坡完整的发动机功率检测）
--根据载具类型显示不同内容：燃油汽车显示油耗与燃油纯度/电动车显示电耗与电能回收强度/直升机显示功率与飞行状态/飞机显示燃油流量与推力效率/船只显示功率与续航。
--首次引入燃油纯度概念，不同品牌油品质量不同，燃油汽车通过自身特性评估燃油纯度要求，低于要求可能会引发发动机短暂熄火，加油时新旧燃油混合，纯度动态变化
--新增四大燃油品牌（LTD/RON/XERO GAS/GLOBE OIL），各有不同的价格、油品和补给速度，加油站品牌在地图上以不同颜色和名字区分。
--新增每日油价随机波动范围限制（防止价格极端跳水或暴涨），并在靠近对应加油站时显示今日涨跌幅，方便玩家选择加油时机。
--修改加油逻辑，加油/充电过程按时间扣费，先加油后付款，中途可以离开车辆，不影响加油/充电状态（补给时车辆自动熄火并保持静止，防止移动）
--新增加油或充电后需在规定时间内支付费用，如果加完燃料后驾车离开，燃油公司会发送短信提醒付款并警告，未及时支付会触发随机等级的通缉机制。
--新增燃油公司嘲讽信息，如果加完燃料后弃车逃逸，燃油公司会发送嘲讽信息。
--新增军事基地（Fort Zancudo）提供政府合同燃油，费用全免，但需注意基地防御。
--每辆车的油量、燃油纯度、电量、平均消耗、续航等自动保存进配置文件，不会因为你重启游戏后记录就消失
--修复旧版坦克载具被误判为电动车的问题。
--修复频繁切换车辆导致性能下降的问题。

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

高级载具燃油系统AFS (AdvancedFuelSystem)
为GTA V注入灵魂的物理级油耗引擎 —— 告别简单油表，拥抱真实的驾驶经济学。
适用平台：GTA V (Legacy & Enhanced)
欢迎来到 GTA V 最硬核、最幽默、最让你不敢乱踩油门的燃油系统模组。这不是简单的“加油–耗油”循环，而是一套融合了航空工程动力学、汽车热力学、品牌玄学和洛圣都特色经济学的完整驾驶体验

【一、真实物理油耗——油门踩到底，钱包见到底】
轿车、SUV、跑车等地面燃油车辆：怠速、转速、车速和道路坡度共同决定瞬时油耗。爬坡时发动机负荷激增，油耗直接飙升。喜欢越野的朋友请留意——你的油表可能比悬挂先报废。
直升机：飞行高度越高，空气越稀薄，旋翼效率下降，发动机需要更大功率维持飞行，因此高度越高油耗越大。同时，悬停状态也是油老虎，悬停油耗远高于低速平飞。请尽量保持前飞并避免不必要的爬升，否则油量会像倒计时一样消失。
固定翼喷气机：高空空气密度低，气动阻力小，巡航效率最高，因此飞得越高越省油。但一旦开启全加力，油耗会指数级暴增——逃命之前请先算好返程油量。
船只：海面波浪会导致船体不断起伏，大幅增加阻力，油耗随之暴涨。想在风浪中狂飙？先问问你的油箱答不答应。
电动车：模拟了动能回收机制，松油门滑行时可回充少量电能。但高速巡航和爬坡同样会快速消耗电量，HUD 会实时显示回收强度。

【二、加油站品牌——不只是换个招牌】
洛圣都有四大燃油巨头，它们在油价、油品品质和加油速度上各有不同：
LTD：价格最贵，但油品顶级，加油速度最快，是追求性能的驾驶者首选。
RON：价格适中，品质稳定，加油速度也不错，适合绝大多数街车，闭眼选它不会错。
XERO GAS：价格便宜，品质略逊，加油偏慢，适合精打细算的普通市民。
GLOBE OIL：全城最便宜，但油品垫底，加油也最慢，适合“能跑就行”的佛系车主。
品质越高的燃油，发动机运行越顺滑；贪便宜加劣质油，迟早要付出代价。

【三、燃油品质与熄火风险——你的车比你想的更挑食】
不同车辆对燃油品质的容忍度完全不同：
超级跑车：对油品极其挑剔，必须长期使用高品质燃油（如 LTD），否则随时可能在赛道上突然失去动力——飞机熄火还能跳伞，你只能在赛道中间尴尬滑行。
开轮式赛车（如 F1 类型）：比超级跑车更敏感，基本只能吃最顶级的油，否则分分钟把你扔在赛道上。
普通跑车和性能车：要求较高，但偶尔加一次中等品质的油也能忍。
越野车和肌肉车：相对宽容，品质稍差也能跑，但长期劣质油照样会出问题。
工业车辆和军用载具：皮糙肉厚，对油品最不挑剔，毕竟它们生来就是干粗活的。

每次加油时，新油会和油箱里剩余的旧油混合，整体品质动态变化。连续加同一品牌，品质会稳定在该品牌的水准；频繁换品牌，品质忽高忽低，发动机就会“闹脾气”。
行车过程中，发动机会根据当前燃油品质和自身“娇贵程度”实时评估熄火概率。品质越低、发动机越挑剔，熄火风险就越高。运气不好时引擎会直接罢工，需要等待一小段时间才能重新启动。试想一下，你正在赛道上全力冲刺，突然失去动力——那画面太美我不敢看。

【四、专属 HUD——每辆车都有自己的仪表盘】
模组提供三种 HUD 显示模式（纯文字、纯进度条、混合），不同载具类型显示的关键数据各不相同：
燃油汽车：瞬时油耗、平均油耗、剩余续航、燃油品质（带红黄绿颜色条）、熄火风险提示。
电动车：瞬时电耗、动能回收强度百分比、续航预估。
直升机：功率百分比（直观显示发动机负载，悬停和爬升时数值极高）、剩余续航里程、滞空时间、飞行状态（地面/悬停/平飞）。
固定翼飞机：燃油流量、发动机效率百分比（高空效率更高，更省油）。
船只：功率百分比、续航里程，波浪对油耗的影响实时反映在功率条上。

【五、每日油价波动——今天加还是明天加？】
每个游戏日，油价都会随机波动，并显示涨跌百分比。精明的车主可以蹲守低价日再去加油，省下的钱够买两盒零食。

【六、政府合同——燃油由洛圣都政府买单，前提是你活着离开】
Fort Zancudo 军事基地的停机坪和跑道享受洛圣都政府合同，军用燃油完全免费。民用飞机和直升机也能蹭，但前提是你能加完油并活着离开那里。军事基地是禁飞区，低空闯入会立刻触发通缉，士兵们可不会跟你讲道理。

【七、逃单机制——燃油公司可不是好惹的】
加油或充电完成后，你需要在规定时间内支付账单。如果你直接开车、开船或起飞溜走：
燃油公司会先通过短信或屏幕提示礼貌提醒你付款。
如果超过时限仍未支付，会触发随机等级的通缉，警察会追到你怀疑人生。
要是你实在付不起油费，干脆弃车跑路——燃油公司会发来一条充满嘲讽的短信，嘲笑你连油钱都掏不出来。
部分嘲讽摘录：
“你把直升机扔在停机坪就为了省几十块油钱？你脑子是不是被旋翼打了？”
“开着几百万的喷气机逃单？你是来搞笑的吗？”
“你的船现在是一处人造礁石了，恭喜你。”

【八、补给点导航——满城都有你的加油站】
模组内置了全洛圣都所有加油点、充电桩、直升机停机坪、固定翼机场和码头泊位（包括军事基地）。驾驶对应载具时，地图上会自动显示最近的补给点，不同品牌用颜色区分。靠近补给点时，屏幕会显示当前油价或电价，并提示按 ENTER 开始加油或充电。加油过程中车辆会自动熄火，防止你边加油边溜车。

【九、物理公式参考——认真对待每一滴油】
本模组的油耗计算并非凭空捏造，而是参考了以下工程领域的常识：
汽车工程：发动机万有特性曲线、坡度阻力、空气阻力、滚动阻力。
航空工程：直升机旋翼功率需求（悬停与平飞差异、空气密度影响）、喷气发动机推力比耗油率、高空巡航效率。
船舶工程：阻力与航速关系，波浪附加阻力。
所有公式都经过简化以适配实时计算，但核心趋势完全符合现实物理直觉——油门越大越费油，爬坡比平路费油，直升机高空和悬停最耗能，喷气机高空巡航最经济。

【十、脚本运行要求】
ScriptHookV (http://www.dev-c.com/gta5/scripthookv)
dinput8.dll（随 ScriptHookV 一同提供）
ScriptHookVDotNet-v3.7.0 及以上版本，或增强版 SHVDNE（https://github.com/Chiheb-Bacha/scripthookvdotnetenhanced/releases）
.NET Framework 4.8 或更高版本

【十一、致谢】
特别感谢所有参与内测的飞行员、老司机和船老大，是你们的暴力驾驶和无情逃单测试让这个模组变得既真实又欢乐。
享受驾驶，别忘了付油费。如果你连油都加不起，那还是骑自行车吧——自行车确实不耗油，但别问我为什么。

; ================================================================
; Advanced Fuel System (AFS) v3.0.0 — 配置文件
; 本文件控制燃油系统的各项参数，编辑前建议备份。
; 修改后按 F5（默认）即可热重载，无需重启游戏。
; ================================================================
[Settings]
Hotkey=116; 热重载按键，使用虚拟键码（十进制），116 代表 F5
MinFuelPrice=5.0
MaxFuelPrice=20.0; 每日油价的随机波动范围（美元/升），系统会在两者间取随机值

[HudSettings]
HudMode=3; HUD模式：0=关闭，1=仅文字，2=仅进度条，3=文字+进度条
HudX=0.02
HudY=0.02
HudSize=0.50; 文字 HUD 在屏幕上的位置（X, Y）和缩放尺寸
FuelBarX=0.0755
FuelBarY=0.8080
FuelBarWidth=0.1390
FuelBarHeight=0.0060; 进度条的位置、宽度、高度（屏幕坐标比例 0~1）

[CustomFuelCapacities] ;自定义油箱/电池容量，格式：模型哈希=容量值
示例：
0x2B2F2E1E=80.0
0x3C4D5E6F=65.0

[CustomFuelMultipliers]自定义油耗倍率（1.0 为标准）
示例：
0x2B2F2E1E=1.2

[GaugeOffsets]仪表盘油量表偏移（仅配合 DashHook 使用）
示例：
0x2B2F2E1E=0.05

[VehicleFuelRecords] — 车辆油量持久化记录（自动维护，不建议手动编辑）
系统会自动保存每辆车（以车牌号码）的当前油量
示例：
ABCD123=45.6

[VehiclePurityRecords] — 车辆燃油纯度记录（自动维护，不建议手动编辑）
示例：
ABCD123=0.985

[FuelStations] — 自定义加油站坐标
格式：X,Y,Z,品牌名（可选）
示例：
0,0,0,LTD

[RefuelPoints] — 自定义加油点（实际油枪位置，靠近才能加油）
格式：X,Y,Z,品牌名
与 FuelStations 不同，这些是实际触发加油的具体位置
示例：
0,0,0,RON

[ChargePoints] — 自定义充电站位置
格式：X,Y,Z,品牌名
示例：
0,0,0,LTD

[HeliPoints] — 直升机停机坪加油点
格式：X,Y,Z,名称（如 "Executive Heli"）
示例：
0,0,0,My Helipad

[JetPoints] — 固定翼飞机加油点
格式：X,Y,Z,名称（如 "LSIA Jet-A"）
示例：
0,0,0,My Airstrip

[BoatPoints] — 船只加油点（码头）
格式：X,Y,Z,名称（如 "Marina"）
示例：
0,0,0,My Dock

; ================================================================
; 注释说明结束
; 请根据实际需要添加自定义条目，注意坐标精确度。
; 修改后保存，游戏内按 F5 重载即可生效。
; ================================================================
