Documentation/Engine/Units/accessory wheel data

From SCS Modding Wiki
< Documentation‎ | Engine‎ | Units
Revision as of 02:19, 12 February 2017 by Smarty (talk | contribs) (First draft. Missing some default values and descriptions for inner width/radius.)

(diff) ← Older revision | Approved revision (diff) | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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