入门
教程
模组制作
世界编辑器
支持

车辆控制器

本节内容正在完善中！部分链接可能会指向尚未完成的页面，因此无法访问。

 概述

车辆控制器用于驱动BeamNG里所有有动力驱动的车辆. 管理动力总成的控制与干涉，为不同的变速箱类型适配不同的换挡逻辑控制器

此控制器或空白控制器必须作用在任何车辆或者物体上才能产生效果

这是发动机和变速箱电控 数据的主要来源

 文件信息

文件名称 vehicleController.lua
路径 /lua/vehicle/controller/vehicleController.lua
类型 主要
使用方式 单一对象
defaultOrder 500

JBeam 属性

这些属性是从属于车辆控制器的指定属性

取决于变速箱类型，每个换挡逻辑的子控制器会有其指定的属性

lowShiftDownRPM[gear]
name
RPM
type
2000
default
当油门输入少于100%时，控制器会降挡以控制转速RPM
仅作用于自动变速箱以及街机变速箱模式
highShiftDownRPM[gear]
name
RPM
type
3500
default
当油门输入为100%时，控制器会降挡以控制转速RPM
仅作用于自动变速箱以及街机变速箱模式
lowShiftUpRPM[gear]
name
RPM
type
2500
default
当油门输入少于100%时，控制器会升挡以控制转速RPM
仅作用于自动变速箱以及街机变速箱模式
highShiftUpRPM[gear]
name
RPM
type
5000
default
当油门输入为100%时，控制器会升挡以控制转速RPM.
仅作用于自动变速箱以及街机变速箱模式
calculateOptimalLoadShiftPoints
name
boolean
type
false
default
使用根据发动机扭矩曲线和变速箱齿比推算的数据，覆盖 highShiftUpRPM 和 highShiftDownRPM 的数值
仅作用于自动变速箱以及街机变速箱模式
shiftDownRPMOffsetCoef
name
number
type
1.3
default
调整自动计算的降挡点以减少寻挡时间
用于计算最优换挡时机
gearboxDecisionSmoothingDown
name
number
type
2
default
决定控制器对逐渐减少的油门输入的反应

仅作用于自动变速箱以及街机变速箱模式

高数值意味着控制器在收油时会更快地升挡

gearboxDecisionSmoothingUp
name
number
type
5
default
决定控制器对逐渐增加的油门输入的反应

仅作用于自动变速箱以及街机变速箱模式

高数值意味着控制器在给油时会更快地降挡

aggressionSmoothingUp
name
number
type
1.5
default
决定控制器对突增的油门输入的反应速度

仅作用于自动变速箱以及街机变速箱模式

高数值意味着控制器在重油时会更快地降挡

aggressionSmoothingDown
name
number
type
0.15
default
决定控制器对减缓的油门输入的反应速度

仅作用于自动变速箱以及街机变速箱模式

高数值意味着控制器在轻油时会更快地升挡

useSmartAggressionCalculation
name
boolean
type
true
default
基于车辆速度，油门以刹车输入，激活智能驾驶习惯计算
禁用以模拟机械或老式电子变速箱
aggressionHoldOffThrottleDelay
name
number
type
2.25
default
如果使用了智能驾驶习惯计算，驾驶习惯factor将会在松油门后，设定一段时间(秒)保持油门输入，再彻底放开油门
topSpeedLimit
name
number
type
-1
default
极速限制 (米/秒)
如果数值低于0则不激活
topSpeedLimitReverse
name
number
type
-1
default
倒挡极速限制 (米/秒)
如果数值低于0则不激活
wheelSlipUpThreshold
name
number
type
20000
default
在升挡指令被阻止前，最大允许的车轮空转速度

仅作用于自动变速箱以及街机变速箱模式

用于防止车辆在轮胎空转时立刻升挡

wheelSlipDownThreshold
name
number
type
30000
default
在降挡指令被阻止前，最大允许的车轮空转速度

仅作用于自动变速箱以及街机变速箱模式

用于防止车辆在刹车导致驱动胎锁死的情况下立刻降挡

wheelSlipShiftUpSmoothingIn
name
number
type
10
default
控制阻止升挡逻辑，防止在过度轮胎空转下升挡
wheelSlipShiftUpSmoothingOut
name
number
type
20
default
控制阻止升挡逻辑，防止在过度轮胎空转下升挡
shiftLogicName
name
string
type
gearboxType
default
覆写要使用的换挡逻辑控制器
多用于电机，鉴于电机不被用做为变速箱
transmissionShiftDelay
name
number
type
0.2
default
除开离合松合时间，相邻挡位之间切换最少的用时(秒)

用于使用升降挡键位时的手动挡变速箱，以及当双离合变速箱手动选挡时

在使用H排挡更换挡位时，此属性不适用

transmissionGearChangeDelay
name
number
type
0.5
default
连续2次挡位切换的最少用时(秒)
仅作用于自动变速箱以及街机变速箱模式
neutralSelectionDelay
name
number
type
0.5
default
进入或是离开空挡时的最少用时(秒)
仅作用于自动变速箱以及街机变速箱模式

 公共功能

功能名称
参数
描述
功能名称
shiftUp
参数
描述
操控变速箱升1个挡位
功能名称
shiftDown
参数
描述
操控变速箱降1个挡位
功能名称
shiftToGearIndex
参数
index
描述
操控变速箱挂入指定挡位
功能名称
cycleGearboxModes
参数
描述
在街机与拟真之间切换模式
功能名称
setGearboxMode
参数
behavior
描述
将变速箱行为模式切换到指定模式
功能名称
smartParkingBrake
参数
ivalue, filter
描述
当用户停下车后，自动启用并保持驻车刹车激活
功能名称
setStarter
参数
enabled
描述
激活发动机起动机
功能名称
setEngineIgnition
参数
enabled
描述
激活发动机点火开关
功能名称
setFreeze
参数
setFreeze
描述
激活变速箱锁
功能名称
sendTorqueData
参数
描述
将扭矩与马力相关数据展示传输到UI上
功能名称
vehicleActivated
参数
描述
当激活车辆切换时，执行代码并更新UI

 公共属性

名字
描述
名字
throttle
描述
油门输入
名字
brake
描述
刹车输入
名字
clutchRatio
描述
离合输入
名字
engineInfo
描述
包含大量引擎相关信息的数组，供GUI元素使用
名字
fireEngineTemperature
描述
将类似发动机的动力总成装置的温度，暴露于火灾模拟环境中

 电控

输入

名字
单位/数值
描述
名字
brake
单位/数值
0 to 1
描述
刹车输入百分比
名字
brakelights
单位/数值
0 to 1
描述
刹车输入百分比
名字
clutch
单位/数值
0 to 1
描述
离合输入百分比
名字
clutchRatio
单位/数值
0 to 1
描述
离合输入百分比
名字
ignition
单位/数值
boolean
描述
用于指示点火开关是否在ON位置，即使不小心熄火了也会保持在打开状态
名字
throttle
单位/数值
0 to 1
描述
油门百分比，会受到自动补油和基于变速箱换挡逻辑的油门切断影响

 发动机信息

名字
单位/数值
描述
名字
checkengine
单位/数值
boolean
描述
用于指示发动机关闭或者由于某个问题无法启动发动机
名字
engineLoad
单位/数值
0 to 1
描述
发动机荷载百分比，基于对比当前扭矩与发动机可产生的最大扭矩
名字
engineThrottle
单位/数值
0 to 1
描述
有效油门开度。如果为0，发动机处于关闭状态
名字
engineRunning
单位/数值
boolean
描述
用于指示现在发动机是否处于开启状态
名字
oiltemp
单位/数值
Celsius
描述
机油温度(在风冷车上用作为主要的发动机温度指示)
名字
radiatorFanSpin
单位/数值
0 to 360
描述
当散热器风扇打开时，给与指定的散热器风扇模型旋转的功能。此属性作用于物体上
名字
rpm
单位/数值
RPM
描述
发动机转速
名字
running
单位/数值
boolean
描述
用于指示点火开关在ON位置上，即使不小心熄火了也会在ON上
名字
watertemp
单位/数值
Celsius
描述
散热器温度(在水冷车上用作为主要的发动机温度指示)

 燃料信息

名字
单位/数值
描述
名字
fuel
单位/数值
0 to 1
描述
油箱剩余油量百分比
名字
fuelCapacity
单位/数值
Liters
描述
油箱承载能力
名字
fuelVolume
单位/数值
Liters
描述
油箱内所剩的油量
名字
lowfuel
单位/数值
boolean
描述
用于提示油箱仅有少于10%的油量

 变速箱信息

名字
单位/数值
描述
名字
gear
单位/数值
string
描述
当前选择挡位，手动挡显示在哪个挡位上，其他变速箱则会显示挡把位置(PRDN)，以及在显示挡位位置同时，在数字前面显示运动(S)/手动(M)模式前缀
名字
gear_A
单位/数值
0 to 1
描述
显示自动挡/双离合的挡把位置
名字
gearIndex
单位/数值
numbers
描述
当前挡位的前缀。倒挡为负数，空挡为0
名字
isShifting
单位/数值
boolean
描述
指示变速箱现在是否正在换挡
名字
smoothShiftLogicAV
单位/数值
numbers
描述
平滑的无人驾驶换挡逻辑，用于确定街机模式变速箱的倒车开关和自动刹车(以及其他功能)，并向AI开放以供使用

 用法示例 

    "controller": [
        ["fileName"],
        ["vehicleController", {}],
    ],
    
    "vehicleController": {
        "calculateOptimalLoadShiftPoints": true,
        "transmissionGearChangeDelay":2,
        "gearboxDecisionSmoothingUp":2,
        "gearboxDecisionSmoothingDown":2,
        "aggressionSmoothingUp":1,
        "aggressionSmoothingDown":0.5,
        "aggressionHoldOffThrottleDelay":1.75,
        "lowShiftDownRPM":1000,
        "lowShiftUpRPM":1800,
    },

一个车辆的车辆控制器属性，通常平分在这个车辆的各种发动机与变速箱之间

削弱低段扭矩的部件可能会提高 clutchLaunch 的数据， 相较下提高最大转速的部件会提高 highShiftRPM 的数值

上一次修订: 六月 22, 2026

页面菜单:

还有其他问题?

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