Difference between revisions of "Documentation/Engine/Units/accessory wheel data"

From SCS Modding Wiki
Jump to navigation Jump to search
(First draft. Missing some default values and descriptions for inner width/radius.)
 
(Using new 'UnitDef' template)
Line 122: Line 122:
 
*[[Documentation/Engine/Units/accessory_rim_data|accessory_rim_data]]
 
*[[Documentation/Engine/Units/accessory_rim_data|accessory_rim_data]]
  
== Raw Unit Definition ==
+
{{UnitDef|def=<nowiki>  "accessory_wheel_data":{
<pre style="max-height:300px;overflow:auto">  "accessory_wheel_data":{
 
 
   "superclass":"accessory_data",
 
   "superclass":"accessory_data",
 
   "attrs":{
 
   "attrs":{
Line 184: Line 183:
 
     }
 
     }
 
   }
 
   }
   },</pre>
+
   },</nowiki>}}

Revision as of 19:08, 17 February 2017

The accessory_wheel_data unit class is used to define wheels for most vehicle types, and tires for the 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 accessory_data. Required attributes are bolded.

Name 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 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 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 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 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


Raw Unit Definition

  "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"
    }
   }
  },