Changes

=What are conversion tools Converion Tools and when to use them=

Conversion tools are set of binaries used to convert mid-format files <br />to binary format files which are used by the game. They are needed <br />In general you should convert your whole mod file system structure for in game usage of <br />using this tools including:<br />any 3D assets exported with [[Tools/SCS_Blender_Tools|SCS Blender Tools]], any definition files, sound files, map files etc.

=What is included in packageInstallation =

Downloaded archive consists of following folders # Download conversion tools: [http://download.eurotrucksimulator2.com/conversion_tools_X_X.zip LINK]# To install conversion tools binaries simply extract ZIP package into folder somewhere on<br />the PC where it can be found and files:read-write access is granted.

*'''conversion_tools''' - conversion tools binaries and predefined folder structure*'''blender_addon''' - "SCS Conversion Helper" Blender addon for using conversion tools out of the box from Blender*'''README.md''' NOTE: Blender addon doesn't have to be used as the addon itself is only helper for using conversion tools directly from Blender. =Installation= Before installation download current version of conversion tools from [http://download.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=

==Use conversion tools from Blender== Use "SCS Conversion Helper" addon. This addon actually grabs "SCS Project Base Path" property from [https://github.com/SCSSoftware/BlenderTools/wiki/Global-Settings#path-settings SCS Blender Tools Global Settings] and uses conversion tools binaries to convert resources with simple click of a button. After enabling of an addon, additional panel in Blender named "SCS Conversion Helper" will appear in properties window under "Scene" tab. [[File:Scs conversion helper.jpg]] Panel features: *'''"Conversion Tools Path" property''' - specified path to extracted Use conversion tools binaries mentioned above*'''"Clean 'rsrc' folder" property''' - using this option any content in <code>conversion_tools/rsrc</code> will first be removed then conversion will take place*from Blender'''"CONVERT CURRENT SCS PROJECT" operator''' - will write current "SCS Project Base Path" to <code>extra_mount.txt</code> and run the conversion.NOTE: This kind of usage will convert only resources which are in <code>conversion_tools/base</code> and resources from "SCS Project Base Path". After conversion is done, content inside <code>conversion_tools/rsrc</code> folder can be ZIP-ed and placed into the mod folder of the game as usual.

==Use binaries directly * First make sure you installed [https://github.com/SCSSoftware/BlenderTools/wiki SCS Blender Tools]* Navigate to Conversion Helper panel in Scene properties tab.* Set &quot;Conversion Tools Path&quot; pointing to extracted conversion tools folder (the same folder as this readme file is in).* Now conversion tools will be used when you will use operators of conversion helper<br />(for advanced usersmore info see: https://github.com/SCSSoftware/BlenderTools/wiki/Conversion-Helper)==.

Running this script will take any mid-format resources founded in Direct usage of conversion tools is done from command line<codebr />with execution of &quot;conversion_tools/base</code> folder, correctly convert them into binary format files and place them into <code>conversion_tools/rsrc</code> folder.cmd&quot; script.

NOTE: Usage of Running this script will take any mid-format resources founded in<codebr />&quot;conversion_tools/extra_mount.txt</code> file with specified additional <code>base&quot; folder, correctly convert them into<br /code> folder paths 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>binary format files and place them into &quot;conversion_tools/base</code> rsrc&quot; folder. With extra mounted directories conversion tools will convert all resources from <code>base</code> and all additional paths!

<blockquote>NOTE: Usage of &quot;conversion_tools/extra_mount.txt&quot; file with specified additional<br />&quot;base&quot; folder paths in each line of the file may also be used. This will cause<br />conversion tools to mount all of the paths the same as &quot;conversion_tools/base&quot;<br />folder. With extra mounted directories conversion tools will convert<br />all resources from &quot;base&quot; and all additional paths!</blockquote>After completed conversion all the content in <code>&quot;conversion_tools/rsrc&quot;<br /code> folder can be ZIP-ed and placed into the mod folder of the game as usual.

<blockquote>NOTE: if something goes wrong during the conversion, you can find additional <br />information in conversion tools log file <code>(&quot;bin/win_x86/mass_convert.log&quot;).</codeblockquote>.