Difference between revisions of "Games/ETS2/Modding guides/1.32"
(→Flares data) |
(→Trailer def) |
||
(35 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{Tip|Be aware that page is not final. Thus do not fully rely on written subjects, until this message is here!}} | ||
+ | |||
+ | |||
= Introduction = | = Introduction = | ||
Line 12: | Line 15: | ||
= How to convert map = | = How to convert map = | ||
− | * | + | * Ensure that <strong>ALL</strong> map files are updated to version compatible with 1.31 update by resaving them in 1.31 version. Otherwise you might be unable to load the map in 1.32 editor. |
− | |||
* Load map | * Load map | ||
+ | * If the editor shows a warning dialog about items referencing obsolete TERRAIN ONLY road flag, you <strong>MUST</strong> remove or replace all those items in the map before saving the map. Otherwise the editor might crash when loading the resaved map. | ||
+ | * Run prefab node corrections (F3 - "Prefab node correction") | ||
+ | * Save map | ||
* Do rebuild (F8) | * Do rebuild (F8) | ||
* Save map | * Save map | ||
− | * | + | * Run shoulder check from "Map\Validate road shoulders" This will generate list of all items which could cause issues with random events (mostly models clipping through). You have following options: |
+ | ** Adjust the items so they do not cause issues by moving them or removing them | ||
+ | ** Mark the related road as having blocked shoulder ("Shoulder blocked" checkboxes in Road item properties) to prevent generation of events. | ||
+ | ** If you do not care about the issues, you can ignore the item. | ||
+ | * Save map | ||
= Changes = | = Changes = | ||
Line 23: | Line 32: | ||
== Map format changes == | == Map format changes == | ||
− | + | TBA | |
− | == | + | == Game data == |
− | + | * Added '''blinker_auto_off_trigger''' attribute defining angle below which blinker auto disable is performed previously. | |
− | + | == Economy data == | |
− | + | * Added '''cargo_damage_cost''' attribute defining how much money player has to pay to for 1% of the damage. | |
− | + | * Added '''cargo_damage_cost_factor''' attribute defining factor damage penalty is multiplied with every 1% of the damage. | |
− | + | * Added '''exp_park_load_bonus''' attribute defining how big XP bonus player gets for parking trailer during loading of the job. | |
− | + | * Added '''revenue_per_km_base''' attribute defining base revenue per km for the ai drivers (has to be proportional to regular cargo fees). | |
− | + | * Added '''revenue_coef_per_km''' attribute defining salary coefficient per km for the freight market and online jobs. | |
+ | * Added '''cargo_market_revenue_coef_per_km''' attribute defining salary coefficient per km for the cargo market jobs. | ||
+ | * Added '''driver_revenue_coef_per_km''' attribute defining salary coefficient for ai drivers and players quick jobs. | ||
+ | * Added '''driver_cargo_market_revenue_coef_per_km''' attribute defining salary coefficient for ai drivers cargo market jobs. | ||
− | + | * Removed '''revenue_per_km'''. | |
+ | * Removed '''driver_revenue_per_km'''. | ||
+ | * Removed '''trailer_damage_cost'''. | ||
+ | * Removed '''trailer_damage_cost_factor'''. | ||
+ | * Removed '''brands''', game will now collect truck and trailer brands on startup from <code>/def/vehicle/truck_dealer</code> and <code>/def/vehicle/trailer_dealer</code> directories. Each directory inside that can be interpreted as token is a new brand. | ||
− | + | == Country data == | |
− | + | Country data has a new attribute called '''mass_limit_per_axle_count'''. It defines GVW (gross vehicle weight) - maximum allowed mass limit (in kilograms, kg) of the whole vehicle set (truck + trailer(s) + cargo) with the given amount of axles (total truck + trailer(s)) in the the country. Empty array impose no limit. | |
− | + | The first element is describing mass limit for vehicle with 2 axles, second for 3 axles etc. If vehicle has more axles than defined last entry will be used as limit. | |
− | + | <pre> | |
+ | country_data: country.data.uk | ||
+ | { | ||
+ | # [...] | ||
− | + | mass_limit_per_axle_count[]: 18000 # 2-axle vehicle | |
+ | mass_limit_per_axle_count[]: 26000 # 3-axle vehicle | ||
+ | mass_limit_per_axle_count[]: 38000 # 4-axle vehicle | ||
+ | mass_limit_per_axle_count[]: 40000 # 5-axle vehicle | ||
+ | mass_limit_per_axle_count[]: 44000 # 6 and more-axle vehicle | ||
+ | } | ||
</pre> | </pre> | ||
− | == | + | == Cargo generator == |
The whole cargo generator was dramatically changed since previous versions: | The whole cargo generator was dramatically changed since previous versions: | ||
Line 58: | Line 82: | ||
=== Cargo data === | === Cargo data === | ||
− | |||
Attributes '''price_coef''' (float), '''mass''' (float array, per trailer) and '''cog_height_offset''' (float array, per trailer) has been. Attribute array '''trailers''' remain only for compatibility of some cargoes. | Attributes '''price_coef''' (float), '''mass''' (float array, per trailer) and '''cog_height_offset''' (float array, per trailer) has been. Attribute array '''trailers''' remain only for compatibility of some cargoes. | ||
Line 70: | Line 93: | ||
=== Trailer def === | === Trailer def === | ||
− | |||
Structure '''trailer_def''' was greatly improved and redesigned as its core of the economy. Old system with list of trailers for given cargo is used for remaining old trailers only (using cargo folder placement with filled '''trailer''' link and fake underscored trailer '''body_type'''s). | Structure '''trailer_def''' was greatly improved and redesigned as its core of the economy. Old system with list of trailers for given cargo is used for remaining old trailers only (using cargo folder placement with filled '''trailer''' link and fake underscored trailer '''body_type'''s). | ||
Line 90: | Line 112: | ||
In addition, there are also cog placement parameters - unlike older mechanics right now its plain cargo cog offset in meters (before height was halved due to historical reasons). | In addition, there are also cog placement parameters - unlike older mechanics right now its plain cargo cog offset in meters (before height was halved due to historical reasons). | ||
− | + | === Body types === | |
Body type defines which cargo can be transported with trailer and is binded to economy trough cargo definition with new array attribute '''body_types''' in cargo data. | Body type defines which cargo can be transported with trailer and is binded to economy trough cargo definition with new array attribute '''body_types''' in cargo data. | ||
Line 103: | Line 125: | ||
That said one can still use custom token for body type, but do not forget to define new cargo data for it. In the future updates, however, predefined list will most probably grow with new set of body types. | That said one can still use custom token for body type, but do not forget to define new cargo data for it. In the future updates, however, predefined list will most probably grow with new set of body types. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Vehicles data == | == Vehicles data == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Truck data === | === Truck data === | ||
Line 176: | Line 143: | ||
=== Trailer data === | === Trailer data === | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==== Accessory trailer data ==== | ==== Accessory trailer data ==== | ||
− | The new unit | + | The new unit describing series of the trailer. Very similar to well known '''accessory_truck_data'''. |
The attributes of the unit are: | The attributes of the unit are: | ||
Line 205: | Line 157: | ||
==== Accessory trailer body data ==== | ==== Accessory trailer body data ==== | ||
− | New accessory type defining trailer body | + | New accessory type defining trailer body. |
Required attributes are: | Required attributes are: | ||
Line 224: | Line 176: | ||
* [token] '''look''' - The look of the model to use. | * [token] '''look''' - The look of the model to use. | ||
− | === | + | === Trailer dealer data === |
− | + | Trailer dealer offer is defined by exactly same way as truck dealer offer. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | In folder '''/def/vehicle/trailer_dealer/''' are folders for every trailer brand and in them are complete definitions of different pre-configured offers. | |
− | |||
− | |||
− | |||
− |
Revision as of 11:37, 28 August 2018
TIP: Be aware that page is not final. Thus do not fully rely on written subjects, until this message is here!
Contents
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
- Ensure that ALL map files are updated to version compatible with 1.31 update by resaving them in 1.31 version. Otherwise you might be unable to load the map in 1.32 editor.
- Load map
- If the editor shows a warning dialog about items referencing obsolete TERRAIN ONLY road flag, you MUST remove or replace all those items in the map before saving the map. Otherwise the editor might crash when loading the resaved map.
- Run prefab node corrections (F3 - "Prefab node correction")
- Save map
- Do rebuild (F8)
- Save map
- Run shoulder check from "Map\Validate road shoulders" This will generate list of all items which could cause issues with random events (mostly models clipping through). You have following options:
- Adjust the items so they do not cause issues by moving them or removing them
- Mark the related road as having blocked shoulder ("Shoulder blocked" checkboxes in Road item properties) to prevent generation of events.
- If you do not care about the issues, you can ignore the item.
- Save map
Changes
Map format changes
TBA
Game data
- Added blinker_auto_off_trigger attribute defining angle below which blinker auto disable is performed previously.
Economy data
- Added cargo_damage_cost attribute defining how much money player has to pay to for 1% of the damage.
- Added cargo_damage_cost_factor attribute defining factor damage penalty is multiplied with every 1% of the damage.
- Added exp_park_load_bonus attribute defining how big XP bonus player gets for parking trailer during loading of the job.
- Added revenue_per_km_base attribute defining base revenue per km for the ai drivers (has to be proportional to regular cargo fees).
- Added revenue_coef_per_km attribute defining salary coefficient per km for the freight market and online jobs.
- Added cargo_market_revenue_coef_per_km attribute defining salary coefficient per km for the cargo market jobs.
- Added driver_revenue_coef_per_km attribute defining salary coefficient for ai drivers and players quick jobs.
- Added driver_cargo_market_revenue_coef_per_km attribute defining salary coefficient for ai drivers cargo market jobs.
- Removed revenue_per_km.
- Removed driver_revenue_per_km.
- Removed trailer_damage_cost.
- Removed trailer_damage_cost_factor.
- Removed brands, game will now collect truck and trailer brands on startup from
/def/vehicle/truck_dealer
and/def/vehicle/trailer_dealer
directories. Each directory inside that can be interpreted as token is a new brand.
Country data
Country data has a new attribute called mass_limit_per_axle_count. It defines GVW (gross vehicle weight) - maximum allowed mass limit (in kilograms, kg) of the whole vehicle set (truck + trailer(s) + cargo) with the given amount of axles (total truck + trailer(s)) in the the country. Empty array impose no limit.
The first element is describing mass limit for vehicle with 2 axles, second for 3 axles etc. If vehicle has more axles than defined last entry will be used as limit.
country_data: country.data.uk { # [...] mass_limit_per_axle_count[]: 18000 # 2-axle vehicle mass_limit_per_axle_count[]: 26000 # 3-axle vehicle mass_limit_per_axle_count[]: 38000 # 4-axle vehicle mass_limit_per_axle_count[]: 40000 # 5-axle vehicle mass_limit_per_axle_count[]: 44000 # 6 and more-axle vehicle }
Cargo generator
The whole cargo generator was dramatically changed since previous versions:
- Cargo is now defined by units instead of simple weight. One unit of cargo takes some volume, which gives count of unit that might fit into trailer body. From this unit count mass and reward are also derived. Mass is subject for further limitation either by trailer itself or country laws. Both might result in decreasing of cargo unit count loaded.
- Another new concept are body types, trailers and cargo are not linked directly but rather they are being matched by body types. Trailer that has body type flatbed will have only generated jobs that consists of cargo that is compatible with flatbed body.
Cargo data
Attributes price_coef (float), mass (float array, per trailer) and cog_height_offset (float array, per trailer) has been. Attribute array trailers remain only for compatibility of some cargoes.
New attributes:
- [token array] body_types - List of trailer bodies cargo can be loaded in.
- [float] volume - volume of single one unit, in cubic meters (m3)
- [float] mass - mass of one cargo unit, in kilograms (kg)
- [float] unit_reward_per_km - reward for transport of one cargo unit per 1km of distance
- [float] unit_load_time - loading time of one cargo unit, in second
- [bool] overweight - cargo with this flag is used regularly but ignores any trailer or country limitations.
Trailer def
Structure trailer_def was greatly improved and redesigned as its core of the economy. Old system with list of trailers for given cargo is used for remaining old trailers only (using cargo folder placement with filled trailer link and fake underscored trailer body_types).
Additionally trailer defs using new owned trailer system are now placed in /def/vehicle/trailer_defs folder. Old system trailer defs, however, remain in it's original place.
New fields support system that matches cargoes to trailer only through trailer body types with additional information. Most important are:
- [float] gross_trailer_weight_limit - technical or logical limit of trailer(s) + cargo mass, also limited by bridge formula or similar rules.
- [token] body_type - defines cargo that can be loaded in, should equal to body_type of bodies of all trailers in set
- [token array] country_validity - list of countries the trailer is allowed in, empty list impose no limitation
Then there are cached/precomputed values for fast access without necessity of loading all accessories (instead of summing all chassis and body weights in chain) as well as data for trailers that do not have all accessories defined (eg freight market ones):
- [float] trailer_mass - summed mass of all trailer chassis parts
- [float] body_mass - summed mass of all trailer bodies parts
- [float] volume - summed volume of all trailer bodies parts
- [int] axles - counted axles of all trailers in set
- [float] length - length of whole trailer set in meters
- [token] chain_type - type of trailer chain (single, double, b_double, ...)
In addition, there are also cog placement parameters - unlike older mechanics right now its plain cargo cog offset in meters (before height was halved due to historical reasons).
Body types
Body type defines which cargo can be transported with trailer and is binded to economy trough cargo definition with new array attribute body_types in cargo data.
There are several predefined types that have some special handling in the code:
- flatbed
- curtainside
- dryvan
- insulated
- refrigerated
That said one can still use custom token for body type, but do not forget to define new cargo data for it. In the future updates, however, predefined list will most probably grow with new set of body types.
Vehicles data
Truck data
Accessory head lights data
The algorithms for sign illuminations have been changed, from now on the illumination of signs is calculated based on the color and the range of the regular truck lights.
The following attributes were made obsolete and are no longer used:
- low_beam_sign_(color/range)
- hi_beam_sign_(color/range)
- front_beam_sign_(color/range)
- roof_beam_sign_(color/range)
- front_roof_beam_sign_(color/range)
Trailer data
Accessory trailer data
The new unit describing series of the trailer. Very similar to well known accessory_truck_data.
The attributes of the unit are:
- [string] info[0] - (optional) brand name, if empty string is passed no brand is displayed.
- [string] info[1] - (optional) trailer series name.
- [string array] fallback - (optional) list of fallback accessories following format type|path
- other regular rules and requirements for given vehicle
Accessory trailer body data
New accessory type defining trailer body.
Required attributes are:
- [float] volume - The volume of the body in m3. Limits amount of cargo units that can be loaded in.
- [token] body_type - The type of the body. Only cargoes with given body_type can be loaded.
- [float] mass - The mass of the empty body in kg. Might be 0 if all mass is stored in chassis.
- [float3] total_size - The total size of the trailer in meters (currently unused).
- [float3] size - The internal size of the trailer body in meters, shown in tooltip.
Optional attributes are:
- [string] detail_model - The detailed model of the body.
- [string] model - The default model of the body.
- [string array] lods - The LOD models.
- [string] collision - The collision of the body.
- [token] variant - The variant of the model to use.
- [token] look - The look of the model to use.
Trailer dealer data
Trailer dealer offer is defined by exactly same way as truck dealer offer.
In folder /def/vehicle/trailer_dealer/ are folders for every trailer brand and in them are complete definitions of different pre-configured offers.