Difference between revisions of "Tutorials/SCS Workshop Uploader/How to upload new mod?"

From SCS Modding Wiki
Jump to navigation Jump to search
Line 1: Line 1:
# Create folder where you will put your mod content.
+
=Preparing mod=
# Put version specific content into appropriate folders - you can zip those folders. '''TODO: What are those "appropriate" folders?'''
+
To upload mod to Steam Workshop you need to setup few new files and folders your mod. Steam Workshop mods have ability to be compatible with multiple versions so you need to define which data game should use.
# Create file called [[Tools/Workshop_Uploader/versions.sii|versions.sii]] where you put [[Units/package version info|package version info]] units. '''TODO: Describe how to write this definition file with some examples'''
 
# When you prepare everything launch SCS Workshop Uploader tool from your Steam Client.
 
# Select the game which will be the target application for your workshop creation.
 
# In "Mod data" section
 
## Select folder with your mod content. You need to select the root folder of your mod this where you have placed your versions.sii file and version folders or archives.
 
## Browse for preview image. The maximum size of the file is '''1 MB'''.
 
# In the next section
 
## fill the Mod name (maximum 128 characters)
 
## select visibility state (if the mod is private, friends only or public).
 
# In "Description" section fill your mod description - the minimum amount of characters is 50 characters - maximum is 8000. (We count one byte as characters so in case you are using multibyte characters it will count as more than one (also new lines, spaces count as character))
 
# In "Tags" section
 
## You '''MUST''' select Type of your mod
 
## Truck parts and Brand are optional
 
# In "Change note" you specify changelog of new mod version - in this case you can leave it empty or simply write there something like "Initial release" or "First version release".
 
# When you are done you can press Upload button. In case validation failed or some different problem happened you will be informed by proper dialog.
 
  
 +
First step of preparing your mod to be sent to Steam Workshop is creation of folder where you will store your mod data.
 
[[File:0001_create_folder.jpg]]
 
[[File:0001_create_folder.jpg]]
 
[[File:0002_create_folder.jpg]]
 
[[File:0002_create_folder.jpg]]
 +
 +
When you create the folder open it and create another folder called '''latest''' (the name can be different however we recommend calling it latest) - in this place you will put data files of your mod that will be compatible with latest game patches. Instead of folder you can also create ZIP archives with game data.
 
[[File:0003_create_latest_folder.jpg]]
 
[[File:0003_create_latest_folder.jpg]]
 +
 +
Open text editor and create file called versions.sii - save it in the same folder where you created '''latest''' folder
 
[[File:0004_open_text_editor_and_create_versions_sii.jpg]]
 
[[File:0004_open_text_editor_and_create_versions_sii.jpg]]
 +
 +
Add magic and global scope to your versions.sii file.
 
[[File:0005_fill_versions_sii_with_magic_and_global_sii_scope.jpg]]
 
[[File:0005_fill_versions_sii_with_magic_and_global_sii_scope.jpg]]
 +
 +
Add definition of latest version.
 
[[File:0006_add_package_version_info_for_latest_version.jpg]]
 
[[File:0006_add_package_version_info_for_latest_version.jpg]]
 +
 +
Set value of the attribute called '''folder''' which is the name of the folder or ZIP archive with the data.
 
[[File:0007_add_folder_attribute_to_latest_info.jpg]]
 
[[File:0007_add_folder_attribute_to_latest_info.jpg]]
 +
 +
When you do those points and put your game content to folder/archive you and you don't want to support exact patches you can skip next points and go to "Uploading" part.
 +
 +
In case you have data that supports one exact update you need to create folder or archive where you will store the content.
 
[[File:0008_create_folder_for_122_content.jpg]]
 
[[File:0008_create_folder_for_122_content.jpg]]
 +
 +
Open your text editor and do exatly the same steps as you did while adding definition for latest patch. (Besides different folder and unit name)
 
[[File:0009_add_new_unit_to_versions_sii_with_122_content_step_1.jpg]]
 
[[File:0009_add_new_unit_to_versions_sii_with_122_content_step_1.jpg]]
 +
 +
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.
 
[[File:0010_add_new_unit_to_versions_sii_with_122_content_step_2.jpg]]
 
[[File:0010_add_new_unit_to_versions_sii_with_122_content_step_2.jpg]]
 +
 +
In case you want to support more than one exact version you need to setup folder for it.
 
[[File:0011_create_multiversion_folder.jpg]]
 
[[File:0011_create_multiversion_folder.jpg]]
 +
 +
Add again the same definition for the unit.
 
[[File:0012_add_another_unit_to_versions_sii.jpg]]
 
[[File:0012_add_another_unit_to_versions_sii.jpg]]
 +
 +
Add compatible_version value for one patch you support.
 
[[File:0013_add_first_version_attribute.jpg]]
 
[[File:0013_add_first_version_attribute.jpg]]
 +
 +
And add again compatible_version value for second patch you want to support.
 
[[File:0014_add_second_version_attribute.jpg]]
 
[[File:0014_add_second_version_attribute.jpg]]
 +
 +
=Uploading=
 +
  
  
 
=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 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.
 
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.
 +
 +
=OLD=
 +
# Create folder where you will put your mod content.
 +
# Put version specific content into appropriate folders - you can zip those folders. '''TODO: What are those "appropriate" folders?'''
 +
# Create file called [[Tools/Workshop_Uploader/versions.sii|versions.sii]] where you put [[Units/package version info|package version info]] units. '''TODO: Describe how to write this definition file with some examples'''
 +
# When you prepare everything launch SCS Workshop Uploader tool from your Steam Client.
 +
# Select the game which will be the target application for your workshop creation.
 +
# In "Mod data" section
 +
## Select folder with your mod content. You need to select the root folder of your mod this where you have placed your versions.sii file and version folders or archives.
 +
## Browse for preview image. The maximum size of the file is '''1 MB'''.
 +
# In the next section
 +
## fill the Mod name (maximum 128 characters)
 +
## select visibility state (if the mod is private, friends only or public).
 +
# In "Description" section fill your mod description - the minimum amount of characters is 50 characters - maximum is 8000. (We count one byte as characters so in case you are using multibyte characters it will count as more than one (also new lines, spaces count as character))
 +
# In "Tags" section
 +
## You '''MUST''' select Type of your mod
 +
## Truck parts and Brand are optional
 +
# In "Change note" you specify changelog of new mod version - in this case you can leave it empty or simply write there something like "Initial release" or "First version release".
 +
# When you are done you can press Upload button. In case validation failed or some different problem happened you will be informed by proper dialog.
  
 
[[Category:Tutorials]]
 
[[Category:Tutorials]]
 
[[Category:TODO]]
 
[[Category:TODO]]

Revision as of 15:25, 21 January 2016

Preparing mod

To upload mod to Steam Workshop you need to setup few new files and folders your mod. Steam Workshop mods have ability to be compatible with multiple versions so you need to define which data game should use.

First step of preparing your mod to be sent to Steam Workshop is creation of folder where you will store your mod data. File:0001 create folder.jpg 0002 create folder.jpg

When you create the folder open it and create another folder called latest (the name can be different however we recommend calling it latest) - in this place you will put data files of your mod that will be compatible with latest game patches. Instead of folder you can also create ZIP archives with game data. 0003 create latest folder.jpg

Open text editor and create file called versions.sii - save it in the same folder where you created latest folder 0004 open text editor and create versions sii.jpg

Add magic and global scope to your versions.sii file. 0005 fill versions sii with magic and global sii scope.jpg

Add definition of latest version. 0006 add package version info for latest version.jpg

Set value of the attribute called folder which is the name of the folder or ZIP archive with the data. 0007 add folder attribute to latest info.jpg

When you do those points and put your game content to folder/archive you and you don't want to support exact patches you can skip next points and go to "Uploading" part.

In case you have data that supports one exact update you need to create folder or archive where you will store the content. 0008 create folder for 122 content.jpg

Open your text editor and do exatly the same steps as you did while adding definition for latest patch. (Besides different folder and unit name) 0009 add new unit to versions sii with 122 content step 1.jpg

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. 0010 add new unit to versions sii with 122 content step 2.jpg

In case you want to support more than one exact version you need to setup folder for it. 0011 create multiversion folder.jpg

Add again the same definition for the unit. 0012 add another unit to versions sii.jpg

Add compatible_version value for one patch you support. 0013 add first version attribute.jpg

And add again compatible_version value for second patch you want to support. 0014 add second version attribute.jpg

Uploading

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 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.

OLD

  1. Create folder where you will put your mod content.
  2. Put version specific content into appropriate folders - you can zip those folders. TODO: What are those "appropriate" folders?
  3. Create file called versions.sii where you put package version info units. TODO: Describe how to write this definition file with some examples
  4. When you prepare everything launch SCS Workshop Uploader tool from your Steam Client.
  5. Select the game which will be the target application for your workshop creation.
  6. In "Mod data" section
    1. Select folder with your mod content. You need to select the root folder of your mod this where you have placed your versions.sii file and version folders or archives.
    2. Browse for preview image. The maximum size of the file is 1 MB.
  7. In the next section
    1. fill the Mod name (maximum 128 characters)
    2. select visibility state (if the mod is private, friends only or public).
  8. In "Description" section fill your mod description - the minimum amount of characters is 50 characters - maximum is 8000. (We count one byte as characters so in case you are using multibyte characters it will count as more than one (also new lines, spaces count as character))
  9. In "Tags" section
    1. You MUST select Type of your mod
    2. Truck parts and Brand are optional
  10. In "Change note" you specify changelog of new mod version - in this case you can leave it empty or simply write there something like "Initial release" or "First version release".
  11. When you are done you can press Upload button. In case validation failed or some different problem happened you will be informed by proper dialog.