Difference between revisions of "Documentation/Engine/Units/accessory chassis data"
< Documentation | Engine | Units
Jump to navigation
Jump to search
(→Attributes) |
AntoninCech (talk | contribs) (→Attributes) |
||
| (10 intermediate revisions by 3 users not shown) | |||
| Line 127: | Line 127: | ||
|array<float> | |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 | + | |''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 | |trailer_mass | ||
| Line 141: | Line 141: | ||
|kerb_weight | |kerb_weight | ||
|array<float> | |array<float> | ||
| − | | | + | |false |
|''For truck usage only.'' Assigns the static weight on each axle. Each array member corresponds to an axle, from front to back. | |''For truck usage only.'' Assigns the static weight on each axle. Each array member corresponds to an axle, from front to back. | ||
|- | |- | ||
| Line 147: | Line 147: | ||
|array<bool> | |array<bool> | ||
|false | |false | ||
| − | |''For truck and trailers.'' When true, the axle can be lifted. Each array member corresponds to an axle, from front to back | + | |''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 | |steerable_axle | ||
| − | |array< | + | |array<token> |
|see description | |see description | ||
| − | |''For truck and trailers.'' | + | |''For truck and trailers.'' Each array member corresponds to an axle, from front to back. By default, first axles on trucks are ''true'', while all others are ''false''. Possible values are: |
| + | *false (non-steerable axle) | ||
| + | *true (steerable wheels on given axle) | ||
| + | *axle (whole axle is rotated when steering, ''axle_model'' must be correctly defined, valid only for trailers). | ||
| + | ''Added in 1.31. Value "axle" was added in 1.50'' | ||
| + | |- | ||
| + | |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 | |weight_distribution | ||
| Line 161: | Line 170: | ||
*trailer (hook, no weight transfer) | *trailer (hook, no weight transfer) | ||
*spreader (removes the pitch degree of freedom, typical of a spreader/booster/stinger on a lowboy configuration) | *spreader (removes the pitch degree of freedom, typical of a spreader/booster/stinger on a lowboy configuration) | ||
| − | ''Added in ATS 1.6.2'' | + | ''Added in ATS 1.6.2.'' |
| + | |- | ||
| + | |axle_model | ||
| + | |array<string> | ||
| + | | | ||
| + | |''For trailer usage only.'' Path to the axle model descriptors (.pmd). ''Added in 1.50.'' | ||
| + | |- | ||
| + | |axle_model_collision | ||
| + | |array<string> | ||
| + | | | ||
| + | |''For trailer usage only.'' Path to the axle model collision descriptors (.pmc). ''Added in 1.50.'' | ||
| + | |- | ||
| + | |axle_model_extended_shadow_texture | ||
| + | |array<string> | ||
| + | | | ||
| + | |''For trailer usage only.'' Texture to be used for the extended (volumetric) shadow underneath each axle. ''Added in 1.50.'' | ||
| + | |- | ||
| + | |axle_model_steer_angle | ||
| + | |unsigned int | ||
| + | | | ||
| + | |''For trailer usage only.'' Overwrites the maximum steering angle of the last steerable axle model. ''Added in 1.50.'' | ||
|- | |- | ||
|cog_cargo_mass_min | |cog_cargo_mass_min | ||
| Line 195: | Line 224: | ||
| | | | ||
|Paths to the special headlight setup if default is not good enough. ''Added in 1.40'' | |Paths 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!''' | ||
|} | |} | ||
Latest revision as of 13:24, 7 May 2024
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. | ||
| 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> | 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 | 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. Trailer functionality is added in ETS2 1.27/ATS 1.6. | |
| steerable_axle | array<token> | see description | For truck and trailers. Each array member corresponds to an axle, from front to back. By default, first axles on trucks are true, while all others are false. Possible values are:
Added in 1.31. Value "axle" was added in 1.50 | |
| 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:
Added in ATS 1.6.2. | |
| axle_model | array<string> | For trailer usage only. Path to the axle model descriptors (.pmd). Added in 1.50. | ||
| axle_model_collision | array<string> | For trailer usage only. Path to the axle model collision descriptors (.pmc). Added in 1.50. | ||
| axle_model_extended_shadow_texture | array<string> | For trailer usage only. Texture to be used for the extended (volumetric) shadow underneath each axle. Added in 1.50. | ||
| axle_model_steer_angle | unsigned int | For trailer usage only. Overwrites the maximum steering angle of the last steerable axle model. Added in 1.50. | ||
| 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 item assigns an FMOD event to a chassis function, using the "sound_name|sound_path" format. Added in 1.39
Expected sound event names are: air_brake, air_cutoff, reverse, lift_axle, hook_attach, hook_detach, and trailer_cables. |
||
| lamp_setup | string | Paths 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! |
