03. 灯光类

🔦

更新日志：V1.1 2026.06.29
新增：《原生灯光 Section》----（盲区检测灯）

INCLUDE公共库引用

抬头引用模板

ini

[INCLUDE] ; CSP 灯光相关公共库引用
INCLUDE = common/custom_emissive.ini ; CustomEmissive 自定义发光灯组
INCLUDE = common/selflighting.ini ; 自发光补光 / 局部灯罩补光
INCLUDE = common/f1_lights.ini ; F1 / 方程式赛车灯光模板
INCLUDE = common/gt3_lights.ini ; GT3 / 赛车灯光模板
INCLUDE = common/oldschool_lights_reflections.ini ; 老车灯光反射模板

全局灯光设置

禁用原车 lights.ini
避免原始灯光与 EXT 灯光重复

ini

[DATA] ; 车辆数据设置
DISABLE_LIGHTSINI = 1 ; 禁用原始 data/lights.ini 灯光

禁用跳灯参数

ini

[INCLUDE: common/no_popup_lights.ini] ; 引用禁用跳灯配置
 
[LIGHT_HEADLIGHTS] ; 头灯总控制
POPUP_FILE = NONE ; 禁用弹出式头灯动画文件

全局参数样板

ini

[INCLUDE: common/custom_emissive.ini] ; 引入发光模板

MapTurningLightsProperly = 1 ; 正确映射左右转向灯
DashHighlightColor = 2, 2, 2 ; 仪表背光颜色
DashIndicatorLag = 0.0 ; 仪表指示灯延迟
OpenDoorLightLag = 0.8 ; 开门灯延迟
HeadlightsLag = 0.0 ; 头灯延迟
ReverseLightsLag = 0.5 ; 倒车灯延迟
ParkingLightsLag = 0.5 ; 示宽灯延迟
BrakingLightsLag = 0.5 ; 刹车灯延迟
TurningLightsLag = 0.8 ; 转向灯延迟
LicenseLightsLag = 0.5 ; 牌照灯延迟
HeatingMult = 1 ; 发光热衰减倍率
DevMode = 1 ; 启用调试模式

② 灯光类型分类

CustomEmissive ; 车灯发光控制
CustomEmissiveMulti ; 多通道发光控制
Headlights ; 前灯发光与前灯照明
BrakingLights ; 刹车灯发光
ReverseLights ; 倒车灯发光与照明
TurningLights ; 左右转向灯
TurningLightsFront ; 前转向灯
TurningLightsRear ; 后转向灯
TurningLightsFrontCorner ; 前角灯转向灯
TurningLightsRearCorner ; 后角灯转向灯
ParkingLights ; 示宽灯 / 小灯
LicensePlateLights ; 牌照灯
FogLights ; 前雾灯
FogLightsFront ; 前雾灯
FogLightsRear ; 后雾灯
OpenDoorLight ; 开门灯
InteriorLights ; 内饰灯
DashIndicator ; 仪表普通指示灯
DashHighlight ; 仪表背光
DashTurningLights ; 仪表转向指示灯
DashFogLights ; 仪表雾灯指示灯
DashWarningABS ; ABS 警告灯
DashWarningTC ; TC 警告灯
DashWarningCollision ; 碰撞警告灯
DashWarningAirbag ; 气囊警告灯
DashWarningEngine ; 发动机警告灯
DashWarningTemperature ; 温度警告灯
DashWarningTyrePressure ; 胎压警告灯
DashWarningFuel ; 燃油警告灯
DashWarningSeatbelt ; 安全带警告灯
DashInteriorLight ; 内饰灯指示
CustomEmissiveExtra ; 额外仪表图标
SelfLight ; 自发光补光
LIGHT_EXTRA ; 普通动态补光
LIGHT_HEADLIGHT ; 前灯照明
LIGHT_REVERSE ; 倒车照明
LIGHT_TURNSIGNAL ; 转向照明
LIGHT_SERIES ; 赛道灯串

③ CustomEmissive灯光

⚽

CustomEmissive 主要负责灯组本体按状态发光，原生 LIGHT 主要负责实际照亮环境；
现代 LED、分区灯组和复杂车灯优先用 CustomEmissive，更好控制和维护。

前灯

作用

控制前灯发光
可同时生成前灯照明
适合近光灯、远光灯、日行灯主发光

Headlights 模板会生成 EMISSIVE_HEADLIGHTS_...，并可生成 LIGHT_HEADLIGHT_0 照明；
官方模板里包含 ACT_AS_HEADLIGHTS、LAG、LOCATION = FRONT 等输出。

前灯发光 + 照明

ini

[CustomEmissive] ; 前灯发光模板
Meshes = mesh_headlight_l, mesh_headlight_r ; 作用左右前灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 前灯发光区域
@ = Headlights, Channel = 0, Intensity = 1.0, Color = "20, 20, 20", Direction = "0, 0, 1", Offset = "0, 0, 0" ; 绑定前灯

刹车灯

作用

踩刹车时点亮
适合尾灯刹车区、高位刹车灯、贯穿式刹车灯

BrakingLights 输出 EMISSIVE_BRAKE_...，默认颜色来自 DefaultBrakingColor，并支持 HeadlightsIntensity 作为小灯状态下的低亮度尾灯回退颜色。

ini

[CustomEmissive] ; 刹车灯发光模板
Meshes = mesh_brake_light_l, mesh_brake_light_r ; 作用刹车灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 刹车灯发光区域
@ = BrakingLights, Channel = 0, Intensity = 1.0, Color = "40, 0, 0" ; 绑定刹车灯

倒车灯

作用

挂倒挡时点亮
可生成倒车照明
适合白色倒车灯、后部照明

ReverseLights 会生成 EMISSIVE_REVERSE_...，并可生成 LIGHT_REVERSE_0，默认位置为后部。

ini

[CustomEmissive] ; 倒车灯发光模板
Meshes = mesh_reverse_light_l, mesh_reverse_light_r ; 作用倒车灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 倒车灯区域
@ = ReverseLights, Channel = 0, Intensity = 1.0, Color = "40, 40, 40", Direction = "0, 0, -1", Offset = "0, 0, 0" ; 绑定倒车灯

转向灯

作用

控制左右转向灯
适合前转向灯、后转向灯、侧转向灯、动态流水转向基础发光

官方模板包含 TurningLightsFront、TurningLightsRear、TurningLightsFrontCorner、TurningLightsRearCorner、TurningLightsRearCombined、DashTurningLights 等 Mixin；转向灯默认输出左右两组 EMISSIVE_TURNSIGNAL_LEFT/RIGHT 和对应 LIGHT_TURNSIGNAL。

前转向灯

ini

[CustomEmissive] ; 前转向灯模板
Meshes = mesh_indicator_front_l, mesh_indicator_front_r ; 作用前转向灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = TurningLightsFront, Channel = 0, Intensity = 1.0, Color = "25, 12, 0" ; 绑定前转向灯

后转向灯

ini

Meshes = mesh_indicator_front_l, mesh_indicator_front_r ; 作用前转向灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = TurningLightsFront, Channel = 0, Intensity = 1.0, Color = "25, 12, 0" ; 绑定前转向灯

角灯转向灯

ini

[CustomEmissive] ; 前角灯转向模板
Meshes = mesh_indicator_corner_l, mesh_indicator_corner_r ; 作用角灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = TurningLightsFrontCorner, Channel = 0, Intensity = 1.0, Color = "25, 12, 0" ; 绑定前角灯转向

尾灯转向与刹车共用区域

ini

[CustomEmissive] ; 后转向刹车共用模板
Meshes = mesh_rear_combined_light_l, mesh_rear_combined_light_r ; 作用共用灯组 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 共用发光区域
@ = TurningLightsRearCombined, Channel = 0, Intensity = 1.0, Color = "25, 12, 0" ; 后转向与刹车共用

示宽灯 / 小灯

作用

开启小灯 / 车灯时点亮
适合尾灯低亮度状态、日行灯低亮度、前后示宽灯

ParkingLights 输出 EMISSIVE_LIGHT_...，默认后部位置，可用于小灯和示宽灯。

ini

[CustomEmissive] ; 示宽灯发光模板
Meshes = mesh_parking_light_l, mesh_parking_light_r ; 作用示宽灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = ParkingLights, Channel = 0, Intensity = 0.6, Color = "5, 0, 0" ; 绑定示宽灯

牌照灯

作用

车灯开启时照亮牌照
适合牌照灯发光、后牌照区域补光

ini

[CustomEmissive] ; 牌照灯发光模板
Meshes = mesh_license_plate_light ; 作用牌照灯 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 发光区域
@ = LicensePlateLights, Channel = 0, Intensity = 1.0, Color = "10, 10, 10" ; 绑定牌照灯

牌照补光：

ini

[LIGHT_EXTRA_LICENSE_PLATE] ; 牌照区域补光
BOUND_TO = mesh_license_plate_light ; 绑定牌照灯 Mesh
POSITION = 0, 0.45, -2.1 ; 灯光位置
DIRECTION = 0, -0.3, -1 ; 灯光方向
COLOR = 1, 0.95, 0.85, 3 ; 暖白灯光颜色与强度
RANGE = 1.2 ; 照明范围
SPOT = 120 ; 光锥角度
SPOT_SHARPNESS = 0.4 ; 光锥边缘锐度
AFFECTS_TRACK = 0 ; 不照亮赛道
EXTERIOR_ONLY = 1 ; 仅外部视角

雾灯

作用

Extra A 控制的前 / 后雾灯
适合前雾灯、后雾灯、赛车额外灯

官方 FogLights 同时生成发光和 LIGHT_EXTRA_0FOGFRONT；FogLightsRear 生成后雾灯发光和 LIGHT_EXTRA_0FOGREAR，默认参数包含 SPOT、RANGE、AFFECTS_TRACK、FADE_AT 等。

前雾灯

ini

[CustomEmissive] ; 前雾灯模板
Meshes = mesh_fog_light_l, mesh_fog_light_r ; 作用前雾灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = FogLightsFront, Channel = 0, Intensity = 1.0, Color = "20, 20, 20", Position = "-0.55, 0.25, 1.8" ; 绑定前雾灯

后雾灯

ini

[CustomEmissive] ; 后雾灯模板
Meshes = mesh_rear_fog_light_l, mesh_rear_fog_light_r ; 作用后雾灯 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = FogLightsRear, Channel = 0, Intensity = 1.0, Color = "20, 0, 0", Position = "-0.55, 0.45, -2.0", Mirror = 0.55 ; 绑定后雾灯

开门灯

作用

车门开启时点亮
适合门板警示灯、脚窝灯、迎宾灯、车门底部投射灯

官方 OpenDoorLight 会生成 EMISSIVE_OPENDOORS_... 和 LIGHT_OPENDOORS_0，支持 Position、Mirror、Direction 等灯光参数。

ini

[CustomEmissive] ; 开门灯发光模板
Meshes = mesh_door_warning_light_l, mesh_door_warning_light_r ; 作用车门警示灯 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 发光区域
@ = OpenDoorLight, Channel = 0, Intensity = 1.0, Color = "16, 15.6, 6", Position = "-0.7, 0.25, 0.2", Mirror = 0.7, Direction = "0, -1, 0" ; 绑定开门灯

内饰灯

作用

车灯开启时点亮内饰灯或仪表背光
适合中控按键、氛围灯、内饰弱发光

ini

[CustomEmissive] ; 内饰灯模板
Meshes = mesh_interior_buttons ; 作用内饰按键 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 1024, 1024 ; 发光区域
@ = InteriorLights, Channel = 0, Intensity = 0.6 ; 绑定内饰灯输入

仪表指示灯

作用

按输入状态点亮仪表图标
适合高光、ABS、TC、油量、安全带、胎压、开门提示

官方 DashIndicator 使用 _DashIndicator_Emissive，支持 Input、InputThreshold、InputInverse、Color、OffColor、Lag 等；
官方还提供 DashWarningABS、DashWarningTC、DashWarningEngine、DashWarningTemperature、DashWarningTyrePressure、DashWarningFuel 等快捷 Mixin。

普通仪表图标

ini

[CustomEmissive] ; 仪表普通指示灯模板
Meshes = mesh_dash_icon_light ; 作用仪表图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标发光区域
@ = DashIndicator, Channel = 0, Input = LIGHT, Color = "20, 20, 20", Intensity = 1.0 ; 车灯开启时点亮

远光灯指示

ini

[CustomEmissive] ; 远光灯仪表指示模板
Meshes = mesh_dash_highbeam_icon ; 作用远光灯图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashIndicator, Channel = 0, Input = HIGHBEAM, Color = "0, 4, 20", Intensity = 1.0 ; 远光灯开启时点亮

仪表转向指示

ini

[CustomEmissive] ; 仪表转向灯指示模板
Meshes = mesh_dash_turn_l, mesh_dash_turn_r ; 作用左右转向图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashTurningLights, Channel = 0, Intensity = 1.0, Color = "0, 20, 2" ; 绑定仪表转向指示

仪表警告灯

ABS 警告灯

ini

[CustomEmissive] ; ABS 仪表警告灯模板
Meshes = mesh_dash_abs_icon ; 作用 ABS 图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningABS, Channel = 0, Intensity = 1.0 ; 绑定 ABS 警告

TC 警告灯

ini

[CustomEmissive] ; TC 仪表警告灯模板
Meshes = mesh_dash_tc_icon ; 作用 TC 图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningTC, Channel = 0, Intensity = 1.0 ; 绑定 TC 警告

发动机警告灯

ini

[CustomEmissive] ; 发动机仪表警告灯模板
Meshes = mesh_dash_engine_icon ; 作用发动机图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningEngine, Channel = 0, Intensity = 1.0 ; 绑定发动机警告

温度警告灯

ini

[CustomEmissive] ; 温度仪表警告灯模板
Meshes = mesh_dash_temp_icon ; 作用温度图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningTemperature, Channel = 0, Intensity = 1.0 ; 绑定温度警告

胎压警告灯

ini

[CustomEmissive] ; 胎压仪表警告灯模板
Meshes = mesh_dash_tyre_pressure_icon ; 作用胎压图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningTyrePressure, Channel = 0, Intensity = 1.0, Pressure = 20 ; 绑定胎压警告阈值

燃油警告灯

ini

[CustomEmissive] ; 燃油仪表警告灯模板
Meshes = mesh_dash_fuel_icon ; 作用燃油图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningFuel, Channel = 0, Intensity = 1.0 ; 绑定燃油警告

安全带警告灯

ini

[CustomEmissive] ; 安全带仪表警告灯模板
Meshes = mesh_dash_seatbelt_icon ; 作用安全带图标 Mesh
Resolution = 512, 512 ; 发光遮罩分辨率
@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 图标区域
@ = DashWarningSeatbelt, Channel = 0, Intensity = 1.0 ; 绑定安全带警告

自定义仪表图标

作用

车辆没有仪表图标 Mesh 时，额外生成仪表图标
适合补 ABS、TC、转向箭头、远光灯、油量灯等图标

官方 CustomEmissiveExtra 用于给缺少仪表图标的车创建新指示图标，通常从 [CustomEmissiveExtra] 开始，并添加 icon 或 arrow。

图标样板

ini

[CustomEmissiveExtra] ; 额外仪表图标模板
Meshes = mesh_dashboard_panel ; 绑定仪表面板 Mesh
Brightness = 0.05 ; 图标基础亮度

@ = CustomEmissiveExtra_Icon, Role = HIGHBEAM, Position = 0.02, 0.01, 0.0, Size = 0.008, 0.008 ; 创建远光灯图标
@ = CustomEmissiveExtra_Icon, Role = ABS, Position = 0.04, 0.01, 0.0, Size = 0.008, 0.008 ; 创建 ABS 图标
@ = CustomEmissiveExtra_Icon, Role = TRACTIONCONTROL, Position = 0.06, 0.01, 0.0, Size = 0.008, 0.008 ; 创建 TC 图标

转向箭头样板

ini

[CustomEmissiveExtra] ; 额外转向箭头模板
Meshes = mesh_dashboard_panel ; 绑定仪表面板 Mesh
Brightness = 0.05 ; 图标基础亮度

@ = CustomEmissiveExtra_TurnArrows, Position = 0.02, 0.02, 0.0, Gap = 0.02, SizeBase = 0.004, 0.004, SizeArrow = 0.00

多通道发光

作用

同一个 Mesh 内分多个发光区域
适合同一灯组内同时存在刹车灯、转向灯、倒车灯、示宽灯

样板代码：

ini

[CustomEmissiveMulti] ; 多通道发光模板
Meshes = mesh_rear_light_group ; 作用后灯组 Mesh
Resolution = 1024, 1024 ; 发光遮罩分辨率

@ = CustomEmissive_Rect, Channel = 0, Start = 0, 0, Size = 512, 512 ; 刹车灯区域
@ = BrakingLights, Channel = 0, Intensity = 1.0 ; 绑定刹车灯

@ = CustomEmissive_Rect, Channel = 2, Start = 0, 512, Size = 512, 512 ; 倒车灯区域
@ = ReverseLights, Channel = 2, Intensity = 1.0 ; 绑定倒车灯

④ 发光漫射 Emissive

作用

让发光物体周围也有一点泛光。
适合屏幕、按钮、尾灯灯罩、阅读灯、氛围灯。

屏幕漫射样板

ini

[EXTRA_FX_EMISSIVE_...] ; 屏幕发光漫射
MESHES = mesh_dashboard_screen ; 屏幕 Mesh
RANGE = 0.055 ; 漫射范围
COLOR = 0.95, 0.95, 1.05, 3 ; 漫射颜色与强度
DIRECTED = 1 ; 定向漫射
DISABLE_WITH_EMISSIVE_LIGHT = 0 ; 不与自发光互斥
INTERIOR_ONLY = 1 ; 仅内饰
EXTERIOR_ONLY = 0 ; 不限制外部

灯罩漫射样板

ini

[EXTRA_FX_EMISSIVE_...] ; 灯罩发光漫射
MESHES = mesh_taillight_glass_l, mesh_taillight_glass_r ; 灯罩 Mesh
RANGE = 0.015 ; 漫射范围
COLOR = 200, 0, 0, 0.8 ; 红色漫射
DIRECTED = 0 ; 非定向漫射
DISABLE_WITH_EMISSIVE_LIGHT = 1 ; 与自发光灯互斥
INTERIOR_ONLY = 0 ; 不限制内饰
EXTERIOR_ONLY = 0 ; 不限制外部

适用

数字仪表屏幕
中控屏
尾灯灯罩
发光按钮
阅读灯
氛围灯

⑤ 物理投光 SelfLight

作用

给发光物体附近增加小范围补光
适合头灯玻璃、尾灯灯罩、牌照灯、内饰小灯

SelfLight 模板输出为 LIGHT_EXTRA_...，官方模板默认包含 COLOR、SPOT、RANGE、FADE_AT、FADE_SMOOTH、SPECULAR_MULT、EXTERIOR_ONLY、INTERIOR_ONLY 等参数。

ini

[SelfLight_...] ; 左前灯自发光补光
POSITION = -0.6, 0.45, 1.8 ; 灯光位置
DIRECTION = 0, 0, 1 ; 灯光方向
BOUND_TO = mesh_headlight_l ; 绑定左前灯 Mesh
COLOR = 1, 1, 1, 30 ; 灯光颜色与强度
SPOT = 190 ; 光锥角度
SPOT_SHARPNESS = 0.5 ; 光锥边缘锐度
RANGE = 0.5 ; 照明范围
SPECULAR_MULT = 1 ; 高光影响强度
SELF_LIGHTNING = 1 ; 启用自照明
EXTERIOR_ONLY = 1 ; 仅外部视角
INTERIOR_ONLY = 0 ; 不限内饰视角
DIFFUSE_CONCENTRATION = 0.9 ; 漫反射集中度

左右对称写法：

ini

[SelfLight_...] ; 左右前灯自发光补光
POSITION = -0.6, 0.45, 1.8 ; 左灯位置
MIRROR = 0.6 ; 自动镜像右灯
DIRECTION = 0, 0, 1 ; 灯光方向
COLOR = 1, 1, 1, 30 ; 灯光颜色与强度
SPOT = 190 ; 光锥角度
RANGE = 0.5 ; 照明范围
BOUND_TO = mesh_headlight_l ; 绑定左灯 Mesh

⑥ 灯光物理投射 LIGHT_EXTRA

作用

手动添加动态光源
适合车灯补光、内饰补光、牌照补光、赛道局部灯

前方补光

ini

[LIGHT_EXTRA_...] ; 前灯额外补光
BOUND_TO = mesh_headlight_l ; 绑定前灯 Mesh
POSITION = -0.6, 0.45, 1.8 ; 灯光位置
MIRROR = 0.6 ; 镜像右侧灯光
DIRECTION = 0, -0.1, 1 ; 灯光方向
COLOR = 1, 1, 1, 20 ; 灯光颜色与强度
RANGE = 15 ; 照明范围
SPOT = 80 ; 光锥角度
SPOT_SHARPNESS = 0.35 ; 光锥边缘锐度
FADE_AT = 40 ; 开始淡出距离
FADE_SMOOTH = 20 ; 淡出平滑距离
AFFECTS_TRACK = 1 ; 照亮赛道
AFFECTS_CARS = 1 ; 照亮车辆
SPECULAR_MULT = 1 ; 高光影响强度

内饰补光

ini

[LIGHT_EXTRA_...] ; 内饰氛围补光
POSITION = 0, 0.9, 0.1 ; 灯光位置
DIRECTION = 0, -1, 0 ; 向下照射
COLOR = 0.1, 0.3, 1, 2 ; 蓝色灯光与强度
RANGE = 1.2 ; 照明范围
SPOT = 160 ; 大角度柔光
SPOT_SHARPNESS = 0.1 ; 柔和边缘
AFFECTS_TRACK = 0 ; 不照亮赛道
INTERIOR_ONLY = 1 ; 仅内饰视角
SPECULAR_MULT = 0.2 ; 降低高光

⑦ 原生灯光 Section

⚽

参考 CSP 官方 Wiki「Cars – Emissive objects」 | 「Cars – Instruments inputs」
该页面说明车辆发光对象 EMISSIVE_* 的配置写法，用于让指定 Mesh 根据车辆状态自动发光。
例如普通车灯、刹车灯、倒车灯、左右转向灯、远近光灯、Extra 自定义灯、仪表指示灯、档位灯、开门提示灯等，并支持自定义输入、备用颜色、闪烁、流水转向、可见性切换和亮度延迟等功能，适合制作车辆灯组、仪表图标和状态灯

日行灯

ini

[EMISSIVE_...] ; 日行灯状态灯
INPUT = DRL ; 绑定日行灯状态
NAME = mesh_drl_status_light ; 绑定日行灯状态 Mesh
COLOR = 20, 20, 20, 2 ; 白色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.2 ; 响应延迟

普通车灯

ini

[EMISSIVE_LIGHT_...] ; 普通车灯发光
NAME = mesh_parking_light ; 绑定普通灯光 Mesh
COLOR = 10, 10, 10, 1 ; 发光颜色与亮度
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.3 ; 响应延迟
SIMULATE_HEATING = 0 ; 关闭发热效果
LOCATION = FRONT ; 前部灯光

近光灯 / 远光灯

ini

[EMISSIVE_HIGHBEAM_...] ; 远光灯发光
NAME = mesh_headlight_highbeam_l, mesh_headlight_highbeam_r ; 目标远光灯 Mesh
COLOR = 255, 255, 255, 2.5 ; 远光灯发光颜色与亮度
FALLBACK_LOWBEAM_COLOR = 255, 255, 255, 2.5 ; 近光模式下的回退颜色
LAG = 0 ; 响应延迟
SIMULATE_HEATING = 0.3 ; 灯丝余温效果
LOCATION = FRONT ; 标记为前部灯光

大灯投射光

ini

[LIGHT_HEADLIGHT_...] ; 大灯物理投射光
COLOR = 255, 255, 255, 0.1 ; 灯光颜色与强度
POSITION = 0, 0.56, 1.73 ; 灯光位置
MIRROR = 0.799 ; 左右镜像距离
DIRECTION = 0, -0.045, 3.2 ; 光束方向
RANGE_FIRSTPERSON = 720.0 ; 第一人称可见范围
RANGE_CARS_NEARBY = 260.0 ; 附近车辆可见范围
RANGE_CARS_DISTANT = 200.0 ; 远处车辆可见范围
RANGE_GRADIENT_OFFSET = 0.02 ; 光照衰减梯度偏移
FADE_FROM = 40.0 ; 开始淡出距离
FADE_TO = 900.0 ; 完全淡出距离
SPOT = 33.0 ; 第一聚光角度
SPOT_SHARPNESS = 0.30 ; 第一聚光边缘锐度
SPOT_EDGE = 0.10, 0.11, 0.12 ; 聚光边缘色调
SPOT_EDGE_SHARPNESS = 4.0 ; 聚光边缘过渡锐度
SECOND_SPOT = 50.0 ; 第二聚光角度
SECOND_SPOT_SHARPNESS = 0.20 ; 第二聚光边缘锐度
SECOND_SPOT_SKIP = 0.22 ; 第二聚光跳过区域
SECOND_SPOT_RANGE = 80.0 ; 第二聚光范围
SECOND_SPOT_INTENSITY = 0.70 ; 第二聚光强度

大灯灯罩局部补光

ini

[SelfLight_...] ; 远近光灯罩局部补光
BIND_TO_HEADLIGHTS = 1 ; 绑定车头灯开关
COLOR = 255, 255, 255, 5.0 ; 灯光颜色与强度
MIRROR = 0.788, 0, 0 ; 左右镜像控制
POSITION = 0, 0.549, 1.70 ; 光源位置
DIRECTION = 0, 0, 1 ; 光源照射方向
SPOT = 90 ; 聚光角度
RANGE = 0.18 ; 光照作用范围
RANGE_GRADIENT_OFFSET = -0.4 ; 光照衰减偏移
SPECULAR_MULT = 5 ; 高光反射强度
DIFFUSE_CONCENTRATION = 1 ; 漫反射集中度

刹车灯 / 示宽灯

ini

[EMISSIVE_BRAKE_...] ; 刹车灯发光
NAME = mesh_brake_light_inner_l, mesh_brake_light_inner_r ; 刹车灯 Mesh
COLOR = 200, 0, 0, 0.4 ; 刹车灯颜色与亮度
FALLBACK_HEADLIGHTS_COLOR = 200, 0, 0, 0.1 ; 示宽灯模式颜色
DIFFUSE_CONCENTRATION = 950 ; 漫射集中度
EXTERIOR_ONLY = 0 ; 不限制外部视角
INTERIOR_ONLY = 0 ; 不限制内部视角
AFFECTS_TRACK = 0 ; 不照亮赛道
SIMULATE_HEATING = 0 ; 关闭热效应
LAG = 0.8 ; 响应延迟
FADE_AT = 0 ; 距离衰减开始

刹车灯物理漫射

ini

[EXTRA_FX_EMISSIVE_...] ; 刹车灯物理漫射
NAME = mesh_brake_light_inner_l, mesh_brake_light_inner_r ; 目标刹车灯 Mesh
RANGE = 0.015 ; 漫射影响范围
COLOR = 200, 0, 0, 0.8 ; 漫射颜色与强度
DIRECTED = 0 ; 非定向漫射
DISABLE_WITH_EMISSIVE_LIGHT = 1 ; 与自发光灯同时工作时禁用
INTERIOR_ONLY = 0 ; 不限制内部视角
EXTERIOR_ONLY = 0 ; 不限制外部视角
倒车灯

后示宽灯 / 刹车灯投射光

ini

[LIGHT_BRAKE_...] ; 后示宽灯 / 刹车灯物理投射
BOUND_TO = mesh_brake_light_inner_l, mesh_brake_light_inner_r, mesh_brake_light_outer_l, mesh_brake_light_outer_r ; 绑定尾灯 Mesh
AFFECTS_TRACK = 1 ; 照亮赛道
BOUND_EMISSIVE_MAX = 900 ; 绑定自发光最大值
BOUND_EXP = 1.35 ; 绑定亮度指数
COLOR = 30, 10, 1, 0.3 ; 红色投射光
DIFFUSE_CONCENTRATION = 0.82 ; 漫反射集中度
POSITION = 0.0, 0.80, -2.15 ; 灯光位置
DIRECTION = 0, -0.15, -0.985 ; 光束方向
MIRROR = 0.66 ; 左右镜像距离
MIRROR_DIRECTION = 0 ; 不镜像方向
RANGE = 3.0 ; 照射范围
RANGE_GRADIENT_OFFSET = 0.20 ; 范围衰减偏移
FADE_AT = 160 ; 淡出开始距离
FADE_SMOOTH = 22 ; 淡出平滑度
SPOT = 110 ; 聚光角度
SPOT_SHARPNESS = 0.55 ; 聚光边缘锐度
SPOT_EDGE = 0.07, 0.07, 0.07 ; 聚光边缘色调
SPOT_EDGE_SHARPNESS = 16 ; 聚光边缘过渡锐度
SPECULAR_MULT = 1.3 ; 高光反射倍率
SINGLE_FREQUENCY = 1 ; 单一频率
EXTERIOR_ONLY = 1 ; 仅外部视角
INTERIOR_ONLY = 0 ; 不限制内部视角

ini

[LIGHT_REVERSE_...] ; 倒车灯照明
POSITION = -0.45, 0.45, -2.0 ; 左倒车灯位置
MIRROR = 0.45 ; 镜像右侧
DIRECTION = 0, -0.1, -1 ; 向后照射
COLOR = 1, 1, 1, 6 ; 白色倒车灯强度
RANGE = 8 ; 照明距离
SPOT = 110 ; 光锥角度
SPOT_SHARPNESS = 0.35 ; 光锥边缘锐度
AFFECTS_TRACK = 1 ; 照亮赛道
SPECULAR_MULT = 0.5 ; 高光影响强度

转向灯

前转向灯发光

ini

[EMISSIVE_TURNSIGNAL_LEFT_...] ; 左前转向灯发光
NAME = mesh_indicator_rear_outer_l ; 左前转向灯 Mesh
COLOR = 250, 50, 0, 5 ; 橙色发光
LAG = 0.8 ; 响应延迟
SIMULATE_HEATING = 0.0 ; 关闭灯丝余温
CAST_LIGHT = 1 ; 允许投射光
LOCATION = FRONT ; 标记为前部灯光

ini

[EMISSIVE_TURNSIGNAL_RIGHT_...] ; 右前转向灯发光
NAME = mesh_indicator_rear_outer_l ; 右前转向灯 Mesh
COLOR = 250, 50, 0, 5 ; 橙色发光
LAG = 0.8 ; 响应延迟
SIMULATE_HEATING = 0.0 ; 关闭灯丝余温
CAST_LIGHT = 1 ; 允许投射光
LOCATION = FRONT ; 标记为前部灯光

后转向灯

ini

[EMISSIVE_TURNSIGNAL_LEFT_...] ; 左后转向灯发光
NAME = mesh_indicator_rear_outer_l ; 左后转向灯 Mesh
COLOR = 250, 50, 0, 5 ; 橙色发光
FALLBACK_BRAKES_COLOR = 250, 0, 0, 5 ; 刹车共用时回退颜色
FALLBACK_HEADLIGHTS_COLOR = 250, 0, 0, 2.5 ; 示宽灯模式回退颜色
LAG = 0.8 ; 响应延迟
SIMULATE_HEATING = 0.0 ; 关闭灯丝余温
CAST_LIGHT = 1 ; 允许投射光
LOCATION = REAR ; 标记为后部灯光

ini

[EMISSIVE_TURNSIGNAL_RIGHT_...] ; 右后转向灯发光
NAME = mesh_indicator_rear_outer_r ; 右后转向灯 Mesh
COLOR = 250, 50, 0, 5 ; 橙色发光
FALLBACK_BRAKES_COLOR = 250, 0, 0, 5 ; 刹车共用时回退颜色
FALLBACK_HEADLIGHTS_COLOR = 250, 0, 0, 2.5 ; 示宽灯模式回退颜色
LAG = 0.8 ; 响应延迟
SIMULATE_HEATING = 0.0 ; 关闭灯丝余温
CAST_LIGHT = 1 ; 允许投射光
LOCATION = REAR ; 标记为后部灯光

转向辅助灯 / 弯道辅助灯

左侧转向辅助灯发光

ini

[EMISSIVE_CORNERINGLAMP_LEFT_...] ; 左转向辅助灯
NAME = mesh_cornering_lamp_left ; 绑定左侧辅助灯 Mesh
COLOR = 25, 25, 22, 3 ; 暖白发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
STEER_THRESHOLD = 20 ; 方向盘触发角度
LAG = 0.5 ; 响应延迟
LOCATION = FRONT ; 前部灯光

右侧转向辅助灯发光

ini

[EMISSIVE_CORNERINGLAMP_RIGHT_...] ; 右转向辅助灯
NAME = mesh_cornering_lamp_right ; 绑定右侧辅助灯 Mesh
COLOR = 25, 25, 22, 3 ; 暖白发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
STEER_THRESHOLD = 20 ; 方向盘触发角度
LAG = 0.5 ; 响应延迟
LOCATION = FRONT ; 前部灯光

左侧转向辅助灯实际补光

ini

[LIGHT_EXTRA_...] ; 左侧转向辅助灯补光
BIND_TO = EMISSIVE_CORNERINGLAMP_LEFT ; 绑定左侧转向辅助灯
POSITION = -0.55, 0.38, 1.75 ; 左侧辅助灯位置
DIRECTION = -0.45, -0.05, 1.0 ; 左前方照射方向
COLOR = 1, 1, 0.95, 6 ; 暖白灯光颜色与强度
RANGE = 8 ; 照明范围
SPOT = 115 ; 光锥角度
SPOT_SHARPNESS = 0.35 ; 光锥边缘锐度
FADE_AT = 60 ; 衰减开始距离
FADE_SMOOTH = 20 ; 衰减平滑度
AFFECTS_TRACK = 1 ; 照亮赛道
AFFECTS_CARS = 1 ; 照亮车辆
SPECULAR_MULT = 0.6 ; 高光反射倍率

右侧转向辅助灯实际补光

ini

[LIGHT_EXTRA_...] ; 右侧转向辅助灯补光
BIND_TO = EMISSIVE_CORNERINGLAMP_RIGHT ; 绑定右侧转向辅助灯
POSITION = 0.55, 0.38, 1.75 ; 右侧辅助灯位置
DIRECTION = 0.45, -0.05, 1.0 ; 右前方照射方向
COLOR = 1, 1, 0.95, 6 ; 暖白灯光颜色与强度
RANGE = 8 ; 照明范围
SPOT = 115 ; 光锥角度
SPOT_SHARPNESS = 0.35 ; 光锥边缘锐度
FADE_AT = 60 ; 衰减开始距离
FADE_SMOOTH = 20 ; 衰减平滑度
AFFECTS_TRACK = 1 ; 照亮赛道
AFFECTS_CARS = 1 ; 照亮车辆
SPECULAR_MULT = 0.6 ; 高光反射倍率

倒车灯

ini

[EMISSIVE_REVERSE_...] ; 倒车灯发光
NAME = mesh_reverse_light ; 倒车灯 Mesh
COLOR = 255, 255, 255, 0.1 ; 倒车灯颜色与亮度
SIMULATE_HEATING = 0 ; 关闭热效应
LAG = 0.3 ; 响应延迟
CAST_LIGHT = 1 ; 允许投射光
LOCATION = REAR ; 标记为后部灯光

倒车灯踩刹车变红

ini

[EMISSIVE_REVERSE_...] ; 倒车灯兼刹车回退
NAME = mesh_reverse_combined_light ; 绑定倒车灯 Mesh
COLOR = 25, 25, 25, 3 ; 倒车时白色
FALLBACK_BRAKES_COLOR = 250, 0, 0, 4 ; 踩刹车时红色
FALLBACK_BRAKES_COLOR_HIGHER = 1 ; 刹车颜色优先
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LOCATION = REAR ; 后部灯光

牌照灯

牌照灯自发光

ini

[EMISSIVE_LIGHT_...] ; 牌照灯自发光
NAME = mesh_license_plate_emissive ; 牌照灯发光 Mesh
INPUT_LAG_UP = 0.05 ; 渐亮时间
INPUT_LAG_DOWN = 0.90 ; 渐灭时间
COLOR = 255, 255, 255, 0.1 ; 发光颜色与亮度
LAG = 0.1 ; 响应延迟
SIMULATE_HEATING = 0.0 ; 关闭灯丝余温
SPECULAR_MULT = 1.5 ; 高光反射倍率
FADE_AT = 600 ; 距离衰减开始

牌照灯投射光源

ini

[LIGHT_LICENSEPLATE] ; 牌照灯实际光源
MESHES = mesh_license_plate_light ; 牌照灯挂点 Mesh
OFFSET = 0.00, 0.0, 0.0 ; 光源位置偏移
RANGE = 0.30 ; 照射范围
RANGE_GRADIENT_OFFSET = 0.20 ; 范围衰减偏移
SPOT = 220 ; 聚光角度
SPOT_SHARPNESS = 0.30 ; 聚光边缘锐度
COLOR = 1.35, 1.35, 1.35, 20 ; 光源颜色与强度
FALLBACK_EMISSIVE = 3.0, 3.0, 2.7, 0.5 ; 无光源时的自发光补偿
FADE_AT = 18 ; 距离衰减开始
LAYOUT = TWO_ON_TOP ; 双灯布局（ONE_ON_TOP为单灯布局）

Extra 自定义发光

ini

[EMISSIVE_EXTRA_A_...] ; Extra A 自定义发光
NAME = mesh_extra_light_a ; 绑定自定义发光 Mesh
COLOR = 25, 25, 25, 2 ; 开启时发光颜色
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.3 ; 响应延迟
SIMULATE_HEATING = 0 ; 关闭发热效果

车内阅读灯

阅读灯发光材质

EXTRA绑定，可自定义

ini

[EMISSIVE_EXTRA_A_...] ; 阅读灯发光
NAME = mesh_reading_light_emissive ; 阅读灯发光 Mesh
COLOR = 255, 200, 160, 0.1 ; 暖色发光颜色与亮度
LAG = 0.4 ; 响应延迟
SIMULATE_HEATING = 0 ; 关闭热效应
LOCATION = NONE ; 不指定外部灯光位置
CAST_LIGHT = 1 ; 允许投射光
CLUSTER_THRESHOLD = 0.6 ; 集群亮度阈值

阅读灯投射光

ini

[LIGHT_EXTRA_...] ; 阅读灯投射光 01
BIND_TO_EXTRA_A = 1 ; 绑定 Extra G 输入
COLOR = 255, 200, 160, 0.1 ; 暖色灯光颜色与强度
DIFFUSE_CONCENTRATION = 0.95 ; 光线集中程度
EXTERIOR_ONLY = 0 ; 不限制外部视角
INTERIOR_ONLY = 0 ; 不限制内部视角
AFFECTS_TRACK = 0 ; 不照亮赛道
FADE_AT = 70 ; 衰减开始距离
FADE_SMOOTH = 40 ; 衰减平滑度
MIRROR = 0, 0, 0 ; 不启用镜像
MIRROR_DIRECTION = 1 ; 镜像方向开关
POSITION = -0.0014, 1.03, 0.339 ; 灯光位置
DIRECTION = 0, -1, -0.2 ; 光束方向
RANGE = 1.2 ; 照射范围
RANGE_GRADIENT_OFFSET = 0.4 ; 范围衰减过渡
SPECULAR_MULT = 0.4 ; 反射强度倍率
SPOT = 150 ; 聚光角度
SPOT_SHARPNESS = 0.12 ; 聚光边缘硬度

车门警示灯

ini

[EMISSIVE_EXTRA_A_...] ; 车门警示灯
NAME = mesh_door_warning_light ; 目标车门灯 Mesh
INPUT_LAG_UP = 0.05 ; 渐亮延迟
INPUT_LAG_DOWN = 0.35 ; 渐灭延迟
COLOR = 150, 10, 0, 2.5 ; 发光颜色与亮度
LAG = 0.1 ; 响应延迟
SIMULATE_HEATING = 0.0 ; 关闭热效应
SPECULAR_MULT = 1.5 ; 高光反射倍率
FADE_AT = 600 ; 距离衰减开始

领航灯 / 限速器闪烁灯

作用

限速器开启时闪烁。
适合领航灯、赛车限速灯、Pit Limiter 状态灯、仪表警示闪烁灯。

标准模板

ini

[EMISSIVE_...] ; 领航灯 / 限速器闪烁灯
INPUT = SPEEDLIMITER ; 绑定限速器信号
NAME = mesh_speed_limiter_light ; 目标发光 Mesh
COLOR = 250, 1, 1, 50 ; 红色发光颜色与亮度
BLINKING_PATTERN = (|0=0|0.1=0|0.2=1|0.3=0|0.4=1|0.5=0|0.6=1|0.7=0|0.8=1|0.9=0|1=0) ; 闪烁模式

弱亮备用版

ini

[EMISSIVE_...] ; 低亮度领航灯
INPUT = SPEEDLIMITER ; 绑定限速器信号
NAME = mesh_speed_limiter_light ; 目标发光 Mesh
COLOR = 250, 1, 1, 15 ; 红色低亮度发光
LAG = 0.1 ; 响应延迟
SIMULATE_HEATING = 0 ; 关闭发热残光
BLINKING_PATTERN = (|0=0|0.2=1|0.4=0|0.6=1|0.8=0|1=0) ; 简化闪烁模式

盲区检测灯

盲区检测灯样板

ini

[EMISSIVE_...] ; 左侧盲区检测灯
NAME = BSD_L ; 左侧盲区灯mesh名，建议单独建模单独命名
INPUT = CPHYS_SCRIPT_0 ; 左侧盲区检测输入，1亮0灭
INPUT_THRESHOLD = 0.5 ; 输入大于0.5时点亮
INPUT_LAG_UP = 0.2 ; 亮起过渡，避免突然闪烁
INPUT_LAG_DOWN = 0.35 ; 熄灭过渡，避免瞬间跳灭
COLOR = 255, 150, 20, 3 ; 点亮颜色，橙黄色提示灯
OFF_COLOR = 0, 0, 0 ; 熄灭颜色
LOCATION = NONE ; 内饰提示灯，不按外部车灯处理

[EMISSIVE_...] ; 右侧盲区检测灯
NAME = BSD_R ; 右侧盲区灯mesh名，建议单独建模单独命名
INPUT = CPHYS_SCRIPT_1 ; 右侧盲区检测输入，1亮0灭
INPUT_THRESHOLD = 0.5 ; 输入大于0.5时点亮
INPUT_LAG_UP = 0.2 ; 亮起过渡，避免突然闪烁
INPUT_LAG_DOWN = 0.35 ; 熄灭过渡，避免瞬间跳灭
COLOR = 255, 150, 20, 3 ; 点亮颜色，橙黄色提示灯
OFF_COLOR = 0, 0, 0 ; 熄灭颜色
LOCATION = NONE ; 内饰提示灯，不按外部车灯处理

底盘氛围光

ini

[LIGHT_EXTRA_...] ; 底盘氛围光
POSITION = 0, 0.15, 0 ; 车辆底部中心
DIRECTION = 0, -1, 0 ; 向下照射
COLOR = 0.2, 0.0, 1.0, 3 ; 蓝紫色灯光
RANGE = 3.5 ; 照射范围
SPOT = 180 ; 大范围散射
SPOT_SHARPNESS = 0.05 ; 柔和边缘
AFFECTS_TRACK = 1 ; 照亮地面
AFFECTS_CARS = 0 ; 不照亮其他车辆
SPECULAR_MULT = 0.2 ; 弱高光

仪表背光 / 状态灯

ini

[EMISSIVE_LIGHT_...] ; 仪表状态灯
NAME = mesh_dash_status_light ; 绑定仪表灯 Mesh
COLOR = 0, 5, 0, 1 ; 绿色发光颜色与亮度
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温效果
CLUSTER_THRESHOLD = 0.5 ; 发光聚合阈值
LOCATION = NONE ; 虚拟仪表灯位置
LAG = 0.2 ; 点亮延迟
BIND_TO_HEADLIGHTS = 1 ; 随大灯开启
CAST_LIGHT = 0 ; 不投射实际光线

仪表指示灯合集

转向指示灯

ini

[EMISSIVE_TURNSIGNAL_LEFT_...] ; 仪表左转向指示灯
NAME = mesh_dash_turn_left ; 绑定左转向图标 Mesh
COLOR = 0, 50, 0, 0.8 ; 绿色发光颜色与亮度
LAG = 0.15 ; 响应延迟
SIMULATE_HEATING = 0 ; 关闭发热效果
LOCATION = NONE ; 虚拟仪表灯位置
TOGGLE_VISIBILITY = 1 ; 根据状态切换显示
INPUT_THRESHOLD = 0 ; 输入阈值
INPUT_THRESHOLD_INVERSE = 0 ; 不反向输入

ini

[EMISSIVE_TURNSIGNAL_RIGHT_...] ; 仪表右转向指示灯
NAME = mesh_dash_turn_right ; 绑定右转向图标 Mesh
COLOR = 0, 50, 0, 0.8 ; 绿色发光颜色与亮度
LAG = 0.15 ; 响应延迟
SIMULATE_HEATING = 0 ; 关闭发热效果
LOCATION = NONE ; 虚拟仪表灯位置
TOGGLE_VISIBILITY = 1 ; 根据状态切换显示
INPUT_THRESHOLD = 0 ; 输入阈值
INPUT_THRESHOLD_INVERSE = 0 ; 不反向输入

合并转向指示灯

ini

[EMISSIVE_TURNSIGNAL_...] ; 仪表合并转向指示灯
NAME = mesh_dash_turn_icon ; 绑定合并转向图标 Mesh
COLOR = 0, 25, 0, 3 ; 绿色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.1 ; 响应延迟
LOCATION = NONE ; 仪表图标位置

任意转向指示灯

ini

[EMISSIVE_TURN_ANY_STATUS] ; 任意转向状态灯
INPUT = TURNSIGNAL ; 绑定任意转向状态
NAME = mesh_turn_any_icon ; 绑定共用转向图标 Mesh
COLOR = 0, 25, 0, 3 ; 绿色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.1 ; 响应延迟

非双闪左转向指示灯

ini

[EMISSIVE_TURN_LEFT_NOHAZARD] ; 非双闪左转向
INPUT = TURNSIGNAL_NOHAZARD_LEFT ; 只绑定左转向，不包含双闪
NAME = mesh_turn_left_icon ; 绑定左转向图标 Mesh
COLOR = 0, 25, 0, 3 ; 绿色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色

可用输入

TURNSIGNAL_NOHAZARD_LEFT
TURNSIGNAL_NOHAZARD_RIGHT
TURNSIGNAL_NOHAZARD

适用

左右独立转向指示
避免双闪同时触发某些单侧效果
双闪和转向需要分开控制的仪表

远光指示灯

ini

[EMISSIVE_HIGHBEAM_...] ; 远光仪表指示灯
NAME = mesh_dash_highbeam_icon ; 绑定远光图标 Mesh
COLOR = 0, 50, 200, 5 ; 蓝色发光颜色与亮度
SIMULATE_HEATING = 0 ; 关闭发热效果
INPUT_LAG_UP = 0.01 ; 开灯渐亮时间
INPUT_LAG_DOWN = 0.5 ; 关灯渐灭时间
LOCATION = FRONT_DASHBOARD ; 标记为前仪表区域

双闪指示灯

ini

[EMISSIVE_HAZARD_...] ; 双闪仪表指示灯
NAME = mesh_dash_hazard_icon ; 绑定双闪图标 Mesh
COLOR = 30, 4, 4, 1 ; 红色发光颜色与亮度
OFF_COLOR = 0, 0, 0, 0 ; 关闭时颜色
FALLBACK_HEADLIGHTS_COLOR = 10, 4, 4, 0.1 ; 示宽模式弱亮颜色
LAG = 0.2 ; 响应延迟

手刹指示灯

ini

[EMISSIVE_HANDBRAKE_0] ; 手刹仪表指示灯
NAME = mesh_dash_handbrake_icon ; 绑定手刹图标 Mesh
COLOR = 4, 0, 0, 4 ; 红色发光颜色与亮度
OFF_COLOR = 0, 0, 0 ; 关闭时颜色
LAG = 0.15 ; 点亮延迟
SIMULATE_HEATING = 0.3 ; 模拟灯泡升温效果
LOCATION = NONE ; 虚拟仪表灯位置
ACT_AS_HEADLIGHTS = 0 ; 不作为前照灯

电瓶指示灯

ini

[EMISSIVE_BATTERY_0] ; 电瓶指示灯
NAME = mesh_dash_battery_icon ; 绑定电瓶图标 Mesh
COLOR = 25, 0, 0, 4 ; 红色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.2 ; 响应延迟
LOCATION = NONE ; 仪表图标位置

胎压 / 轮胎指示灯

ini

[EMISSIVE_TYRES_0] ; 轮胎 / 胎压指示灯
NAME = mesh_dash_tyre_icon ; 绑定轮胎图标 Mesh
COLOR = 25, 10, 0, 4 ; 橙色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
PRESSURE_THRESHOLD = 20 ; 胎压触发阈值
LAG = 0.2 ; 响应延迟
LOCATION = NONE ; 仪表图标位置

开门指示灯

ini

[EMISSIVE_EXTRA_A_...] ; 开门状态灯
NAME = mesh_open_door_icon ; 绑定开门灯Mesh
COLOR = 25, 0, 0, 4 ; 红色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.2 ; 响应延迟

安全带灯

ini

[EMISSIVE_...] ; 安全带状态灯
INPUT = SEATBELT ; 绑定安全带状态
NAME = mesh_seatbelt_icon ; 绑定安全带图标 Mesh
COLOR = 25, 0, 0, 4 ; 红色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.2 ; 响应延迟

仪表警告灯合集

发动机故障灯

ini

[EMISSIVE_ENGINE_DAMAGE_...] ; 发动机故障指示灯
NAME = mesh_dash_engine_warning ; 绑定发动机故障图标 Mesh
COLOR = 4, 1, 0, 4 ; 橙色发光颜色与亮度
LOCATION = INTERIOR ; 标记为车内仪表灯
ENGINE_LIFE_THRESHOLD = 300 ; 引擎损坏触发阈值
LAG = 0.3 ; 点亮延迟

车身损伤指示灯

ini

[EMISSIVE_...] ; 车身损伤灯
INPUT = BODY_DAMAGE ; 绑定车身损伤
INPUT_SELECTOR = MAX ; 取最大损伤
INPUT_THRESHOLD = 20 ; 超过 20 点亮
NAME = mesh_body_damage_warning ; 绑定损伤图标 Mesh
COLOR = 25, 0, 0, 4 ; 红色警告
OFF_COLOR = 0, 0, 0 ; 关闭颜色

水温警示灯

ini

[EMISSIVE_ENGINE_TEMP_0] ; 水温警示灯
NAME = mesh_dash_temp_icon ; 绑定水温图标 Mesh
COLOR = 25, 0, 0, 4 ; 高温红色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
TEMP_MIN = 100 ; 开始点亮温度
TEMP_MAX = 120 ; 最大亮度温度
TEMP_EXP = 2 ; 亮度变化曲线
LAG = 0.3 ; 响应延迟
LOCATION = NONE ; 仪表图标位置

燃油不足警告灯

ini

[EMISSIVE_...] ; 燃油不足警告灯
NAME = mesh_dash_fuel_warning ; 绑定燃油图标 Mesh
COLOR = 4, 0, 0, 4 ; 红色发光颜色与亮度
TOGGLE_VISIBILITY = 0 ; 不切换可见性
BIND_TO = FUEL ; 绑定燃油信号
LAG = 0.2 ; 点亮延迟
SIMULATE_HEATING = 0 ; 关闭发热效果

机油压力警告灯

ini

[EMISSIVE_...] ; 机油压力警告灯
INPUT = OIL_PRESSURE ; 绑定机油压力
INPUT_THRESHOLD = 1.0 ; 压力阈值
INPUT_THRESHOLD_INVERSE = 0 ; 低于阈值触发
NAME = mesh_oil_pressure_warning ; 绑定机油压力图标 Mesh
COLOR = 25, 0, 0, 4 ; 红色警告
OFF_COLOR = 0, 0, 0 ; 关闭颜色

ABS / TC / 限速器指示

TC 工作指示

ini

[EMISSIVE_TRACTIONCONTROL_0] ; 牵引力控制关闭指示灯
NAME = mesh_dash_tc_off_icon ; 绑定 TC OFF 图标 Mesh
TOGGLE_VISIBILITY = 1 ; 根据状态切换显示
COLOR = 0 ; 默认关闭颜色
OFF_COLOR = 1.3, 1, 0, 4 ; 指示灯颜色与亮度
LAG = 0.2 ; 点亮延迟
CAST_LIGHT = 0 ; 不投射光线

TC OFF 指示灯

ini

[EMISSIVE_TRACTIONCONTROL_0] ; 牵引力控制关闭指示灯
NAME = mesh_dash_tc_off_icon ; 绑定 TC OFF 图标 Mesh
TOGGLE_VISIBILITY = 1 ; 根据状态切换显示
COLOR = 0 ; 默认关闭颜色
OFF_COLOR = 1.3, 1, 0, 4 ; 指示灯颜色与亮度
LAG = 0.2 ; 点亮延迟
CAST_LIGHT = 0 ; 不投射光线

ABS 工作指示

ini

[EMISSIVE_ABS_INACTION_0] ; ABS 工作指示灯
NAME = mesh_dash_abs_active_icon ; 绑定 ABS 工作图标 Mesh
COLOR = 25, 10, 0, 4 ; ABS 介入时颜色
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.1 ; 响应延迟
LOCATION = NONE ; 仪表图标位置

ABS 警告灯

ini

[EMISSIVE_ABS_...] ; ABS 警告灯
NAME = mesh_dash_abs_warning ; 绑定 ABS 图标 Mesh
TOGGLE_VISIBILITY = 1 ; 根据状态切换显示
COLOR = 1, 1, 1, 10 ; 默认颜色与亮度
OFF_COLOR = 5, 1, 1, 8 ; 警告颜色与亮度
LAG = 0.2 ; 点亮延迟

限速器状态灯

ini

[EMISSIVE_...] ; 限速器状态灯
INPUT = SPEEDLIMITER ; 绑定限速器
INPUT_THRESHOLD = 1 ; 启用后点亮
NAME = mesh_speedlimiter_icon ; 绑定限速器图标 Mesh
COLOR = 25, 0, 0, 4 ; 红色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.2 ; 响应延迟

限速器介入灯

ini

[EMISSIVE_...] ; 限速器介入灯
INPUT = SPEEDLIMITER_INACTION ; 绑定限速器介入状态
NAME = mesh_speedlimiter_active_icon ; 绑定限速器图标 Mesh
COLOR = 25, 0, 0, 4 ; 红色发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
BLINK_REPEAT = 1 ; 启用闪烁
LAG = 0.1 ; 快速响应

胎压 / 轮胎类灯光输入

低胎压警告灯

ini

[EMISSIVE_...] ; 低胎压警告灯
INPUT = TYRE_PRESSURE ; 绑定胎压
INPUT_SELECTOR = MIN ; 取最低胎压
INPUT_THRESHOLD = 20 ; 胎压阈值
INPUT_THRESHOLD_INVERSE = 0 ; 低于阈值点亮
NAME = mesh_tyre_pressure_warning ; 绑定胎压图标
COLOR = 25, 10, 0, 4 ; 橙色警告
OFF_COLOR = 0, 0, 0 ; 关闭颜色

轮胎温度警告灯

ini

[EMISSIVE_...] ; 轮胎温度警告灯
INPUT = TYRE_TEMPERATURE ; 绑定轮胎温度
INPUT_SELECTOR = MAX ; 取最高轮胎温度
INPUT_THRESHOLD = 120 ; 超过 120 点亮
NAME = mesh_tyre_temp_warning ; 绑定轮胎温度图标
COLOR = 25, 0, 0, 4 ; 红色警告
OFF_COLOR = 0, 0, 0 ; 关闭颜色

多值选择：

INPUT_SELECTOR = X / FIRST ; 左前
INPUT_SELECTOR = Y / SECOND ; 右前
INPUT_SELECTOR = Z / THIRD ; 左后
INPUT_SELECTOR = W / FOURTH ; 右后
INPUT_SELECTOR = MIN ; 最小值
INPUT_SELECTOR = MAX ; 最大值
INPUT_SELECTOR = AVG ; 平均值

档位指示灯

N 档指示灯

ini

[EMISSIVE_GEAR_N_...] ; N 档指示灯
NAME = mesh_gear_n_indicator ; 绑定 N 档指示灯 Mesh
COLOR = 0, 100, 0, 1 ; 绿色发光颜色与亮度
LAG = 0.5 ; 亮度变化延迟
SIMULATE_HEATING = 0 ; 关闭灯泡发热效果

R 档指示灯

ini

[EMISSIVE_GEAR_R_...] ; R 档指示灯
NAME = mesh_gear_r_indicator ; 绑定 R 档指示灯 Mesh
COLOR = 0, 100, 0, 1 ; 绿色发光颜色与亮度
LAG = 0.5 ; 亮度变化延迟
SIMULATE_HEATING = 0 ; 关闭灯泡发热效果

D 档指示灯

ini

[EMISSIVE_GEAR_D_...] ; D 档指示灯
NAME = mesh_gear_d_indicator ; 绑定 D 档指示灯 Mesh
COLOR = 0, 100, 0, 1 ; 绿色发光颜色与亮度
LAG = 0.5 ; 亮度变化延迟
SIMULATE_HEATING = 0 ; 关闭灯泡发热效果

1 档指示灯

适用范围： GEAR_1~GEAR_9，1档至9档

ini

[EMISSIVE_...] ; 1 档指示灯
INPUT = GEAR_1 ; 绑定 1 档信号
NAME = mesh_gear_1_indicator ; 绑定 1 档指示灯 Mesh
COLOR = 0, 100, 0, 1 ; 绿色发光颜色与亮度
LAG = 0.5 ; 亮度变化延迟
SIMULATE_HEATING = 0 ; 关闭灯泡发热效果

自定义输入

基础写法

ini

[EMISSIVE_...] ; 自定义输入发光
INPUT = BODY_DAMAGE ; 绑定车身损坏输入
INPUT_THRESHOLD = 20 ; 输入触发阈值
NAME = mesh_damage_warning_light ; 绑定损坏警告灯 Mesh
COLOR = 25, 0, 0, 4 ; 红色警告发光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
LAG = 0.2 ; 响应延迟

等效写法

ini

[EMISSIVE_...] ; 自定义输入发光
BIND_TO = BODY_DAMAGE ; 绑定车身损坏输入
INPUT_THRESHOLD = 20 ; 输入触发阈值
NAME = mesh_damage_warning_light ; 绑定发光 Mesh
COLOR = 25, 0, 0, 4 ; 发光颜色

平滑输入

ini

[EMISSIVE_...] ; 平滑输入发光
INPUT = BODY_DAMAGE ; 绑定车身损坏输入
USE_SMOOTH_TRANSITION = 1 ; 使用连续数值过渡
INPUT_THRESHOLD = 20 ; 输入触发阈值
NAME = mesh_damage_warning_light ; 绑定发光 Mesh
COLOR = 25, 0, 0, 4 ; 发光颜色

强制关闭输入

ini

[EMISSIVE_...] ; 强制关闭输入发光
INPUT = LIGHT ; 主输入为车灯
FORCE_OFF_INPUT = HAZARD ; 双闪开启时强制关闭
NAME = mesh_status_light ; 绑定发光 Mesh
COLOR = 10, 10, 10, 2 ; 发光颜色
OFF_COLOR = 0, 0, 0 ; 关闭颜色

等效写法：

ini

[EMISSIVE_...] ; 强制关闭输入发光
BIND_TO = LIGHT ; 主输入
FORCE_OFF_BIND_TO = HAZARD ; 强制关闭输入
NAME = mesh_status_light ; 绑定发光 Mesh
COLOR = 10, 10, 10, 2 ; 发光颜色

常用附加参数

可见性切换

ini

TOGGLE_VISIBILITY = 1 ; 未触发时隐藏 Mesh
TOGGLE_VISIBILITY_INVERSE = 0 ; 不反向隐藏逻辑

只随车灯启用

ini

ONLY_WITH_HEADLIGHTS = 1 ; 仅车灯开启时激活

禁用自动投射光

ini

CAST_LIGHT = 0 ; 禁用自动动态灯光

牌照灯绑定

ini

BIND_AS = LICENSE_PLATE ; 绑定为牌照灯亮度控制

Fallback 备用颜色

共用灯带样板

ini

[EMISSIVE_TURNSIGNAL_LEFT_0] ; 左转向 / 刹车 / 示宽共用灯带
NAME = mesh_rear_combined_light_l ; 绑定共用灯带 Mesh
COLOR = 250, 100, 0, 5 ; 转向时橙色
FALLBACK_BRAKES_COLOR = 250, 0, 0, 5 ; 刹车时红色
FALLBACK_HEADLIGHTS_COLOR = 50, 0, 0, 1 ; 车灯开启时低亮红色
FALLBACK_BASE_COLOR = 0, 0, 0 ; 车灯关闭时基础颜色
OFF_COLOR = 0, 0, 0 ; 最终关闭颜色
LOCATION = REAR ; 后部灯光

可用字段

FALLBACK_HEADLIGHTS_COLOR = 车灯开启时颜色
FALLBACK_HIGHBEAM_COLOR = 远光开启时颜色
FALLBACK_LOWBEAM_COLOR = 近光开启时颜色
FALLBACK_BRAKES_COLOR = 刹车开启时颜色
FALLBACK_BRAKES_COLOR_HIGHER = 提高刹车颜色优先级
FALLBACK_BASE_COLOR = 车灯关闭时基础颜色
FALLBACK_IDLE_COLOR = 引擎运行时颜色
FALLBACK_DRL_COLOR = 日行灯状态颜色
OFF_COLOR = 最终关闭颜色

颜色优先级

主 COLOR
FALLBACK_BRAKES_COLOR
FALLBACK_BRAKES_COLOR_HIGHER 下的主 COLOR
FALLBACK_HIGHBEAM_COLOR
FALLBACK_LOWBEAM_COLOR
FALLBACK_HEADLIGHTS_COLOR
FALLBACK_DRL_COLOR
FALLBACK_IDLE_COLOR
FALLBACK_BASE_COLOR
OFF_COLOR

⑧ 动态灯光效果

适用：

流水日行灯
流水尾灯
流水转向灯
开启后变色灯
内饰氛围灯
多颜色渐变灯
呼吸灯
赛车状态灯

流水灯

原理和作用

通过不同灯段设置不同 INPUT_LAG_UP，实现按顺序点亮。
适合头灯流水启动、尾灯流水点亮、灯带分段渐亮。

ini

[EMISSIVE_EXTRA_A_...] ; 头灯流水灯段 01
INPUT = EXTRA_A ; 绑定 Extra A 控制
NAME = mesh_headlight_flow_01 ; 绑定第 1 段头灯 Mesh
INPUT_LAG_UP = 0.0 ; 第 1 段点亮延迟
INPUT_LAG_DOWN = 0.99 ; 熄灭延迟
COLOR = 1, 1, 1, 10 ; 白色发光颜色与亮度
LAG = 0.4 ; 亮度变化缓冲
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温

[EMISSIVE_EXTRA_A_...] ; 头灯流水灯段 02
INPUT = EXTRA_A ; 绑定 Extra A 控制
NAME = mesh_headlight_flow_02 ; 绑定第 2 段头灯 Mesh
INPUT_LAG_UP = 0.6 ; 第 2 段点亮延迟
INPUT_LAG_DOWN = 0.9898 ; 熄灭延迟
COLOR = 1, 1, 1, 10 ; 白色发光颜色与亮度
LAG = 0.4 ; 亮度变化缓冲
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温

[EMISSIVE_EXTRA_A_...] ; 头灯流水灯段 03
INPUT = EXTRA_A ; 绑定 Extra A 控制
NAME = mesh_headlight_flow_03 ; 绑定第 3 段头灯 Mesh
INPUT_LAG_UP = 1.2 ; 第 3 段点亮延迟
INPUT_LAG_DOWN = 0.9896 ; 熄灭延迟
COLOR = 1, 1, 1, 10 ; 白色发光颜色与亮度
LAG = 0.4 ; 亮度变化缓冲
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温

ini

[EMISSIVE_LIGHT_...] ; 尾灯流水灯段 01
INPUT = LIGHT ; 随车灯开启
NAME = mesh_taillight_flow_01 ; 绑定第 1 段尾灯 Mesh
INPUT_LAG_UP = 0.6 ; 第 1 段点亮延迟
INPUT_LAG_DOWN = 0.9898 ; 熄灭延迟
COLOR = 5, 1, 1, 1 ; 红色发光颜色与亮度
LAG = 0.4 ; 亮度变化缓冲
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温

[EMISSIVE_LIGHT_...] ; 尾灯流水灯段 02
INPUT = LIGHT ; 随车灯开启
NAME = mesh_taillight_flow_02 ; 绑定第 2 段尾灯 Mesh
INPUT_LAG_UP = 0.9 ; 第 2 段点亮延迟
INPUT_LAG_DOWN = 0.9895 ; 熄灭延迟
COLOR = 5, 1, 1, 1 ; 红色发光颜色与亮度
LAG = 0.4 ; 亮度变化缓冲
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温

[EMISSIVE_LIGHT_...] ; 尾灯流水灯段 03
INPUT = LIGHT ; 随车灯开启
NAME = mesh_taillight_flow_03 ; 绑定第 3 段尾灯 Mesh
INPUT_LAG_UP = 1.2 ; 第 3 段点亮延迟
INPUT_LAG_DOWN = 0.9892 ; 熄灭延迟
COLOR = 5, 1, 1, 1 ; 红色发光颜色与亮度
LAG = 0.4 ; 亮度变化缓冲
SIMULATE_HEATING = 0.5 ; 模拟灯泡升温

参数建议

INPUT_LAG_UP 数值越大，点亮越靠后
INPUT_LAG_DOWN 控制熄灭延迟
LAG 控制亮度过渡速度
COLOR 最后一位控制亮度

流水转向灯

原理和作用

通过 RANGE_START_INDEX / RANGE_END_INDEX / RANGE_PREFIX 批量控制灯段。
适合一排连续 Mesh 命名的流水转向灯。

命名要求

左侧灯段建议：mesh_indicator_flow_l_1 到 mesh_indicator_flow_l_12
右侧灯段建议：mesh_indicator_flow_r_1 到 mesh_indicator_flow_r_12

ini

[EMISSIVE_TURNSIGNAL_LEFT_FLOW] ; 左侧流水转向灯
RANGE_START_INDEX = 1 ; 起始灯段编号
RANGE_END_INDEX = 12 ; 结束灯段编号
RANGE_PREFIX = mesh_indicator_flow_l_ ; 左侧灯段 Mesh 前缀
COLOR = 50, 20, 1, 5 ; 橙色发光颜色与亮度
OFF_COLOR = 100, 100, 100, 1 ; 关闭时颜色
TOGGLE_VISIBILITY = 0 ; 不切换可见性
RANGE_DELAY = 0.02 ; 每段点亮延迟
SMOOTH_IN = 1 ; 点亮平滑
SMOOTH_OUT = 0 ; 熄灭不平滑
REPEAT_FREQUENCY_HZ = 3 ; 闪烁频率
LAG = 0.10 ; 响应延迟
SIMULATE_HEATING = 0.5 ; 模拟灯泡发热
CAST_LIGHT = 1 ; 允许投射光

ini

[EMISSIVE_TURNSIGNAL_RIGHT_FLOW] ; 右侧流水转向灯
RANGE_START_INDEX = 1 ; 起始灯段编号
RANGE_END_INDEX = 12 ; 结束灯段编号
RANGE_PREFIX = mesh_indicator_flow_r_ ; 右侧灯段 Mesh 前缀
COLOR = 50, 20, 1, 5 ; 橙色发光颜色与亮度
OFF_COLOR = 100, 100, 100, 1 ; 关闭时颜色
TOGGLE_VISIBILITY = 0 ; 不切换可见性
RANGE_DELAY = 0.02 ; 每段点亮延迟
SMOOTH_IN = 1 ; 点亮平滑
SMOOTH_OUT = 0 ; 熄灭不平滑
REPEAT_FREQUENCY_HZ = 3 ; 闪烁频率
LAG = 0.10 ; 响应延迟
SIMULATE_HEATING = 0.5 ; 模拟灯泡发热
CAST_LIGHT = 1 ; 允许投射光

开启后变色灯

作用

开启前显示一种颜色，开启后切换另一种颜色。
适合氛围灯、状态灯、车门灯、模式指示灯。

Extra A 控制变色灯

ini

[EMISSIVE_...] ; 开启后变色灯
INPUT = EXTRA_A ; 绑定 Extra A 控制
NAME = mesh_color_switch_light ; 绑定变色灯 Mesh
COLOR = 10, 0, 0, 20 ; 开启后发光颜色与亮度
OFF_COLOR = 10, 0, 11, 10 ; 关闭时颜色与亮度
LAG = 0.5 ; 状态切换延迟
SIMULATE_HEATING = 0.0 ; 关闭发热模拟
CAST_LIGHT = 0 ; 不投射实际光线

车灯状态变色灯

ini

[EMISSIVE_LIGHT_COLOR_SWITCH] ; 车灯开启后变色
INPUT = LIGHT ; 绑定车灯开关
NAME = mesh_light_mode_indicator ; 绑定变色灯 Mesh
COLOR = 0, 5, 20, 10 ; 开启后蓝色发光
OFF_COLOR = 10, 0, 0, 3 ; 关闭时红色弱光
LAG = 0.5 ; 状态切换延迟
SIMULATE_HEATING = 0 ; 关闭发热模拟
CAST_LIGHT = 0 ; 不投射光线

多颜色呼吸氛围灯

原理和作用

通过 LINE_FROM / LINE_TO 生成线性灯光区域。
通过 COLOR_FROM / COLOR_TO 设置多颜色渐变。
通过 BLINKING_PATTERN / BLINKING_DURATION 制作呼吸变化。

自发光呼吸氛围灯

ini

[EMISSIVE_EXTRA_A_...] ; 多颜色呼吸氛围灯自发光
LINE_FROM = 0.5, 0.43, -0.53 ; 灯光起始点坐标
LINE_TO = -0.5, 0.43, -0.53 ; 灯光结束点坐标
BIND_TO_EXTRA_A = 1 ; 绑定 Extra A 控制
COLOR_FROM = 55, 0, 0, 0.3 ; 起始颜色与亮度
COLOR_TO = 0, 0, 55, 0.3 ; 结束颜色与亮度
DIFFUSE_CONCENTRATION = 1.25 ; 漫反射集中度
FADE_AT = 150 ; 衰减开始距离
FADE_SMOOTH = 10 ; 衰减平滑度
RANGE = 0.6 ; 灯光作用范围
RANGE_GRADIENT_OFFSET = 0.1 ; 范围渐变偏移
SPOT = 180 ; 聚光角度
SPOT_SHARPNESS = 0.05 ; 聚光边缘锐度
SPECULAR_MULT = 0 ; 镜面反射强度
DIRECTION = 0, -1, 0 ; 光照方向
SELF_LIGHTNING = 1 ; 启用自发光
EXTERIOR_ONLY = 0 ; 不限制外部视角
INTERIOR_ONLY = 0 ; 不限制内部视角
SIMULATE_HEATING = 1.5 ; 模拟发热效果
BLINKING_PATTERN = (0=0|1=0|5=3|10=0|15=3|20=0) ; 呼吸闪烁模式
BLINKING_DURATION = 15 ; 完整呼吸周期

物理投射呼吸氛围灯

ini

[LIGHT_EXTRA_...] ; 多颜色呼吸氛围灯物理投射
LINE_FROM = 0.5, 0.43, -0.53 ; 灯光起始点坐标
LINE_TO = -0.5, 0.43, -0.53 ; 灯光结束点坐标
BIND_TO_EXTRA_A = 1 ; 绑定 Extra A 控制
COLOR_FROM = 55, 0, 0, 0.3 ; 起始颜色与亮度
COLOR_TO = 0, 0, 55, 0.3 ; 结束颜色与亮度
DIFFUSE_CONCENTRATION = 1.25 ; 漫反射集中度
FADE_AT = 150 ; 衰减开始距离
FADE_SMOOTH = 10 ; 衰减平滑度
RANGE = 0.6 ; 灯光作用范围
RANGE_GRADIENT_OFFSET = 0.1 ; 范围渐变偏移
SPOT = 180 ; 聚光角度
SPOT_SHARPNESS = 0.05 ; 聚光边缘锐度
SPECULAR_MULT = 0 ; 镜面反射强度
DIRECTION = 0, -1, 0 ; 光照方向
SELF_LIGHTNING = 1 ; 启用自发光
EXTERIOR_ONLY = 0 ; 不限制外部视角
INTERIOR_ONLY = 0 ; 不限制内部视角
SIMULATE_HEATING = 1.5 ; 模拟发热效果
BLINKING_PATTERN = (0=0|1=0|5=3|10=0|15=3|20=0) ; 呼吸闪烁模式
BLINKING_DURATION = 15 ; 完整呼吸周期

推荐组合写法

ini

[EMISSIVE_EXTRA_A_...] ; 呼吸氛围灯自发光
LINE_FROM = 0.5, 0.43, -0.53 ; 灯光起始点
LINE_TO = -0.5, 0.43, -0.53 ; 灯光结束点
BIND_TO_EXTRA_A = 1 ; 绑定 Extra A
COLOR_FROM = 55, 0, 0, 0.3 ; 起始颜色
COLOR_TO = 0, 0, 55, 0.3 ; 结束颜色
RANGE = 0.6 ; 灯光范围
BLINKING_PATTERN = (0=0|1=0|5=3|10=0|15=3|20=0) ; 呼吸节奏
BLINKING_DURATION = 15 ; 呼吸周期

[LIGHT_EXTRA_...] ; 呼吸氛围灯物理投射
LINE_FROM = 0.5, 0.43, -0.53 ; 灯光起始点
LINE_TO = -0.5, 0.43, -0.53 ; 灯光结束点
BIND_TO_EXTRA_A = 1 ; 绑定 Extra A
COLOR_FROM = 55, 0, 0, 0.3 ; 起始颜色
COLOR_TO = 0, 0, 55, 0.3 ; 结束颜色
RANGE = 0.6 ; 灯光范围
SPOT = 180 ; 全向光
SPECULAR_MULT = 0 ; 不产生明显高光
BLINKING_PATTERN = (0=0|1=0|5=3|10=0|15=3|20=0) ; 呼吸节奏
BLINKING_DURATION = 15 ; 呼吸周期

维修区双色闪烁灯

ini

[EMISSIVE_...] ; 维修区提示灯
INPUT = SPEEDLIMITER ; 限速器开启时触发
NAME = mesh_pit_yellow_light ; 绑定黄色提示灯 Mesh
COLOR = 35, 18, 0, 8 ; 琥珀黄色发光
LAG = 0 ; 无延迟
SIMULATE_HEATING = 0 ; 不模拟灯丝发热
BLINKING_PATTERN = (|0=0|0.05=0|0.1=3|0.15=0|0.2=3|0.25=0|0.3=3|0.35=0|1=0) ; 闪烁节奏
BLINKING_DURATION = 1 ; 1 秒一个循环
CAST_LIGHT = 1 ; 允许投射光
AFFECTS_TRACK = 1 ; 影响赛道表面

急刹闪烁刹车灯

ini

[EMISSIVE_...] ; 急刹闪烁灯
INPUT = BRAKE ; 绑定刹车踏板
INPUT_THRESHOLD = 0.95 ; 刹车超过 95% 才触发
NAME = mesh_brake_flash_light ; 绑定刹车灯 Mesh
COLOR = 210, 1, 1, 2 ; 高亮红色
OFF_COLOR = 0, 0, 0 ; 关闭颜色
BLINK_REPEAT = 1 ; 启用固定闪烁
BLINK_FREQENCY_HZ = 6.4 ; 闪烁频率，官方字段保留拼写
LAG = 0 ; 快速响应
CAST_LIGHT = 0 ; 不额外投射光

呼吸底盘灯

自发光

ini

[EMISSIVE_...] ; 呼吸底盘灯自发光
INPUT = RPM ; 绑定发动机转速
INPUT_MIN = 0 ; 最低转速
INPUT_MAX = 8000 ; 最高转速
INPUT_LUT = (|0=0.2|3000=0.6|7000=1|) ; 转速越高越亮
NAME = mesh_underglow_emissive ; 底盘灯发光 Mesh
COLOR = 0, 0, 30, 3 ; 蓝色发光
OFF_COLOR = 0, 0, 5, 0.2 ; 低亮颜色
BLINKING_PATTERN = (|0=0.3|0.5=1|1=0.3|) ; 呼吸节奏
BLINKING_DURATION = 2 ; 2 秒一个呼吸循环
SIMULATE_HEATING = 0 ; 不模拟灯丝
CAST_LIGHT = 0 ; 不自动投射光

实际照明

ini

[LIGHT_EXTRA_...] ; 呼吸底盘灯实际照明
POSITION = 0, 0.15, 0 ; 底盘中心
DIRECTION = 0, -1, 0 ; 向下照射
COLOR = 0.0, 0.0, 1.0, 2.5 ; 蓝色地面光
RANGE = 3.5 ; 照射范围
SPOT = 180 ; 大范围散射
SPOT_SHARPNESS = 0.05 ; 柔和边缘
AFFECTS_TRACK = 1 ; 照亮地面
AFFECTS_CARS = 0 ; 不照亮其他车辆
SPECULAR_MULT = 0.2 ; 弱高光

⑨ 其他灯光效果

定制刹车碟辉光

作用

给高温刹车盘附近加一圈橙色光。
它不是刹车盘材质本身，而是补光效果。

前刹车碟辉光

ini

[LIGHT_BRAKEDISCS_FRONT] ; 前刹车碟辉光
COLOR = 1, 0.5, 0, 1.2 ; 橙黄色辉光
RANGE = 0.65 ; 光照范围
FADE_AT = 80 ; 开始淡出距离
FADE_SMOOTH = 20 ; 淡出平滑
SPECULAR_MULT = 0.8 ; 高光强度
AFFECTS_TRACK = 0 ; 不照亮赛道
AFFECTS_CARS = 0 ; 不照亮其他车辆

后刹车碟辉光

ini

[LIGHT_BRAKEDISCS_REAR] ; 后刹车碟辉光
COLOR = 1, 0.45, 0, 0.8 ; 后盘较弱橙光
RANGE = 0.5 ; 光照范围
FADE_AT = 80 ; 开始淡出距离
FADE_SMOOTH = 20 ; 淡出平滑
SPECULAR_MULT = 0.6 ; 高光强度
AFFECTS_TRACK = 0 ; 不照亮赛道
AFFECTS_CARS = 0 ; 不照亮其他车辆

警灯频闪

ini

[EMISSIVE_...] ; 红色频闪灯
INPUT = EXTRA_A ; 绑定 Extra A
NAME = mesh_strobe_red ; 红灯 Mesh
COLOR = 50, 0, 0, 8 ; 红色强光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
BLINKING_PATTERN = (|0=1|0.1=0|0.2=1|0.3=0|1=0|) ; 频闪节奏
BLINKING_DURATION = 1 ; 1 秒循环
CAST_LIGHT = 1 ; 投射光

ini

[EMISSIVE_...] ; 蓝色频闪灯
INPUT = EXTRA_A ; 绑定 Extra A
NAME = mesh_strobe_blue ; 蓝灯 Mesh
COLOR = 0, 0, 50, 8 ; 蓝色强光
OFF_COLOR = 0, 0, 0 ; 关闭颜色
BLINKING_PATTERN = (|0=0|0.5=1|0.6=0|0.7=1|1=0|) ; 与红灯错开
BLINKING_DURATION = 1 ; 1 秒循环
CAST_LIGHT = 1 ; 投射光

警灯地面补光

ini

[LIGHT_EXTRA_...] ; 红色警灯补光
INPUT = EXTRA_A ; 绑定 Extra A
POSITION = -0.5, 0.8, 0.5 ; 光源位置
COLOR = 1, 0, 0, 4 ; 红色光
RANGE = 4 ; 照射范围
SPOT = 160 ; 光锥角度
AFFECTS_TRACK = 1 ; 照亮地面
AFFECTS_CARS = 1 ; 照亮车辆

ini

[LIGHT_EXTRA_...] ; 蓝色警灯补光
INPUT = EXTRA_A ; 绑定 Extra A
POSITION = 0.5, 0.8, 0.5 ; 光源位置
COLOR = 0, 0, 1, 4 ; 蓝色光
RANGE = 4 ; 照射范围
SPOT = 160 ; 光锥角度
AFFECTS_TRACK = 1 ; 照亮地面
AFFECTS_CARS = 1 ; 照亮车辆

03. 灯光类 ​

INCLUDE公共库引用 ​

抬头引用模板 ​

全局灯光设置 ​

全局参数样板 ​

② 灯光类型分类 ​

③ CustomEmissive灯光 ​

前灯 ​

刹车灯 ​

倒车灯 ​

转向灯 ​

示宽灯 / 小灯 ​

牌照灯 ​

雾灯 ​

开门灯 ​

内饰灯 ​

仪表指示灯 ​

仪表警告灯 ​

自定义仪表图标 ​

多通道发光 ​

④ 发光漫射 Emissive ​

屏幕漫射样板 ​

灯罩漫射样板 ​

⑤ 物理投光 SelfLight ​

⑥ 灯光物理投射 LIGHT_EXTRA ​

前方补光 ​

内饰补光 ​

⑦ 原生灯光 Section ​

日行灯 ​

普通车灯 ​

近光灯 / 远光灯 ​

刹车灯 / 示宽灯 ​

转向灯 ​

转向辅助灯 / 弯道辅助灯 ​

倒车灯 ​

牌照灯 ​

Extra 自定义发光 ​

车内阅读灯 ​

车门警示灯 ​

领航灯 / 限速器闪烁灯 ​

盲区检测灯 ​

底盘氛围光 ​

仪表背光 / 状态灯 ​

仪表指示灯合集 ​

转向指示灯 ​

远光指示灯 ​

双闪指示灯 ​

手刹指示灯 ​

电瓶指示灯 ​

胎压 / 轮胎指示灯 ​

开门指示灯 ​

安全带灯 ​

仪表警告灯合集 ​

发动机故障灯 ​

车身损伤指示灯 ​

水温警示灯 ​

燃油不足警告灯 ​

机油压力警告灯 ​

ABS / TC / 限速器指示 ​

TC 工作指示 ​

TC OFF 指示灯 ​

ABS 工作指示 ​

ABS 警告灯 ​

限速器状态灯 ​

限速器介入灯 ​

胎压 / 轮胎类灯光输入 ​

低胎压警告灯 ​

轮胎温度警告灯 ​

档位指示灯 ​

自定义输入 ​

强制关闭输入 ​

常用附加参数 ​

Fallback 备用颜色 ​

⑧ 动态灯光效果 ​

流水灯 ​

流水转向灯 ​

开启后变色灯 ​

多颜色呼吸氛围灯 ​

维修区双色闪烁灯 ​

急刹闪烁刹车灯 ​

03. 灯光类

INCLUDE公共库引用

抬头引用模板

全局灯光设置

全局参数样板

② 灯光类型分类

③ CustomEmissive灯光

前灯

刹车灯

倒车灯

转向灯

示宽灯 / 小灯

牌照灯

雾灯

开门灯

内饰灯

仪表指示灯

仪表警告灯

自定义仪表图标

多通道发光

④ 发光漫射 Emissive

屏幕漫射样板

灯罩漫射样板

⑤ 物理投光 SelfLight

⑥ 灯光物理投射 LIGHT_EXTRA

前方补光

内饰补光

⑦ 原生灯光 Section

日行灯

普通车灯

近光灯 / 远光灯

刹车灯 / 示宽灯

转向灯

转向辅助灯 / 弯道辅助灯

倒车灯

牌照灯

Extra 自定义发光

车内阅读灯

车门警示灯

领航灯 / 限速器闪烁灯

盲区检测灯

底盘氛围光

仪表背光 / 状态灯

仪表指示灯合集

转向指示灯

远光指示灯

双闪指示灯

手刹指示灯

电瓶指示灯

胎压 / 轮胎指示灯

开门指示灯

安全带灯

仪表警告灯合集

发动机故障灯

车身损伤指示灯

水温警示灯

燃油不足警告灯

机油压力警告灯

ABS / TC / 限速器指示

TC 工作指示

TC OFF 指示灯

ABS 工作指示

ABS 警告灯

限速器状态灯

限速器介入灯

胎压 / 轮胎类灯光输入

低胎压警告灯

轮胎温度警告灯

档位指示灯

自定义输入

强制关闭输入

常用附加参数

Fallback 备用颜色

⑧ 动态灯光效果

流水灯

流水转向灯

开启后变色灯

多颜色呼吸氛围灯

维修区双色闪烁灯

急刹闪烁刹车灯