Documentation/Engine/Units/accessory chassis data

From SCS Modding Wiki
< Documentation‎ | Engine‎ | Units
Revision as of 00:59, 10 October 2020 by Smarty (talk | contribs) (Added sounds attribute for 1.39)

Jump to navigation Jump to search

The accessory_chassis_data unit class is used to define the chassis characteristics for the 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/<brand.model>/chassis/*.sii, /def/vehicle/trailer/<trailer_name>/*.sii, and /def/vehicle/ai/<vehicle_name>/chassis.sii.

Attributes

Many common attributes are inherited from accessory_data.

Name Type Default Value Description
detail_model string Path to the detailed mesh model descriptor (.pmd). This is used only for vehicles used by player. Additionally they are used in vehicle previews & browser windows.
model string Path to the model 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<string> Paths to the reduced level-of-detail model descriptors (.pmd), in order of increasing viewing distance (decreasing model complexity).
collision string Path to the collision descriptor (.pmc).
trailer_brace_model string For trailer usage only. Path to the animated landing gear model.
trailer_brace_anim string For trailer usage only. Path to the landing gear animation.
trailer_brace_up_sound 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 Variant to be used from detail_model, model, and lods.
variant_uk token Variant to be used in countries which drive on the left. If unspecified, defaults to the value of variant.
look token Look to be used from detail_model, model, and lods.
shadow_texture string Texture to be used for basic shadow.
shadow_intensity float 1.0 Relative intensity of basic shadow.
extended_shadow_texture string Texture to be used for the extended (volumetric) shadow.
extended_shadow_intensity float 1.0 Relative intensity of the extended (volumetric) shadow.
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.
extended_shadow_shared_model_variant 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 80.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 array<float> 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 (or from back to front in the case of trailers).
trailer_mass float 7000.0 For trailer usage only. Sets the unladen mass of the trailer.
powered_axle array<bool> 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 array<float> For truck usage only. Assigns the static weight on each axle. Each array member corresponds to an axle, from front to back.
liftable_axle array<bool> false For truck and trailers. When true, the axle can be lifted. Each array member corresponds to an axle, from front to back (or from back to front in the case of trailers). Trailer functionality is added in ETS2 1.27/ATS 1.6.
steerable_axle array<bool> see description For truck and trailers. When true, the axle will be steerable. Each array member corresponds to an axle, from front to back (or from back to front in the case of trailers). By default, all wheel_f axles on trucks are true, while all others are false. Added in 1.31.
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<string> Each member assigns an FMOD event to a chassis function, using the "sound_name|sound_path" format. Added in 1.39

Expected event names are: air_brake, air_cutoff, reverse, lift_axle, hook_attach, hook_detach, trailer_cables