Changes

Jump to navigation Jump to search

Documentation/Tools/Conversion Tools

48 bytes removed, 17:11, 22 December 2019
Download
=What Conversion tools are conversion tools and when set of binaries used to convert mid-format files to use them=binary format files which are used by the game.
Conversion tools are set of binaries used to In general you should convert mid-format files to binary format files which are used by the game. They are needed your whole mod file system structure for in game usage of using this tools including:any 3D assets exported with [[Tools/SCS_Blender_Tools|SCS Blender Tools]], any definition files, sound files, map files etc.
=What is included in packageDownload & Installation =
Downloaded archive consists of following folders and files:=== Download ===
*'''conversion_tools[http://download.eurotrucksimulator2.com/conversion_tools_2_10.zip LINK (v2.10)]''' - ETS2 ('''1.36''') & ATS ('''1.36''')* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_9.zip LINK (v2.9)]''' - ETS2 ('''1.36''') & ATS ('''1.36''')* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_8.zip LINK (v2.8)]''' - ETS2 ('''1.35''') & ATS ('''1.35''')* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_7.zip LINK (v2.7)]''' - ETS2 ('''1.32''') & ATS ('''1.32''')* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_6.zip LINK (v2.6)]''' - conversion tools binaries and predefined folder structureETS2 ('''1.31''') & ATS ('''1.31''')* '''[http://download.eurotrucksimulator2.com/conversion_tools_2_5.zip LINK (v2.5)]''' - ETS2 ('''1.30''') & ATS ('''1.29''')*'''blender_addon[http://download.eurotrucksimulator2.com/conversion_tools_2_4.zip LINK (v2.4)]''' - "SCS Conversion Helper" Blender addon for using conversion tools out of the box from BlenderETS2 ('''1.27 - 1.28''') & ATS ('''1.6 - 1.28''')*'''README[http://download.eurotrucksimulator2.com/conversion_tools_1_8.zip LINK (v1.8)]''' - ETS2 ('''1.27 and below''') & ATS ('''1.md5 and below''')
NOTE: Blender addon doesn{{Note|Old conversion tools compatible with ETS2 (up to '''v1.26'''t have ), ATS (up to be used as the addon itself is only helper for using conversion tools directly from '''v1.5''') also require older SCS BlenderTools versions up to '''v1.6'''.}}
=Installation== Install ===
Before installation download current version of To install conversion tools from [http://downloadbinaries simply extract ZIP package into folder somewhere on the PC where it can be found and '''read-write access is granted'''.eurotrucksimulator2.com/conversion_tools_1_6.zip here]
Installation: #To install conversion tools binaries simply copy <code>conversion_tools</code> folder somewhere on the PC where it can be found and read-write access is granted.#To install Blender addon named "SCS Conversion Helper" copy <code>blender_addon/scs_conversion_helper</code> folder to <code>< blender_version >/scripts/addons</code> within Blender installation folder (for other installation procedures please visit [http://wiki.blender.org/index.php/Doc:2.6/Manual/Extensions/Python/Add-Ons Blender wiki]). After installing "SCS Conversion Helper" make sure that addon is enabled! =Usage=
There are two options of usage for conversion tools:
==# '''''Use conversion tools from Blender==''''' Use "#* First make sure you installed SCS Conversion Helper" addon. This addon actually grabs "SCS Project Base Path" property from Blender Tools see: [[https:Documentation/Tools/github.com/SCSSoftware/BlenderTools/wiki/Global-Settings#path-settings SCS Blender Tools Global Settings/Installation]] and uses conversion tools binaries #* Navigate to convert resources with simple click of a button. After enabling of an addon, additional panel in Blender named "SCS ''Conversion Helper" will appear '' panel in ''Output'' properties window under "Scene" tab. [[File:Scs conversion helper.jpg]] Panel features: #*Set '''"Conversion Tools Path" property''' - specified path pointing to extracted conversion tools binaries mentioned abovefolder.#*'''"Clean 'rsrc' folder" property''' - using this option any content in <code>conversion_tools/rsrc</code> Now conversion tools will first be removed then conversion used when you will take place*'''"CONVERT CURRENT SCS PROJECT" operator''' - will write current "SCS Project Base Path" to <code>extra_mount.txt</code> and run the use operators of conversion.NOTEhelper (for more info see: This kind of usage will convert only resources which are in "conversion_tools[[Documentation/Tools/base" and resources from "SCS Project Base Path". After conversion is done, content inside <code>conversion_toolsBlender Tools/rsrc</code> folder can be ZIP-ed and placed into the mod folder of the game as usualConversion Helper]])==# '''''Use binaries directly (for advanced users)=='''''#: Direct usage of conversion tools is done from command line with execution of <code>&quot;conversion_tools/convert.cmd</code> &quot; script. Running this script will take any mid-format resources founded in <code>&quot;conversion_tools/base</code> &quot; folder, correctly convert them into binary format files and place them into <code>&quot;conversion_tools/rsrc</code> &quot; folder. NOTE#: Usage After completed conversion all the content will be in inside &quot;conversion_tools/rsrc/base/@cache&quot;. To create a mod you can ZIP &quot;conversion_tools/rsrc/base/@cache&quot; folder and place into the mod folder of the game as usual. In case of &quot;conversion_tools/extra_mount.txt&quot; usage each entry from extra mount will have it's own converted folder entry inside &quot;conversion_tools/rsrc&quot; 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".<codeblockquote>{{Note|Usage of &quot;conversion_tools/extra_mount.txt</code> &quot; file with specified additional <code>base</code> 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 <code>&quot;conversion_tools/base</code> &quot; folder. With extra mounted directories conversion tools will convert all resources from <code>base}}</codeblockquote> and all additional paths! After completed conversion all the content in <codeblockquote>conversion_tools/rsrc</code> folder can be ZIP-ed and placed into the mod folder of the game as usual. NOTE: if {{Note|If something goes wrong during the conversion, you can find additional information in conversion tools log file <code>(&quot;bin/win_x86/mass_convert.log&quot;).}}</codeblockquote>.

Navigation menu