The workshop is basically a marketplace to share content, making it a nice fit for rFactor 2. For users it’s a great way to add new content easily, as all they need to do is subscribe to that content and it will get downloaded, installed and updated automatically. For content creators (mod teams) it’s a great way to share their content as Steam will provide them with all the bandwidth they need and creating and updating workshop items is relatively straightforward. This guide is for mod teams that create content and want to publish it.
Before you can publish anything, you need to create the car or track and package it like you normally would for rFactor 2. This is a complicated process that will not be discussed here. At this point in time we assume you already have one or more packages that you want to publish in the workshop. Furthermore, you have to have a Steam account that satisfies the following conditions:
- Your account has to be at least "level 1".
- You need to have accepted the Steam Subscriber Agreement.
- You need to have bought a copy of rFactor 2 on Steam (you don't need an on-line subscription, just the base simulation).
Setting up SteamCMD
You need to download a small tool called SteamCMD. If you’ve ever downloaded dedicated server packages on Steam, you might be familiar with it. Instructions on how to download and install it can be found here: https://developer.valvesoftware.com/wiki/SteamCMD
Publishing and Updating
Create a new folder somewhere on disk where you’re going to keep all your workshop related content. I propose a structure somewhat like this:
The preview.jpg is actually a small preview image that will be shown in the workshop. You can later add more images or videos manually. The
MyCoolTrack-v1.rfcmp is just a normal component which you create like you always do with the rFactor 2 modding tools. The only thing you need to then do is create a textfile called
metadata.vdf which contains the following text:
That’s all you need in terms of setup. Going over each line in the file:
- appid is the unique identifier for rFactor 2, so there is no need to change this;
- publishedfileid should be zero for all new items and after running SteamCMD once, that tool will fill out a unique identifier for your workshop item, which use can use to update this item later;
- contentfolder must contain an absolute path to a folder with all the content for this item and the convention we use for rFactor 2 is that you can put one or more components in that folder that get installed automatically by the package manager;
- previewfile points to an image that will be shown in the workshop;
- visibility can be left at zero, which means your item is visible to the public ("1" makes it visible to friends only and "2" makes it private, so only you and other co-creators can see it);
- title is the title of the item in the workshop;
- description is a multi-line description of your item and can contain some “bbcode” for formatting;
- changenote is a message that is specific to the version you are uploading and normally includes a version number and a change log.
If everything is setup, open a command shell and run SteamCMD like this (you should probably make a small batch file for it that you can quickly re-run):
One word of warning here. If you use the same
PASSWORD to log into the Steam Client on the same computer, there seem to be some unwanted interactions between those two accounts. Therefore, in that case, please quit your Steam Client while SteamCMD is running!
Watch the output for any errors. If everything worked you should be able to view your item in the workshop and others can subscribe to it. More details can be configured using the Steam Client of website of Steam.
That's it. You can further enhance your workshop item in the web interface where you can add further screenshots, movies and many other things that you cannot do with the command line tool.
Updating your item is also simple. Just make changes to the content folder and the metadata file and re-run the command to update your item.