Games/ETS2/Modding guides/1.40

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 Units documentation page.

Recommendations

• When basing your model on the original ones, add to your mod also ALL 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 ALL 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 HIGHLY RECOMMENDED 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

Light

huge amount of mess: materials, shaders, map, vehicles, lamp logic, rendering, weather data .. :)

TBA

Weather

Weather system was changed to more generic one. Elevation ranges of sun profiles might be any real value now (not just 5 degree grid), transition now can mix up to 4 textures on sky and can happen anytime - so no longer locked weather because of sky textures in specific times. Also, thanks to unlimited transition, there is no need for various climates and weathers to meet in any evelation point.

Climate profile can now specify usage of skyboxes of different climate (attribute copy) with few tweaks (weights, temperatures). Copied climates are shown and can be edited in weather editor, but won't be saved.

Sun profile has few new attributes. Attribute stability defines chance of locking sky index for following sun profile (0.0 = completely random, 1.0 = sky index stays if possible).

Few color attributes have been changed from array to float3 values with names. They all had _hdr_coef postfix in names. List of new names ambient, diffuse, specular, sky_color, sun_color, fog_color, fog_color2.

osolete attributes eye_adaptation_speed is split to dark_adaptation_speed and bright_adaptation_speed SIMPLE_ATTR_UINT_ARRAY(bloom_resizing_steps, NULL), SIMPLE_ATTR_UINT_ARRAY(bloom_filter_radius, NULL), SIMPLE_ATTR_FLOAT3_ARRAY(bloom_minimal_color, NULL), SIMPLE_ATTR_FLOAT3_ARRAY(bloom_half_intensity_color, NULL), SIMPLE_ATTR_FLOAT3_ARRAY(scene_multiplier, NULL), SIMPLE_ATTR_FLOAT3_ARRAY(bloom_multiplier, NULL), SIMPLE_ATTR_FLOAT_ARRAY(target_white, NULL), SIMPLE_ATTR_FLOAT_ARRAY(sunshaft_strength, NULL),

The game can convert most of those attributes on its side for now but this support will be removed in future.

Sound

There is new layer for map-based sound editation. It is accessed by "-edit -sound" commandline params which open map editor in sound editation mode, rest of the map items are inaccessible (sound items are inaccessible in regular editor mode). There can be defined sound areas either for reverbs or ambinents and also put specific sound sources with some conditions.

TBA

Map

All filling stations totems are now dynamic signs with prices taken from pre-defined strings.

New editor features:

• Road edge overrides
• Lasso selection
• Snap mode for all collisions
• Tags in content browser
• Camera snap to ground options: Cabin view (2.5 m), regular height (8.5 m), extreme height (11.5 m)
• Allow using a comma for decimal points in text inputs

TBA

Vehicles

Engine brake can control retarder now. There is array auxiliary_brakes in accessory_engine_data units and works in similar way as same-named array in accessory_transmission_data. The only difference is ordering - engines auxiliary brake triplet is in order [engine_brake_strength, downshift, retarder_strength].

TBA