ThunderWheels

ThunderWheels

Not enough ratings
HOWTO - Upload & update items in the Workshop
By dukkenuken1 and 2 collaborators
Learn how to create and update items in our Steam Workshop (cars & tracks).
   
Award
Favorite
Favorited
Unfavorite
Getting started
First thing you will need is the ThunderShop application. This application is distributed with the game and it can also be added to your Steam library for convenience.

ThunderShop is also our track editor but it can be used for creating, uploading and/or updating workshop items. Currently there is only two types of items supported in ThunderWheels game: Tracks and Cars.
You will also need a text editor !
Creating a new workshop item Part #1
Usually a game item needs many files (meshes, textures, etc), in order to create and upload/update an item all those files must be located inside a directory. Directory name doesn't have any importance. This directory will be used as a "jail" to enclose and upload everything inside it, so this directory should only contain needed item files and an special file named: workshop_item.cfg

Suppose you have created a new track named: "tierra del fuego", you will have these files:
tierra_del_fuego_thumbnail.jpg
tierra_del_fuego_terrain.jpg
tierra_del_fuego_hm.png
tierra_del_fuego_friction.png
tierra_del_fuego.track

Now, navigate to tracks directory, usually located at:
C:\Program Files (x86)\Steam\steamapps\common\ThunderWheels\media\tracks



We assume you have tested the track (or car, or any other item you plan to submit) directly in the game. If that is true, then your track should be in the track folder Now select all files listed above, press Ctrl+X (cut), navigate to the directory: workshop_example and press Ctrl+V (paste).

You have moved those 5 files needed for your "tierra del fuego" track, so workshop_example directory should look like this:



Have you noticed the file workshop_item.cfg inside that folder ? Well that file was there because we are nice guys and we though you will need it :)

Go to the folder and open the file with a text editor. We love using Notepad++ (it is free and open source). By opening the file you will notice that almost ALL parameters there are explained so I'll not go into details here. Change those parameters to this:

(of course replace the item name and type with the one you really want)
item_id = 0 item_type = track item_subtype = dirt asset_name = tierra_del_fuego item_title = Tierra del fuego item_description = My first track in the workshop, WOW item_visibility = public

I will only comment item_id, this parameter must be ZERO when your intention is to create a NEW workshop item. In the next part of this guide we will ask Steam to generate a valid item_id, so for now just save the file but keep it open in the text editor.
Creating a new workshop item Part #2
Ok, we assume you have read and followed all the contents in the Part #1 right ? If that is true, you should have a valid folder containing a valid workshop_item.cfg you have edited and saved using a text editor.

Now just open the ThunderShop application using the Steam client (or by navigating to game root folder and looking for GBEditor.exe (sic)).

Once in the ThunderShop application press the button Workshop, it will open the Workshop tool:



By default the tool will work with the workshop_example directory but if for any reason you moved your track "tierra del fuego" to a different directory, just press the button "Browse" and pick the right one. Remember the tool will not work if the file workshop_item.cfg isn't in the selected directory or if there is any error (missing files for example).

From now on if you see any error in the Steam Log, read it and fix the error before continuing.

Let's press the button "Create empty item", a pop up will appear showing a warning, press YES to continue. Now the tool will validate the contents in the workshop_example directory (or the one you picked using the Browse button) and if everything goes well you'll see in the log this message (be patient, some times is takes a few minutes to finish):



We didn't upload any file yet, but we are almost there !
Do you remember I told you not to close the file workshop_item.cfg ? Ok, go to the text editor and replace the item_id value with the number you see in your Steam Log.
Save the workshop_item.cfg and you are ready. Now press the button "Upload / Update", it will actually upload the track files to Steam using the previously generated item id.

If everything goes well you'll see this (wait until finish, a few minutes):


Have you seen the blue text saying "Open item on Steam" ? if you press the link it will open a web browser for you to edit the item description in the Steam Workshop web page.

Important
Now you have a valid item directory (a track and all the needed files + the workshop_item.cfg with the corresponding id generated by Steam) you should copy/paste this directory and rename to something like "tierra del fuego track" inside the tracks directory:


In that way, once you want to update the track with any changes you have made you will just overwrite only the track files. There is no need to edit the file workshop_item.cfg inside "tierra del fuego track" directory again (explained in the next section).

Recomendation
Before going to the next section, leave the directory workshop_example clean, by deleting everything except the file workshop_item.cfg, edit the file there and set item_id to -1, so the next time you want to create a new item you just start over again :)

Updating an existing item
Continuing with the example in the previous sections we will update our "tierra del fuego" track.

Updating an item requires having a directory with a correct workshop_item.cfg file containing a valid item_id, all the item assets (textures, etc) so the easiest way is to always use the same directory you used for creating and uploading the item for the first time. Or..... just subscribe to the item in the Steam Workshop website and navigate to the installation folder of that item.
Usually looks like this:
C:\Program Files (x86)\Steam\steamapps\workshop\content\296790

296790 is the application id for ThunderWheels game. Inside this directory you should see other sub-directories containing the items. Look for the one you have uploaded.

Anyway, In the previous section we made a backup containing "tierra del fuego" track, click "Browse" button and select it:



Replace the files you want to update inside that directory and hit update button:



After a few minutes you should see a message saying "SUCCESS" in the log.
Final words
ThunderWheels game will give priority to the items inside the "oficial" directories.

For example, if you have "tierra del fuego track" inside the official tracks directory, usually located at:
C:\Program Files (x86)\Steam\steamapps\common\ThunderWheels\media\tracks

The game will always load "tierra del fuego track" contained in the tracks directory and ignore the item "tierra del fuego track" from the workshop.
3 Comments
dukkenuken1  [author] 10 Jul, 2018 @ 12:00am 
Ok, we will make a video ;)
Zomby 9 Jul, 2018 @ 8:26pm 
Man, wish I was a bit more adept and knowledgable with this stuff. Guess I need a video to follow along with as well as written directions to get the hang of this.

Can you make a video?
sanduoge 31 Jan, 2018 @ 4:28am 
KABUDONG