309
edits
Changes
Jump to navigation
Jump to search
First draft. Missing some default values and descriptions for inner width/radius.
The '''accessory_wheel_data''' unit class is used to define wheels for most vehicle types, and tires for the [[Documentation/Engine/Game_data/Player_trucks_definitions|player's vehicle]]. It defines the path to the visible model, the look used, whether it is paintable, and some physical characteristics of the tire (for playable vehicles). Units of this type are typically found in:
* '''/def/vehicle/ai_wheel/*.sii''' (wheels used for AI vehicles)
* '''/def/vehicle/f_tire/*.sii''' (front tires for playable trucks)
* '''/def/vehicle/f_wheel/*.sii''' (front wheels for AI trucks)
* '''/def/vehicle/r_tire/*.sii''' (rear tires for playable trucks)
* '''/def/vehicle/r_wheel/*.sii''' (rear wheels for AI trucks)
* '''/def/vehicle/tr_wheel/*.sii''' (wheels for trailers)
== Attributes ==
Many common attributes are inherited from [[Documentation/Engine/Units/accessory_data|'''accessory_data''']]. Required attributes are '''bolded'''.
{|class="wikitable"
!Name
![[Documentation/Engine/Units#Attribute_types|Type]]
!Default Value
!Description
|-
|'''model'''
|string
|
|Path to the descriptor (.pmd) of a valid wheel model. Valid wheel models have ''left'' and ''right'' variants and a ''bb'' model locator which sets the rolling/collision radius.
|-
|look
|token
|default
|Selects the look to be used.
|-
|paintable
|boolean
|false
|When true, enables the color picker on the garage, truck browser, etc screens. The paint color is applied to pieces of the '''model''' whose materials use the [[Documentation/Tools/SCS_Blender_Tools/Supported_shaders#paint|paint]] flavor.
{{Note|Unlike other accessories, wheel accessories do not inherit the paint color(s) of the vehicle they belong to.}}
|-
|default_color
|float3
|(1.0, 1.0, 1.0)
|Sets the default color for the wheel accessory.
|-
|inner_width
|float
|
|
|-
|inner_radius
|float
|
|
|-
|roll_resistance
|float
|
|Tire rolling resistance in kg/t (EU Tyre Labelling Regulation 1222/2009)
|-
|wet_grip
|float
|
|Tire wet grip performance (EU Tyre Labelling Regulation 1222/2009)
|-
|noise_volume
|float
|
|Tire rolling noise in dB (EU Tyre Labelling Regulation 1222/2009)
|}
== EU Tire Label Letter Grades for Truck and Bus (C3) Tires ==
''From [http://www.etrma.org/uploads/Modules/Documentsmanager/2012-07-05--industry-guideline-on-tyre-labelling-(vers4).pdf ETRMA Industry Guidelines Version 4] (5 July, 2012)''
Where numerical data is not available, the following tables are useful to translate letter grades from tire labels to the values used for '''roll_resistance''' and '''wet_grip'''.
=== Rolling Resistance ===
{|class="wikitable"
!Class
!RRC in kg/t
|-
|A
|RRC ≤ 4.0
|-
|B
|4.1 ≤ RRC ≤ 5.0
|-
|C
|5.1 ≤ RRC ≤ 6.0
|-
|D
|6.1 ≤ RRC ≤ 7.0
|-
|E
|7.1 ≤ RRC ≤ 8.0
|-
|F
|RRC ≥ 8.1
|-
|G
|Empty
|}
=== Wet Grip ===
{|class="wikitable"
!Class
!''G''
|-
|A
|''G'' ≥ 1.25
|-
|B
|1.10 ≤ ''G'' ≤ 1.24
|-
|C
|0.95 ≤ ''G'' ≤ 1.09
|-
|D
|0.80 ≤ ''G'' ≤ 0.94
|-
|E
|0.65 ≤ ''G'' ≤ 0.79
|-
|F
|''G'' ≤ 0.64
|-
|G
|Empty
|}
== Related Classes ==
*[[Documentation/Engine/Units/accessory_rim_data|accessory_rim_data]]
== Raw Unit Definition ==
<pre style="max-height:300px;overflow:auto"> "accessory_wheel_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"
},
"model":{
"type": "string"
},
"look":{
"type": "token"
},
"paintable":{
"type": "bool"
},
"default_color":{
"type": "float3"
},
"inner_width":{
"type": "float"
},
"inner_radius":{
"type": "float"
},
"roll_resistance":{
"type": "float"
},
"wet_grip":{
"type": "float"
},
"noise_volume":{
"type": "float"
}
}
},</pre>
* '''/def/vehicle/ai_wheel/*.sii''' (wheels used for AI vehicles)
* '''/def/vehicle/f_tire/*.sii''' (front tires for playable trucks)
* '''/def/vehicle/f_wheel/*.sii''' (front wheels for AI trucks)
* '''/def/vehicle/r_tire/*.sii''' (rear tires for playable trucks)
* '''/def/vehicle/r_wheel/*.sii''' (rear wheels for AI trucks)
* '''/def/vehicle/tr_wheel/*.sii''' (wheels for trailers)
== Attributes ==
Many common attributes are inherited from [[Documentation/Engine/Units/accessory_data|'''accessory_data''']]. Required attributes are '''bolded'''.
{|class="wikitable"
!Name
![[Documentation/Engine/Units#Attribute_types|Type]]
!Default Value
!Description
|-
|'''model'''
|string
|
|Path to the descriptor (.pmd) of a valid wheel model. Valid wheel models have ''left'' and ''right'' variants and a ''bb'' model locator which sets the rolling/collision radius.
|-
|look
|token
|default
|Selects the look to be used.
|-
|paintable
|boolean
|false
|When true, enables the color picker on the garage, truck browser, etc screens. The paint color is applied to pieces of the '''model''' whose materials use the [[Documentation/Tools/SCS_Blender_Tools/Supported_shaders#paint|paint]] flavor.
{{Note|Unlike other accessories, wheel accessories do not inherit the paint color(s) of the vehicle they belong to.}}
|-
|default_color
|float3
|(1.0, 1.0, 1.0)
|Sets the default color for the wheel accessory.
|-
|inner_width
|float
|
|
|-
|inner_radius
|float
|
|
|-
|roll_resistance
|float
|
|Tire rolling resistance in kg/t (EU Tyre Labelling Regulation 1222/2009)
|-
|wet_grip
|float
|
|Tire wet grip performance (EU Tyre Labelling Regulation 1222/2009)
|-
|noise_volume
|float
|
|Tire rolling noise in dB (EU Tyre Labelling Regulation 1222/2009)
|}
== EU Tire Label Letter Grades for Truck and Bus (C3) Tires ==
''From [http://www.etrma.org/uploads/Modules/Documentsmanager/2012-07-05--industry-guideline-on-tyre-labelling-(vers4).pdf ETRMA Industry Guidelines Version 4] (5 July, 2012)''
Where numerical data is not available, the following tables are useful to translate letter grades from tire labels to the values used for '''roll_resistance''' and '''wet_grip'''.
=== Rolling Resistance ===
{|class="wikitable"
!Class
!RRC in kg/t
|-
|A
|RRC ≤ 4.0
|-
|B
|4.1 ≤ RRC ≤ 5.0
|-
|C
|5.1 ≤ RRC ≤ 6.0
|-
|D
|6.1 ≤ RRC ≤ 7.0
|-
|E
|7.1 ≤ RRC ≤ 8.0
|-
|F
|RRC ≥ 8.1
|-
|G
|Empty
|}
=== Wet Grip ===
{|class="wikitable"
!Class
!''G''
|-
|A
|''G'' ≥ 1.25
|-
|B
|1.10 ≤ ''G'' ≤ 1.24
|-
|C
|0.95 ≤ ''G'' ≤ 1.09
|-
|D
|0.80 ≤ ''G'' ≤ 0.94
|-
|E
|0.65 ≤ ''G'' ≤ 0.79
|-
|F
|''G'' ≤ 0.64
|-
|G
|Empty
|}
== Related Classes ==
*[[Documentation/Engine/Units/accessory_rim_data|accessory_rim_data]]
== Raw Unit Definition ==
<pre style="max-height:300px;overflow:auto"> "accessory_wheel_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"
},
"model":{
"type": "string"
},
"look":{
"type": "token"
},
"paintable":{
"type": "bool"
},
"default_color":{
"type": "float3"
},
"inner_width":{
"type": "float"
},
"inner_radius":{
"type": "float"
},
"roll_resistance":{
"type": "float"
},
"wet_grip":{
"type": "float"
},
"noise_volume":{
"type": "float"
}
}
},</pre>
