View source for Games/ETS2/Modding guides/1.51

= Introduction =

The following page contains modding guidelines for the new update of the game.

To better understand changes in units it is recommended to check [[Documentation/Engine/Units|Units documentation]] page.

= Recommendations =
* When basing your model on the original ones, add to your mod also <strong>ALL</strong> original /automat/ files used by it. The names of the files are generated as CityHash64 hash of theirs content so whenever we change the parameters of the material in any way, a different file will be used to store them and the original file might cease to exist if there is no other model utilizing the original parameters.
* When modifying original models, always include <strong>ALL</strong> components of the model (pmg+pmd) instead of just those you changed. Otherwise you risk crash if we change the model.
* As always when adding new objects to files which support multi-file approach (e.g. road_look.sii) it is <strong>HIGHLY RECOMMENDED</strong> to use suffix or prefix in the name to avoid conflicts with new objects we are adding in patches. Otherwise you might have to use the batch renaming functionality (see Batch renaming) to fix the conflicts when new patch appears.

= How to convert map =

* Load map
* Do rebuild (F8)
* Save map

= Changes & New Features =
== Game Data ==
=== Map Data ===
==== Map area item ====

Before <strong>Map area</strong> items only supported 4 colors which were hardcoded in the game. As of this version they were moved to <code>map_data.sii</code>.
If your mod modifies <code>map_data.sii</code> make sure to update it so that it includes the 4 base colors.

To add a new color add these 3 variables to the file <strong>after the colors the base game uses</strong>:
 <nowiki>
map_area_color_name[]: "DisplayNameOfMyColor"
map_area_color[]: 0xFF707070
map_area_discovered_color[]: 0xFF20bcff</nowiki>

<code>map_area_color_name</code> is only used in-editor.

<code>map_area_color</code> is the color you see when the item hasn't been discovered yet.

<code>map_area_discovered_color</code> is the color you see once you have discovered the item.

The colors are specified as <code>0xFFBBGGRR</code> where <code>FF</code> can be any value, <code>BB</code> is the blue channel, <code>GG</code> is the green channel, <code>RR</code> is the red channel all being hexadecimal.

If there is a mismatch of <code>map_area_*</code> entries or the color index the game is looking for doesn't exist, the game defaults to pure white. 

<strong>Do not reorder or delete any existing colors</strong> as the order they are specified in is used to identify them!

TODO

== Vehicle Data ==

TODO