1,740
edits
Changes
no edit summary
Conversion helper panel features tools for automated files conversion and mod packing. Panel with conversion helper can be found below [[Documentation/Tools/SCS Blender Tools/Export Panel|Export Panel]] located within Scene ''Output'' tab in Blender properties window.
However before you use Conversion Helper you should download latest [[Documentation/Tools/Conversion Tools|Conversion Tools]] for the game you want to create mod forand set path to conversion tools under ''Conversion Tools Path''. Also Additionally make sure you have checked [[Documentation/Tools/SCS Blender Tools/Intended workflow|Intended workflow]] images, for better understanding how mod system works when using SCS Blender Tools and Conversion Tools.
[[File:SCS_Tools_Conv_Hlpr.280.png]]
Conversion helper also support switchable '''CLEAN RSRCCustom Paths''' - operator which will immediately clean content that you converted before or is left there from some other time. In general this makes sure your mod won't have any unused resources (leftover textures, old materials) in the converted resultOnce they are enabled conversion helper panel gets extended as seen on image below.
== Custom Paths Usage ==
Custom Paths are holding list property for multiple custom paths that you want to convert at the same time. Use this custom paths if you want to merge resources from 2 or more different mods of yours. Example usage is shown in [[Documentation/Tools/SCS Blender Tools/Intended workflow#Usual mod combined with dependency mod (using custom paths)|Intended workflow#Usual mod combined with dependency mod (using custom paths)]]
On the side of the list you can find operators for managing your custom paths:
* <span style="color:#FFFFFF">{{Blender Button|'''[[File:SCS_Tools_Conv_Hlpr_Add_Cstm_Path.png]]+''' }}</span> - opens file selector where you should browse for new custom path you want to use.* <span style="color:#FFFFFF">{{Blender Button|'''[[File:SCS_Tools_Conv_Hlpr_Del_Cstm_Path.png]]−''' }}</span> - deletes currently selected custom path in the list.* '''[[File<span style="color:SCS_Tools_Conv_Hlpr_Cstm_Path_Up.png]]''' #FFFFFF">{{Blender Button|⯅}}</span> - moves up currently selected custom path in the list. Ordering in the list doesn't have influence on converted result. It is only there so you can order paths however you like.* '''[[File<span style="color:SCS_Tools_Conv_Hlpr_Cstm_Path_Down.png]]''' #FFFFFF">{{Blender Button|⯆}}</span> - moves down currently selected custom path in the list. Ordering in the list doesn't have influence on converted result. It is only there so you can order paths however you like.
== Mod Packing ==
First two options are specifying destination and name:
* '''Mod Folder Path''' - property holding folder where mod should be placed. On the side of this property you have search icon operator ([[File:SCS_Tools_Conv_Hlpr_Find_Folder.png]]) for auto retrieve of the mod paths for Euro Truck Simulator 2 or American Truck Simulator.
* '''Mod Name''' - property holding name of the mod ZIP file.
Third row is featuring switching defines type of automated actions that should be done before the compression you want to use for your mod will be packedpackage:* '''Folder''' - this option creates folder inside selected mod destination and copies result of conversion tools to it, instead of creating a ZIP package. Created folder is named the same as ZIP package:by mod name property.* '''ZIP (Uncompressed)''' - pack mod into uncompressed ZIP file.* '''ZIP (Moderate)''' - pack mod into compressed ZIP file (helper uses deflated compression, which is supported by SCS games).
So if you don't want to bother with manual exporting/converting, then for easy usage follow this few steps:# Set mod folder path to: "[[Category:Documentation/Engine/Game_user_path|<Game User Path>]]/mod"# Fill-in mod name# Enable all options# Press PACK MOD. [[Category:SCS Blender Tools]]# Once packing is done, run the game and try your mod out!