Changes

Jump to navigation Jump to search

Documentation/Engine/Units/trailer def

371 bytes added, 21:22, 7 October 2019
Attributes: Corrected mass ratio attribute
{{Note| WIP — [[User:Smarty|Smarty]] ([[User talk:Smarty|talk]]) 23:22, 21 June 2017 (CEST)}}
 
The '''trailer_def''' unit class acts as an intermediary between [[Documentation/Engine/Units/cargo_data|cargo_data]] and [[Documentation/Engine/Units/trailer|trailer]] units. Units of this type are usually defined in '''/def/cargo/<cargo_name>/<trailer_name>.sii''', corresponding to '''def/cargo/<cargo_name>.sii'''. They define which trailer configuration to enable for the cargo, the cargo's mass for that trailer configuration, how that mass is distributed/placed on the trailer and its slave units, and where the configuration is permitted.
|string
|
|The unit name of the '''trailer''' unit to be enabled for the cargo. This attribute can safely refer to units which aren't present.(Only for legacy usage when defined in /def/cargo/<cargo_name>/)
|-
|massgross_trailer_weight_limit
|float
|
|The mass maximum technical or logical combined weight of the trailer and its cargo for this trailer configuration in kilograms (kgtake into account bridge formula, and other similar rules).
|-
|volume_factorchassis_mass
|float
|1.0|The amount mass of cargo relative to what the cargo definition is nominally based on. This allows the game economy to scale the pay per distance for trailers of different sizes hauling the same cargo. ''Added trailer chassis in 1kg.28.''{{Note|For example, if -|body_mass|float||The mass of the cargo definition is nominally based on a 53ft trailer, the volume_factor for a 40ft trailer might be approximately 0.75 (40÷53)body in kg.}}
|-
|length
|float
|0
|The length of the trailer combination in meters. When generating a job this is compared against the '''allowed_trailer_length''' of the source and destination depot [[Documentation/Engine/Units/prefab_data|prefabs]] to determine whether this trailer_def is suitable for the job.
|-
|axles
|uint
|0|The approximate length number of axles in the trailer combination in meters. When generating a job this , which is compared checked against country_data&rarr;mass_limit_per_axle_count to determine the '''allowed_trailer_length''' allowable gross weight.|-|volume|float||The interior volume of the source and destination depot [[Documentationtrailer body in m<sup>3</Engine/Units/prefab_datasup>.|-|body_type|token||prefabs]] to determine whether this trailer_def is suitable for Sets the body type of the job. The valid range is [0trailer configuration, 255]. If set which determines which cargoes are allowed to 0, no restrictions are applied. ''Added in 1.28be carried.''
|-
|countrychain_type|array&lt;token&gt;
|
|Each member is a <!--[[Documentation/Engine/Units/country_data|country]]-->country (state in ATS) where this trailer_def will be suitable for generated jobs. Both Sets the origin and destination trailer chain type of a job must be in the ''country'' array for the trailer_def to be suitable for it. If unset, then the trailer_def is suitable in all countries. ''Added in 1.28trailer configuration.''
|-
|cog_offsetcountry_validity|array&lt;float3token&gt;
|
|Each member defines is a <!--[[Documentation/Engine/Units/country_data|country]]-->country (or a state in ATS) where this trailer_def will be suitable for generated jobs. Both the offset of the cargo center origin and destination of gravity from the calculated value for each trailer a job must be in the trailer configuration, starting with the ''mastercountry'' trailer and iterating through array for the ''slave'' trailerstrailer_def to be suitable for it. (XIf unset, Ythen the trailer_def is suitable in all countries. For example, Z) corresponds the following would be limited to lateral, vertical, only Nevada and longitudinal offsets respectively.Arizona:<pre>country[]: arizonacountry[]: nevada</pre>
|-
|cargo_mass_ratio'''mass_ratio'''
|array&lt;float&gt;
|<pre>cargo_mass_ratio:&nbsp;1cargo_mass_ratio[0]:&nbsp;1</pre>|Each member defines how much of the cargo mass and forces are borne by each trailer in the trailer configuration, starting with the ''master'' trailer and iterating through the ''slave'' trailers. These must add up to 1.
|}
 
== World of Trucks Compatibility ==
World of Trucks jobs will make use of mod trailers if the following conditions are satisfied:
*The '''mass''' is equal to, or greater than the job's cargo mass.
*The '''length''' is compatible with the source and destination prefabs.
*The configuration is valid for the source and destination '''country'''.
*The trailer count is equal to the trailer count of the job (i.e. A multipivot trailer configuration won't be selected for a single-trailer job).
== Related Units ==
*[[Documentation/Engine/Units/cargo_data|cargo_data]]
*[[Documentation/Engine/Units/trailer|trailer]]
309
edits

Navigation menu