Changes

Jump to navigation Jump to search

Documentation/Engine/Units/accessory chassis data

278 bytes added, 22:07, 22 January 2023
m
Attributes
The '''accessory_chassis_data''' unit class is used to define the chassis characteristics for the [[Documentation/Engine/Game_data/Player_trucks_definitions|player's vehicle]] including axle weights, extended shadow parameters, and fluid capacities. It is also used to define chassis characteristics of trailers and AI vehicles. Units of this type are usually defined in '''/def/vehicle/truck/<makebrand.model>/chassis/*.sii''', '''/def/vehicle/trailer/<trailer_name>/*.sii''', and '''/def/vehicle/ai/<vehicle_name>/chassis.sii.
== Attributes ==
|string
|
|Path to the high level-of-detail detailed meshmodel descriptor (.pmd). This is generally unused, but can be used only for fine detail or &lsquo;expensive&rsquo; shader effects that vehicles used by player. Additionally they are only visible very close to the used in vehiclepreviews & browser windows.
|-
|model
|string
|
|Path to the standard level-of-detail meshmodel descriptor (.pmd). If only a single LOD is used, it should be set up as '''model''', and the other attributes (detail_model, lods) should not be defined.
|-
|lods
|array&lt;string array&gt;
|
|Paths to the reduced level-of-detail meshesmodel descriptors (.pmd), in order of increasing viewing distance (decreasing model complexity).
|-
|collision
|string
|
|Path to the appropriate collision descriptor (.pmc) model.
|-
|trailer_brace_model
|string
|
|''For trailer usage only.'' Path to the sound to be played when retracting landing gear.''Default value changed to blank (no sound) in 1.35.''
|-
|trailer_brace_down_sound
|string
|
|''For trailer usage only.'' Path to the sound to be played when extending landing gear.''Default value changed to blank (no sound) in 1.35.''
|-
|variant
|token
|default
|Variant to be used from '''detail_model''', '''model''', and '''lods'''.
|-
|look
|token
|default
|Look to be used from '''detail_model''', '''model''', and '''lods'''.
|-
|extended_shadow_fadeout_start
|float
|0.0
|Sets the distance in meters from the fakeshadow surface to begin fading the extended shadow.
|-
|extended_shadow_fadeout_length
|float
|1.0
|Sets the length in meters over which to fade out the extended shadow.
|-
|token
|
|If provided, specified variant of model will be used to draw the shared shadows.
|-
|ui_shadow
|string
|
|Path to the model descriptor (.pmd) for the UI shadow (used for the truck/trailer browser, thumbnail generation, etc).
|-
|tank_size
|float
|0.0
|Fuel tank size in liters.
|-
|adblue_tank_size
|float
|5080.0
|AdBlue/DEF tank size in liters.
|-
|air_tank_pressure
|float
|10.0
|Nominal air brake reservoir pressure in bar. ''Added in ETS2 1.27/ATS 1.6.''
|-
|nominal_voltage
|float
|24.0
|Nominal battery voltage. ''Added in 1.36''
|-
|residual_travel
|float_arrayarray&lt;float&gt;
|
|''For trucks and trailers.'' The limit of upwards and downwards travel in meters for each axle. Each array member corresponds to an axle, from front to back.
|trailer_mass
|float
|7000.0
|''For trailer usage only.'' Sets the unladen mass of the trailer.
|-
|powered_axle
|bool_arrayarray&lt;bool&gt;
|
|''For truck usage only.'' When true, motive torque will be applied on the axle. Each array member corresponds to an axle, from front to back.
|-
|kerb_weight
|float_arrayarray&lt;float&gt;|false
|''For truck usage only.'' Assigns the static weight on each axle. Each array member corresponds to an axle, from front to back.
|-
|liftable_axle
|bool_arrayarray&lt;bool&gt;|false|''For truck and trailers.'' When true, the axle can be lifted. Each array member corresponds to an axle, from front to back. ''Trailer functionality is added in ETS2 1.27/ATS 1.6.''|-|steerable_axle|array&lt;bool&gt;|see description|''For truck and trailers.'' When true, the axle will be steerable. Each array member corresponds to an axle, from front to back. By default, first axles on trucks are ''true'', while all others are ''false''. ''Added in 1.31.''|-|steerable_lifted_axle|bool|false|''For truck and trailers.'' When true, lifted steerable axles will react to steering. Otherwise they line themselves with chassis once lifted. ''Added in 1.44.''|-|weight_distribution|enum|semitrailer|''For trailer usage only.'' Determines how forces are transferred between the trailer and its connected vehicle(s). Possible values are:*semitrailer (fifth wheel, part of trailer weight transferred)*trailer (hook, no weight transfer)*spreader (removes the pitch degree of freedom, typical of a spreader/booster/stinger on a lowboy configuration)''Added in ATS 1.6.2''|-|cog_cargo_mass_min|float|0|Lowest cargo mass at which to offset the center of gravity. ''Added in 1.35.''|-|cog_cargo_mass_max|float|20000|Highest cargo mass at which to offset the center of gravity. ''Added in 1.35.''|-|cog_cargo_offset_min|float3|(0,0,0)|Distance to offset the center of gravity at '''cog_cargo_mass_min'''. ''Added in 1.35.''|-|cog_cargo_offset_max|float3|(0,1,0)|Distance to offset the center of gravity at '''cog_cargo_mass_max'''. ''Added in 1.35.''|-|sounds|array&lt;string&gt;||Each item assigns an FMOD event to a chassis function, using the "''<nowiki>sound_name|sound_path</nowiki>''" [[Games/ETS2/Modding_guides/1.39#Accessories|format]]. ''Added in 1.39'' Expected sound event names are: air_brake, air_cutoff, reverse, lift_axle, hook_attach, hook_detach, and trailer_cables.
|
|''For truck usage only.'' When true, the axle can be lifted. Each array member corresponds to an axle, from front to back.
|-
|powered_wheellamp_setup|bool_arraystring
|
|Deprecated – use powered_axle insteadPaths to the special headlight setup if default is not good enough.''Added in 1.40'''''Content of vehicle_lamp_setup unit is an experimental feature and will most probably change in the future!'''
|}
 
== Raw Unit Definition ==
<pre style="max-height:300px;overflow:auto"> "accessory_chassis_data":{
"superclass":"accessory_data",
"attrs":{
"name":{
"type": "string"
},
"short_name":{
"type": "string"
},
"icon":{
"type": "string"
},
"info":{
"type": "string_array"
},
"price":{
"type": "s64"
},
"unlock":{
"type": "uint"
},
"suitable_for":{
"type": "string_array"
},
"conflict_with":{
"type": "string_array"
},
"defaults":{
"type": "string_array"
},
"require":{
"type": "token_array"
},
"detail_model":{
"type": "string"
},
"model":{
"type": "string"
},
"lods":{
"type": "string_array"
},
"collision":{
"type": "string"
},
"trailer_brace_model":{
"type": "string"
},
"trailer_brace_anim":{
"type": "string"
},
"trailer_brace_up_sound":{
"type": "string"
},
"trailer_brace_down_sound":{
"type": "string"
},
"variant":{
"type": "token"
},
"variant_uk":{
"type": "token"
},
"look":{
"type": "token"
},
"shadow_texture":{
"type": "string"
},
"shadow_intensity":{
"type": "float"
},
"extended_shadow_texture":{
"type": "string"
},
"extended_shadow_intensity":{
"type": "float"
},
"extended_shadow_fadeout_start":{
"type": "float"
},
"extended_shadow_fadeout_length":{
"type": "float"
},
"extended_shadow_shared_model_variant":{
"type": "token"
},
"ui_shadow":{
"type": "string"
},
"tank_size":{
"type": "float"
},
"adblue_tank_size":{
"type": "float"
},
"residual_travel":{
"type": "float_array"
},
"trailer_mass":{
"type": "float"
},
"powered_axle":{
"type": "bool_array"
},
"kerb_weight":{
"type": "float_array"
},
"liftable_axle":{
"type": "bool_array"
},
"powered_wheel":{
"type": "bool_array"
}
}
},</pre>
68
edits

Navigation menu