User Tools

Site Tools

Urban Games

modding:vehicletypes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
modding:vehicletypes [2020/06/20 10:52]
yoshi [Events]
modding:vehicletypes [2020/09/05 15:23]
yoshi [Vehicle Types]
Line 2: Line 2:
 Vehicle models in Transport Fever 2 are bound to one of the means of transportation road, rail, water or air. The distinction between the types of vehicles is achieved by specialized metadata entries in the ''.mdl''-files for each type. Vehicle models in Transport Fever 2 are bound to one of the means of transportation road, rail, water or air. The distinction between the types of vehicles is achieved by specialized metadata entries in the ''.mdl''-files for each type.
  
 +
 +<div tip 100%>
 +In the sections below, there are some identifiers that are used frequently:
 +  * **mesh id** is a number that is equivalent to the index of the mesh in the model node tree. Use the <span btn>MODEL</span> button in the [[modding:modeleditor#model_tree|Model Editor]] to find out the correct number in the **ID** column.
 +  * **.msh reference** is a path to a mesh file relative to ''res/models/mesh/'' including the ''.msh'' file ending. The correct reference is listed on the right side of the model node tree in the Model Editor too. 
 +</div>
 ===== Road Vehicles ===== ===== Road Vehicles =====
 Road vehicles are bound to the street network built by the game or the player. They can drive along streets as well as on construction lanes of the right type in stations, depots and similar constructions. Road vehicles are bound to the street network built by the game or the player. They can drive along streets as well as on construction lanes of the right type in stations, depots and similar constructions.
Line 8: Line 14:
   * ''/vehicle/bus''   * ''/vehicle/bus''
   * ''/vehicle/car''   * ''/vehicle/car''
-  * ''/vehicle/tram'' 
   * ''/vehicle/truck''   * ''/vehicle/truck''
 +
 +For trams, see rail vehicles below.
  
 ==== Metadata ==== ==== Metadata ====
Line 52: Line 59:
 Beside the lights, there are further config properties that are used for steering and wheels: Beside the lights, there are further config properties that are used for steering and wheels:
   * ''axles'' is a list of ''.msh'' references pointing to the meshes which are axles that only rotate around the y axis while the vehicle is moving. This is usually used for rear axles.   * ''axles'' is a list of ''.msh'' references pointing to the meshes which are axles that only rotate around the y axis while the vehicle is moving. This is usually used for rear axles.
-  * ''fakeBogies'' is a list of [[:modding:vehicleadvanced#fakebogies|fake bogie]] definitions. Usually road vehicles have at least one positioned approximately in the middle between the steering axis and the first back axis. +  * ''fakeBogies'' is a list of [[modding:vehicleadvancedtopics#fakebogies|fake bogie]] definitions. Usually road vehicles have at least one positioned approximately in the middle between the steering axis and the first back axis. 
   * ''steeringParts'' is a list of mesh ids that are rotating around z axis when the vehicle turns around curves.   * ''steeringParts'' is a list of mesh ids that are rotating around z axis when the vehicle turns around curves.
   * ''wheels'' is a list of ''.msh'' references pointing to the meshes that represent wheels which rotate around z axis in curves and around y axis while the vehicle is rolling. This is usually used for front wheels.   * ''wheels'' is a list of ''.msh'' references pointing to the meshes that represent wheels which rotate around z axis in curves and around y axis while the vehicle is rolling. This is usually used for front wheels.
Line 98: Line 105:
   * ''/vehicle/train'' for motorized rail vehicles   * ''/vehicle/train'' for motorized rail vehicles
   * ''/vehicle/wagon'' for unmotorized rail vehicles   * ''/vehicle/wagon'' for unmotorized rail vehicles
 +  * ''/vehicle/tram'' for trams.
 +
 +Although trams are defined with a ''railVehicle'' metadata block, they run on streets (with tram tracks) instead of train tracks.
  
 ==== Metadata ==== ==== Metadata ====
Line 132: Line 142:
 <span label>2</span> ''innerForwardParts'' is a list of mesh ids that should be only visible if the vehicle is not at the front or back of the whole train consist and driving forward\\ <span label>2</span> ''innerForwardParts'' is a list of mesh ids that should be only visible if the vehicle is not at the front or back of the whole train consist and driving forward\\
 <span label>3</span> ''backForwardParts'' is a list of mesh ids that should be only visible if the vehicle is at the back of the whole train consist and driving forward\\ <span label>3</span> ''backForwardParts'' is a list of mesh ids that should be only visible if the vehicle is at the back of the whole train consist and driving forward\\
-<span label>4</span> ''frontBackwardParts'' is a list of mesh ids that should be only visible if the vehicle is at the front of the whole train consist and driving backward (only if reversible) \\ +<span label>4</span> ''frontBackwardParts'' is a list of mesh ids that should be only visible if the vehicle is at the front of the whole train consist and driving backward (only if consist is reversible) \\ 
-<span label>5</span> ''innerBackwardParts'' is a list of mesh ids that should be only visible if the vehicle is not at the front or back of the whole train consist and driving backward (only if reversible)\\ +<span label>5</span> ''innerBackwardParts'' is a list of mesh ids that should be only visible if the vehicle is not at the front or back of the whole train consist and driving backward (only if consist is reversible)\\ 
-<span label>6</span> ''backBackwardParts'' is a list of mesh ids that should be only visible if the vehicle is at the back of the whole train consist and driving backward (only if reversible)\\+<span label>6</span> ''backBackwardParts'' is a list of mesh ids that should be only visible if the vehicle is at the back of the whole train consist and driving backward (only if consist is reversible)\\
 </div>  </div> 
  
Line 141: Line 151:
 Beside the lights, there are further config properties that are used for axles and the correct rotation of vehicle parts: Beside the lights, there are further config properties that are used for axles and the correct rotation of vehicle parts:
   * ''axles'' is a list of ''.msh'' references pointing to the meshes which are axles that rotate around the y axis while the vehicle is moving. This is usually used for any physical axles.   * ''axles'' is a list of ''.msh'' references pointing to the meshes which are axles that rotate around the y axis while the vehicle is moving. This is usually used for any physical axles.
-  * ''fakeBogies'' is a list of [[:modding:vehicleadvanced#fakebogies|fake bogie]] definitions. Train vehicles with jacobs bogies and other nested constellations might need these. +  * ''fakeBogies'' is a list of [[modding:vehicleadvancedtopics#fakebogies|fake bogie]] definitions. Train vehicles with jacobs bogies and other nested constellations might need these. 
  
 <div tip 100%> <div tip 100%>
Line 182: Line 192:
   * ''close_doors_left'' is triggered before the vehicle leaves a station. It is only triggered for platforms on the left side.   * ''close_doors_left'' is triggered before the vehicle leaves a station. It is only triggered for platforms on the left side.
  
-See [[:modding:vehicleadvanced#animations|advanced vehicle animations]] for more details on animating wheels and doors.+See [[modding:vehicleadvancedtopics#animations|advanced vehicle animations]] for more details on animating wheels and doors.
  
 ==== Multiple Units ==== ==== Multiple Units ====
Line 210: Line 220:
   * ''name'' is the name of the multiple unit that is used in the buy menu. It can be translated in a [[modding:modcomponents#stringslua|strings.lua]] file.   * ''name'' is the name of the multiple unit that is used in the buy menu. It can be translated in a [[modding:modcomponents#stringslua|strings.lua]] file.
   * ''desc'' is the description of the multiple unit used in the buy menu. It can be translated too. The technical data is calculated based on the single vehicles used in the multiple unit.   * ''desc'' is the description of the multiple unit used in the buy menu. It can be translated too. The technical data is calculated based on the single vehicles used in the multiple unit.
-  * ''groupFileName'' is an optional reference to another multiple unit or a model to define this multiple unit as a variant under the other multiple unit / model as main group. See the [[modding:vehicleadvanced#buy_menu_groups|buy menu group explanation]] for further details.+  * ''groupFileName'' is an optional reference to another multiple unit or a model to define this multiple unit as a variant under the other multiple unit / model as main group. See the [[modding:vehicleadvancedtopics#buy_menu_groups|buy menu group explanation]] for further details.
  
  
Line 400: Line 410:
  
 For some purposes, other properties in the ''config'' block are available: For some purposes, other properties in the ''config'' block are available:
-  * ''fakeBogies'' is a list of [[:modding:vehicleadvanced#fakebogies|fake bogie]] definitions. Air vehicles with complicated axle and wheel constellations might need these. +  * ''fakeBogies'' is a list of [[modding:vehicleadvancedtopics#fakebogies|fake bogie]] definitions. Air vehicles with complicated axle and wheel constellations might need these. 
   * ''steeringParts'' is a list of mesh ids that are rotating around z axis when the vehicle turns around curves.   * ''steeringParts'' is a list of mesh ids that are rotating around z axis when the vehicle turns around curves.
  
Line 456: Line 466:
  
 <div page_prev>[[:modding:vehiclebasics|Vehicle Basics]]</div> <div page_prev>[[:modding:vehiclebasics|Vehicle Basics]]</div>
-<div page_next>[[:modding:vehicleadvanced|Vehicle Advanced Topics]]</div>+<div page_next>[[modding:vehicleadvancedtopics|Vehicle Advanced Topics]]</div>
modding/vehicletypes.txt · Last modified: 2024/04/10 15:31 by yoshi