换挡逻辑 - 自动变速箱

概述

自动变速箱逻辑控制器用于变速箱的自动换挡逻辑,不同的的驾驶模式以及液力变矩器锁止

这是 载具控制器 的一个延伸分支,如果车辆配备自动变速箱 将会自动引用这条延伸分支


文件信息

文件名 shiftLogic-automaticGearbox.lua
路径 /lua/vehicle/controller/shiftLogic-automaticGearbox.lua
使用方式 载具控制器专用

JBeam 属性

字符串
type
PRNDS21M
default
可用的换挡模式

一颗仅有手动换挡模式的变速箱,在拟真换挡模式下不会自动换挡

这条可以用于模拟带有手控阀体的自动变速箱,用于部分赛车上(例如直线车,Baja车,攀岩赛车等等)

数值
type
0
default
液力变矩器锁止的最低转速RPM
这条是基于液力变矩器输出的转速,所以即使变矩器在严重打滑也能同样的转速工作
数值
type
锁止离合器激活的转速RPM区间
数值
type
0
default
液力变矩器会进行锁止的最低挡位
数值
type
5
default
设定锁止离合器的锁止/解除的速度
数值
type
torqueConverterLockupRate * 2
default
设定锁止离合器锁止的速度
数值
type
torqueConverterLockupRate
default
设定锁止离合器解除的速度
字符串
type
N
default
当刷出车辆时的默认变速箱挡位
字符串
type
D
default
街机模式下用于前进的挡位
数值
type
0
default
设定变速箱所需最多的换挡时间(s)
数值
type
0
default
设定变速箱所需最少的换挡时间(s)
数值
type
0
default
设定变速箱在运动/手动模式下的换挡时间(s)
设为0则自动计算换挡时间
布尔值
type
true
default
当发动机转速达到怠速转速的 1.2 倍时,激活自动降档功能
数值
type
1
default
按照百分比掐油门,以提升换挡平顺性
不会在运动/手动模式介入。将数值设置为1则停用此功能,以模拟老式机械变速箱


电控

名称
单位/数值
描述
名称
lockupClutchRatio
单位/数值
0 to 1
描述
用于指示液力变矩器锁止离合器的位置。0代表彻底分离,而1则表示完全锁止

公共功能

功能名字
参数
描述
功能名字
gearboxBehaviorChanged
参数
behavior
描述
切换街机和拟真变速箱模式
功能名字
shiftUp
参数
描述
移动挡把到下一个位置
功能名字
shiftDown
参数
描述
移动挡把到上一个位置
功能名字
shiftToGearIndex
参数
index
描述
将挡把位置移动到选中的位置
功能名字
getGearName
参数
描述
当前挡位在变速箱里的位置
功能名字
getGearPosition
参数
描述
当前档把在自动换挡机构里的位置
功能名字
setDefaultForwardMode
参数
mode
描述
改变变速箱的默认前进模式
功能名字
sendTorqueData
参数
描述
将扭矩与马力相关数据展示传输到UI上

公共属性

名字
描述
名字
brake
描述
刹车输入
名字
checkEngine
描述
显示发动机是否在关闭状态
名字
clutchRatio
描述
显示离合器的输入。1是完全结合,0是完全分离
名字
currentGearIndex
描述
当前挡位前缀在变速箱的位置
名字
energyStorages
描述
发动机相关的储能装置(复数)
名字
engineLoad
描述
发动机载荷
名字
engineThrottle
描述
油门输入
名字
engineTorque
描述
在计算摩擦力阻力之前,发动机的燃烧扭矩
名字
flywheelTorque
描述
引擎输出扭矩
名字
gearboxHandling
描述
列出影响变速箱换挡行为的众多参数
名字
gearboxTorque
描述
变速箱输出扭矩
名字
idleRPM
描述
引擎怠速转速
名字
ignition
描述
显示点火打开
名字
inputValues
描述
列出包含刹车,油门以及离合数值
名字
isArcadeSwitched
描述
显示变速箱是否在街机模式
名字
isEngineRunning
描述
显示引擎正在运转
名字
isSportModeActive
描述
显示运动模式是否激活
名字
maxRPM
描述
发动机最高转速
名字
oilTemp
描述
发动机油温
名字
rpm
描述
当前发动机转速
名字
shiftPreventionData
描述
列出液力变矩器打滑的阈值以阻止升档
名字
shiftBehavior
描述
列出由载具控制器定义的当前最优的换挡点
名字
smoothedValues
描述
列出包含部分属性的平滑版本
名字
smoothedAvgAVInput
描述
变速箱输入端平滑角速度(弧度/秒)
名字
throttle
描述
油门输入
名字
timer
描述
列出包含当前时间数据
名字
timerConstants
描述
包含不同计时器目标值的列表,这些目标值是在 JBeam 中设置的
名字
waterTemp
描述
发动机冷却液温度

使用案例

一个载具控制器的部分,且有特定于此子控制器的参数,在变速器的 JBeam 中定义。

"vehicleController": {
    "automaticModes":"PRND21",
    "useSmartAggressionCalculation":false,
    "calculateOptimalLoadShiftPoints": true,
    "transmissionGearChangeDelay":2,
    "gearboxDecisionSmoothingUp":0.5,
    "gearboxDecisionSmoothingDown":0.5,
    "lowShiftDownRPM":1100,
    "lowShiftUpRPM":1900,
    //"highShiftDownRPM":3100,
},

由一个锁止液力变矩器辅助的载具控制器部分

"vehicleController": {
    "torqueConverterLockupRPM":1100,
    "torqueConverterLockupMinGear":3,
},
上一次修订: 七月 13, 2026

还有其他问题?

加入我们的 Discord 服务器
Our documentation is currently incomplete and undergoing active development. If you have any questions or feedback, please visit this forum thread.