Difference between revisions of "Tutorials/SCS Workshop Uploader/How to upload new mod?"
m (Fixed grammar, spelling and clarified some things.) |
(→Uploading) |
||
(30 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
=Introduction= | =Introduction= | ||
− | In this tutorial | + | In this tutorial we will show you how to prepare your mod for uploading it to the workshop step by step. |
− | ==Workshop mod | + | ==Workshop mod layout== |
− | First of all - the layout of your mod will change a little bit. | + | First of all - the layout of your mod will change a little bit. The standard mod is a single '''package''' with manifest.sii file inside, description and icon files and the mod data files. The Workshop mod can and should consist of many '''packages''' - this change gives you possibility to create mods that are supporting few game patches without need to activate different mod by your mod users. In the '''versions.sii''' file you specify which '''package''' game should use when using the specified game patch. But remember - this layout is only correct for Workshop mods. Standard mods are still using the one package approach. |
− | == | + | [[File:Mod_layout_explanation.jpg]] |
+ | |||
+ | ==Prepearing mod for uploading step by step== | ||
{| class="wikitable" width="100%" | {| class="wikitable" width="100%" | ||
Line 21: | Line 23: | ||
|The universal directory (or archive) should contain all the standard mod package content so: manifest.sii file, description file, icon file and the mod content. | |The universal directory (or archive) should contain all the standard mod package content so: manifest.sii file, description file, icon file and the mod content. | ||
− | + | '''Remember! In Workshop mods manifest.sii, description and icon files are required!''' | |
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
| '''4''' | | '''4''' | ||
Line 61: | Line 63: | ||
|} | |} | ||
− | When you do those points and put your game content to package you and you don't want to support exact | + | When you do those points and put your game content to package you and you don't want to support exact patches you can skip next points and go to [[#Uploading|Uploading]] part. |
==Supporting specify version of the game== | ==Supporting specify version of the game== | ||
Line 69: | Line 71: | ||
|[[File:0008_create_folder_for_122_content.jpg|500px]] | |[[File:0008_create_folder_for_122_content.jpg|500px]] | ||
|In case you have data that supports one exact game version you need to create folder or archive where you will store the content. | |In case you have data that supports one exact game version you need to create folder or archive where you will store the content. | ||
− | |||
− | |||
− | |||
− | |||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
| '''2''' | | '''2''' | ||
|[[File:0009_add_new_unit_to_versions_sii_with_122_content_step_1.jpg|500px]] | |[[File:0009_add_new_unit_to_versions_sii_with_122_content_step_1.jpg|500px]] | ||
− | |Open your text editor and do | + | |Open your text editor and do exatly the same steps as you did while adding definition for universal patch. (Besides different folder and unit name) |
<pre>SiiNunit | <pre>SiiNunit | ||
Line 93: | Line 91: | ||
| '''3''' | | '''3''' | ||
|[[File:0010_add_new_unit_to_versions_sii_with_122_content_step_2.jpg|500px]] | |[[File:0010_add_new_unit_to_versions_sii_with_122_content_step_2.jpg|500px]] | ||
− | | | + | |There is new thing. You need to set value of the compatible_versions attribute. This attribute is simply array containing strings that are masks of the game versions. As we want to have data for 1.22 patch simply write there "1.22.*". Values are similar to compatible_versions array in manifest.sii however for workshop mods we are using versions specified in versions.sii. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<pre>SiiNunit | <pre>SiiNunit | ||
Line 120: | Line 110: | ||
|[[File:0011_create_multiversion_folder.jpg|500px]] | |[[File:0011_create_multiversion_folder.jpg|500px]] | ||
|In case you want to support more than one exact version you need to setup folder for it. | |In case you want to support more than one exact version you need to setup folder for it. | ||
− | |||
− | |||
− | |||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
| '''5''' | | '''5''' | ||
Line 149: | Line 136: | ||
| '''6''' | | '''6''' | ||
|[[File:0013_add_first_version_attribute.jpg|500px]] | |[[File:0013_add_first_version_attribute.jpg|500px]] | ||
− | |Add compatible_version value for one | + | |Add compatible_version value for one patch you support. |
<pre>SiiNunit | <pre>SiiNunit | ||
Line 173: | Line 160: | ||
| '''7''' | | '''7''' | ||
|[[File:0014_add_second_version_attribute.jpg|500px]] | |[[File:0014_add_second_version_attribute.jpg|500px]] | ||
− | |And add again compatible_version value for second | + | |And add again compatible_version value for second patch you want to support. |
<pre>SiiNunit | <pre>SiiNunit | ||
Line 199: | Line 186: | ||
=Uploading= | =Uploading= | ||
− | {{UsefulLink|If you don't have SCS Workshop Uploader installed - check this tutorial - [[Tutorials/ | + | {{UsefulLink|If you don't have SCS Workshop Uploader installed - check this tutorial - [[Tutorials/Workshop_Uploader/How_to_download?|How to download and install SCS Workshop Uploader?]]}} |
[[File:Scs_workshop_uploader_tutorial_preview.jpg]] | [[File:Scs_workshop_uploader_tutorial_preview.jpg]] | ||
Line 205: | Line 192: | ||
*Run '''SCS Workshop Uploader''' tool from your steam client. | *Run '''SCS Workshop Uploader''' tool from your steam client. | ||
#Select the '''game''' that is compatible with your mod. | #Select the '''game''' that is compatible with your mod. | ||
− | #Select '''New''' from the | + | #Select '''New''' item from the items combobox. It should be selected by default when you launch the tool. |
− | #In the '''Mod data''' section - browse for | + | #In the '''Mod data''' section - browse for a '''mod data folder'''. |
#If you select folder, browse for '''mod preview image'''. | #If you select folder, browse for '''mod preview image'''. | ||
#In next step fill '''mod name'''. | #In next step fill '''mod name'''. | ||
Line 215: | Line 202: | ||
#You can select '''truck parts''' and '''brand''' tag if appropriate. | #You can select '''truck parts''' and '''brand''' tag if appropriate. | ||
#You can now fill '''change note''' of your mod. If you need to have the edit box bigger simply resize the tool window. As it's initial upload step you will more likely write nothing here - or write something like ''"Initial upload."''. | #You can now fill '''change note''' of your mod. If you need to have the edit box bigger simply resize the tool window. As it's initial upload step you will more likely write nothing here - or write something like ''"Initial upload."''. | ||
− | #If you did all the points simply click '''Upload''' button. Before the actual upload operation | + | #If you did all the points simply click '''Upload''' button. Before the actual upload operation the tool will check if your mod contains correct data. |
− | |||
− | |||
− | |||
==Validation== | ==Validation== | ||
Line 225: | Line 209: | ||
[[File:0025_in_case_of_error_you_will_get_this_dialog.jpg|500px]] | [[File:0025_in_case_of_error_you_will_get_this_dialog.jpg|500px]] | ||
− | When you click '''OK''' you will see log dialog with all errors and warnings that | + | When you click '''OK''' you will see log dialog with all errors and warnings that occured during validation. In case if you have only warnings you can both continue or abort operation. In case of error you '''need to''' fix them before uploading. |
− | {{UsefulLink|If you need help with solving your validation errors click '''[[ | + | {{UsefulLink|If you need help with solving your validation errors click '''[[Tools/Workshop_Uploader/Validation_errors_and_solutions_for_them|here]]'''}} |
Line 235: | Line 219: | ||
#In this line you have the summary of the validation - the number of errors and warnings. | #In this line you have the summary of the validation - the number of errors and warnings. | ||
#In this area you have log of the validation. All the log entires have the following form: '''''[TYPE] [CODE] (file): Message''''' | #In this area you have log of the validation. All the log entires have the following form: '''''[TYPE] [CODE] (file): Message''''' | ||
− | #Bellow you have two checkboxes, you can hide | + | #Bellow you have two checkboxes, you can hide warnigns or errors here. |
− | #In case there are | + | #In case there are only errors you are able to only click Abort. This button simply aborts the upload. |
− | #In case | + | #In case there are only warnings you can click this button and continue uploading of your mod. If there are errors you are unable to continue - you have to fix the problems. |
==Success== | ==Success== | ||
− | If there are no errors the upload will continue | + | If there are no errors and the upload will continue on successfull upload you will see this dialog. |
[[File:0026_upload_success.jpg]] | [[File:0026_upload_success.jpg]] | ||
− | However it is possible that there was some failure while uploading - you will then notice dialog with the error message. If you have some problem with resolving the problem write on '''[http://forum. | + | However it is possible that there was some failure while uploading - you will then notice dialog with the error message. If you have some problem with resolving the problem write on our forum '''[http://forum.url.put.here click todo moding section] (Create Steam Workshop section dedicated to it?)''' |
=Steam Workshop Terms Of Service= | =Steam Workshop Terms Of Service= | ||
− | If it’s your first mod and you were not doing any mods for other game <!-- '''(or Valve updated Terms of Service?)'''--> you will likely get | + | If it’s your first mod and you were not doing any mods for other game <!-- '''(or Valve updated Terms of Service?)'''--> you will likely get error about not accepted Steam Workshop Terms Of Service - if so happends tool will show you appropriate message and the steam workshop terms of service will be opened in your default web browser - you have to login to your steam account read and accept the terms of service and if you do so simply go back to the tool and try again with uploading your mod. |
Revision as of 11:16, 5 February 2016
Contents
Introduction
In this tutorial we will show you how to prepare your mod for uploading it to the workshop step by step.
Workshop mod layout
First of all - the layout of your mod will change a little bit. The standard mod is a single package with manifest.sii file inside, description and icon files and the mod data files. The Workshop mod can and should consist of many packages - this change gives you possibility to create mods that are supporting few game patches without need to activate different mod by your mod users. In the versions.sii file you specify which package game should use when using the specified game patch. But remember - this layout is only correct for Workshop mods. Standard mods are still using the one package approach.
Prepearing mod for uploading step by step
When you do those points and put your game content to package you and you don't want to support exact patches you can skip next points and go to Uploading part.
Supporting specify version of the game
Uploading
Useful link: If you don't have SCS Workshop Uploader installed - check this tutorial - How to download and install SCS Workshop Uploader?
- Run SCS Workshop Uploader tool from your steam client.
- Select the game that is compatible with your mod.
- Select New item from the items combobox. It should be selected by default when you launch the tool.
- In the Mod data section - browse for a mod data folder.
- If you select folder, browse for mod preview image.
- In next step fill mod name.
- Select mod visibility in steam workshop. If it's Private, Friends only or Public.
- Fill your mod description which will be shown in your item workshop page. (Minimum 50 characters)
- If you want to know formatting possibilities click on the question mark button.
- Now, you have to select type tag for your mod.
- You can select truck parts and brand tag if appropriate.
- You can now fill change note of your mod. If you need to have the edit box bigger simply resize the tool window. As it's initial upload step you will more likely write nothing here - or write something like "Initial upload.".
- If you did all the points simply click Upload button. Before the actual upload operation the tool will check if your mod contains correct data.
Validation
- In case of any validation error you will notice this dialog.
When you click OK you will see log dialog with all errors and warnings that occured during validation. In case if you have only warnings you can both continue or abort operation. In case of error you need to fix them before uploading.
Useful link: If you need help with solving your validation errors click here
- In this line you have the summary of the validation - the number of errors and warnings.
- In this area you have log of the validation. All the log entires have the following form: [TYPE] [CODE] (file): Message
- Bellow you have two checkboxes, you can hide warnigns or errors here.
- In case there are only errors you are able to only click Abort. This button simply aborts the upload.
- In case there are only warnings you can click this button and continue uploading of your mod. If there are errors you are unable to continue - you have to fix the problems.
Success
If there are no errors and the upload will continue on successfull upload you will see this dialog.
However it is possible that there was some failure while uploading - you will then notice dialog with the error message. If you have some problem with resolving the problem write on our forum click todo moding section (Create Steam Workshop section dedicated to it?)
Steam Workshop Terms Of Service
If it’s your first mod and you were not doing any mods for other game you will likely get error about not accepted Steam Workshop Terms Of Service - if so happends tool will show you appropriate message and the steam workshop terms of service will be opened in your default web browser - you have to login to your steam account read and accept the terms of service and if you do so simply go back to the tool and try again with uploading your mod.