Difference between revisions of "Documentation/Tools/Conversion Tools"

From SCS Modding Wiki
Jump to navigation Jump to search
(Download & Installation)
(Download & Installation)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Conversion tools are set of binaries used to convert mid-format files to binary format files which are used by the game.
+
Conversion tools are a set of binaries used to convert mid-format files to binary format files which are used by the game.
  
 
In general you should convert your whole mod file system structure for in game usage using this tools including:
 
In general you should convert your whole mod file system structure for in game usage using this tools including:
Line 8: Line 8:
 
=== Download ===
 
=== Download ===
  
* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_9.zip LINK (v2.9)]''' - ETS2 ('''1.36''') & ATS ('''1.36''') - currently in public beta
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_15.zip LINK (v2.15)]''' - ETS2 ('''1.49+''') & ATS ('''1.49+''')
* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_8.zip LINK (v2.8)]''' - ETS2 ('''1.35''') & ATS ('''1.35''')
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_14.zip LINK (v2.14)]''' - ETS2 ('''1.47+''') & ATS ('''1.47+''')
* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_7.zip LINK (v2.7)]''' - ETS2 ('''1.32''') & ATS ('''1.32''')
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_13.zip LINK (v2.13)]''' - ETS2 ('''1.44+''') & ATS ('''1.44+''')
* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_6.zip LINK (v2.6)]''' - ETS2 ('''1.31''') & ATS ('''1.31''')
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_12.zip LINK (v2.12)]''' - ETS2 ('''1.37 - 1.43''') & ATS ('''1.37 - 1.43''')
* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_5.zip LINK (v2.5)]''' - ETS2 ('''1.30''') & ATS ('''1.29''')
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_10.zip LINK (v2.10)]''' - ETS2 ('''1.36''') & ATS ('''1.36''')
* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_4.zip LINK (v2.4)]''' - ETS2 ('''1.27 - 1.28''') & ATS ('''1.6 - 1.28''')
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_9.zip LINK (v2.9)]''' - ETS2 ('''1.36''') & ATS ('''1.36''')
* '''[http://download.eurotrucksimulator2.com/conversion_tools_1_8.zip LINK (v1.8)]''' - ETS2 ('''1.27 and below''') & ATS ('''1.5 and below''')
+
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_8.zip LINK (v2.8)]''' - ETS2 ('''1.35''') & ATS ('''1.35''')
 +
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_7.zip LINK (v2.7)]''' - ETS2 ('''1.32''') & ATS ('''1.32''')
 +
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_6.zip LINK (v2.6)]''' - ETS2 ('''1.31''') & ATS ('''1.31''')
 +
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_5.zip LINK (v2.5)]''' - ETS2 ('''1.30''') & ATS ('''1.29''')
 +
* '''[https://download.eurotrucksimulator2.com/conversion_tools_2_4.zip LINK (v2.4)]''' - ETS2 ('''1.27 - 1.28''') & ATS ('''1.6 - 1.28''')
 +
* '''[https://download.eurotrucksimulator2.com/conversion_tools_1_8.zip LINK (v1.8)]''' - ETS2 ('''1.27 and below''') & ATS ('''1.5 and below''')
  
 
{{Note|Old conversion tools compatible with ETS2 (up to '''v1.26'''), ATS (up to '''v1.5''') also require older SCS Blender Tools versions up to '''v1.6'''.}}
 
{{Note|Old conversion tools compatible with ETS2 (up to '''v1.26'''), ATS (up to '''v1.5''') also require older SCS Blender Tools versions up to '''v1.6'''.}}
Line 20: Line 25:
 
=== Install ===
 
=== Install ===
  
To install conversion tools binaries simply extract ZIP package into folder somewhere on the PC where it can be found and '''read-write access is granted'''.
+
To install conversion tools binaries simply extract the ZIP package into a folder somewhere on the PC where it can be found and '''read-write access is granted'''.
  
 
= Usage =
 
= Usage =
Line 27: Line 32:
  
 
# '''''Use conversion tools from Blender'''''
 
# '''''Use conversion tools from Blender'''''
#* First make sure you installed [[Documentation/Tools/SCS Blender Tools]]
+
#* First make sure you installed SCS Blender Tools see: [[Documentation/Tools/SCS Blender Tools/Installation]]
#* Navigate to Conversion Helper panel in Scene properties tab.
+
#* Navigate to ''Conversion Helper'' panel in ''Output'' properties tab.
#* Set "Conversion Tools Path" pointing to extracted conversion tools folder (the same folder as this readme file is in).
+
#* Set ''Conversion Tools Path'' pointing to extracted conversion tools folder.
 
#* Now conversion tools will be used when you will use operators of conversion helper (for more info see: [[Documentation/Tools/SCS Blender Tools/Conversion Helper]]).
 
#* Now conversion tools will be used when you will use operators of conversion helper (for more info see: [[Documentation/Tools/SCS Blender Tools/Conversion Helper]]).
 
# '''''Use binaries directly (for advanced users)'''''
 
# '''''Use binaries directly (for advanced users)'''''
 
#: Direct usage of conversion tools is done from command line with execution of "conversion_tools/convert.cmd" script. Running this script will take any mid-format resources founded in "conversion_tools/base" folder, correctly convert them into binary format files and place them into "conversion_tools/rsrc" folder.
 
#: Direct usage of conversion tools is done from command line with execution of "conversion_tools/convert.cmd" script. Running this script will take any mid-format resources founded in "conversion_tools/base" folder, correctly convert them into binary format files and place them into "conversion_tools/rsrc" folder.
#: After completed conversion all the content will be in inside "conversion_tools/rsrc/base/@cache". To create a mod you can ZIP "conversion_tools/rsrc/base/@cache" folder and place into the mod folder of the game as usual. In case of "conversion_tools/extra_mount.txt" usage each entry from extra mount will have it's own converted folder entry inside "conversion_tools/rsrc" So to pack a mod you will have to take result from each respective converted folder and put it together in same ZIP file (e.g. extra mount entry "my_mod" will have conversion result in "conversion_tools/rsrc/my_mod/@cache".
+
#: After completed conversion all the content will be in inside "conversion_tools/rsrc/base/@cache". To create a mod you can ZIP "conversion_tools/rsrc/base/@cache" folder and place into the mod folder of the game as usual. In case of "conversion_tools/extra_mount.txt" usage each entry from extra mount will have its own converted folder entry inside "conversion_tools/rsrc" So to pack a mod you will have to take the result from each respective converted folder and put it together in the same ZIP file (e.g. extra mount entry "my_mod" will have conversion result in "conversion_tools/rsrc/my_mod/@cache".
 
<blockquote>{{Note|Usage of &quot;conversion_tools/extra_mount.txt&quot; file with specified additional sibling folder paths of &quot;base&quot; in each line of the file may also be used. This will cause conversion tools to mount all of the paths the same as &quot;conversion_tools/base&quot; folder. }}</blockquote>
 
<blockquote>{{Note|Usage of &quot;conversion_tools/extra_mount.txt&quot; file with specified additional sibling folder paths of &quot;base&quot; in each line of the file may also be used. This will cause conversion tools to mount all of the paths the same as &quot;conversion_tools/base&quot; folder. }}</blockquote>
<blockquote>{{Note|If something goes wrong during the conversion, you can find additional information in conversion tools log file (&quot;bin/win_x86/mass_convert.log&quot;).}}</blockquote>
+
<blockquote>{{Note|If something goes wrong during the conversion, you can find additional information in the conversion tools log file (&quot;bin/win_x86/mass_convert.log&quot;).}}</blockquote>

Latest revision as of 16:52, 6 November 2023

Conversion tools are a set of binaries used to convert mid-format files to binary format files which are used by the game.

In general you should convert your whole mod file system structure for in game usage using this tools including: any 3D assets exported with SCS Blender Tools, any definition files, sound files, map files etc.

Download & Installation

Download

Note: Old conversion tools compatible with ETS2 (up to v1.26), ATS (up to v1.5) also require older SCS Blender Tools versions up to v1.6.

Install

To install conversion tools binaries simply extract the ZIP package into a folder somewhere on the PC where it can be found and read-write access is granted.

Usage

There are two options of usage for conversion tools:

  1. Use conversion tools from Blender
  2. Use binaries directly (for advanced users)
    Direct usage of conversion tools is done from command line with execution of "conversion_tools/convert.cmd" script. Running this script will take any mid-format resources founded in "conversion_tools/base" folder, correctly convert them into binary format files and place them into "conversion_tools/rsrc" folder.
    After completed conversion all the content will be in inside "conversion_tools/rsrc/base/@cache". To create a mod you can ZIP "conversion_tools/rsrc/base/@cache" folder and place into the mod folder of the game as usual. In case of "conversion_tools/extra_mount.txt" usage each entry from extra mount will have its own converted folder entry inside "conversion_tools/rsrc" So to pack a mod you will have to take the result from each respective converted folder and put it together in the same ZIP file (e.g. extra mount entry "my_mod" will have conversion result in "conversion_tools/rsrc/my_mod/@cache".

Note: Usage of "conversion_tools/extra_mount.txt" file with specified additional sibling folder paths of "base" in each line of the file may also be used. This will cause conversion tools to mount all of the paths the same as "conversion_tools/base" folder.

Note: If something goes wrong during the conversion, you can find additional information in the conversion tools log file ("bin/win_x86/mass_convert.log").