Custom Liveries: How to Make an Update 'rfcmp' for League Use.

If you want to share custom liveries/teams for an online event, for example for an important league race, there are a couple of ways to do this.

  1. Use skin transfer: this means all clients will have to connect at some point to transfer their livery to all users via the dedicated server itself (see Sharing with Skin Transfer for further info)
  2. Create an 'update rfcmp' that you distribute to your league beforehand. This either gets manually installed or can be distributed via a workshop item. 

In this guide we will be focusing on method 2: Creating an 'update rfcmp'. 

Before getting started: What is an rfcmp?

  • Simply put, an 'rfcmp' is what we call a 'package' file, it contains the content you wish to install. This can be a track, a car, or even a custom showroom, and in the context of this guide a custom livery pack.

For our purposes here, we don't need to get into the details of what an 'rfcmp' is, all that's needed is a basic set of steps to create one, and then how to install and distribute it after.

The advantages of creating an 'update rfcmp':

  1. Drivers don't have to show up early to an event just to make sure their skins get uploaded and distributed on the live server.
  2. More control: admins can check all liveries and related files are working and make sure no mistakes were made by each driver when they set up their custom team
  3. Less load on the server, no skins are transferred by the server itself, and therefore it requires no extra bandwidth. All clients have the full content before joining the event. 

This method does require a little extra work, but once you get the hang of it should be relatively easy to keep doing.

Important

  • The base content you are creating an update rfcmp for, must be installed in rFactor 2. If it is not, this process won't work!


Part 1: Setting up the VEH files

The VEH file contains all of the details for any specific team.
Each custom team will have it's own veh file that contains

  • Car number
  • Team name
  • Driver name

Step 1:

  • Make a folder (on your desktop) with the name of the car you want to create an update for.

Example: 'Bentley League Updates'

Step 2:

  • Collect all of your custom livery files inside 'Bentley League Updates' folder (If you don't know how to create a custom livery see How to paint a car with the new material system)
    • <team-name>_region.JSON
    • <team-name>.dds
    • <team-name>WINDOWIN.dds
  • For this guide let's assume our car is called 'Studio397'
    • Studio397_region.JSON
    • Studio397.dds
    • Studio397WINDOWIN.dds

Step 3:

  • Open MAS2.exe → \Steam\steamapps\common\rFactor 2\Support\Tools
  • Double click on the MAS2.exe

Step 4:

  • Open the 'car-upgrade.mas' for the car you want to update (example Bentley)
  • Navigate to \Steam\steamapps\common\rFactor 2\Installed\Vehicles\Bentley_Continental_GT3_2017



  • Click and drag the file 'car-upgrade.mas' into the main window of the MAS tool



  • Select and highlight one of the VEH files and right click



  • Select 'extract' and save to 'Bentley League Updates' folder.

Step 5:

  • Rename the VEH <team-name>.veh
  • Using our example this would be Studio397.veh
  • This should be the same name as the corresponding DDS files

So now we have these files

  • Studio397.veh 
    Studio397_region.JSON
    Studio397.dds
    Studio397WINDOWIN.dds

Step 6:

  • Open <team-name>.veh (Studio397.veh) in a text editor
    change the following lines in the text

DefaultLivery="<team-name>.dds"
MaterialOverride="BentleyGT3_BaseMat.json"

Example:

DefaultLivery="Studio397.dds"
MaterialOverride="BentleyGT3_BaseMat.json"

IMPORTANT: Do NOT edit the line MaterialOverride!

  • Next edit the car details for your car:

Number=<my car number>
Team="<my team name>"
PitGroup="Group1"
Driver="<unique driver name>"
Description="Bentley Continental GT3 #<my car number>"
Engine="Bentley 4L V8"
Manufacturer="Bentley"
Classes="GT3, GT3_Bentley_Continental"

FullTeamName="Bentley"
TeamHeadquarters=""

Category="Bentley, Bentley Continental GT3"

Example:

Number=397
Team="Studio 397"
PitGroup="Group1"
Driver="Jefferson Bartholomew"
Description="Bentley Continental GT3 #397"
Engine="Bentley 4L V8"
Manufacturer="Bentley"
Classes="GT3, GT3_Bentley_Continental"

FullTeamName="Bentley"
TeamHeadquarters=""

Category="Bentley, Bentley Continental GT3"

  • Save and exit

Step 7

  • Repeat the above for all custom teams and make sure each team has it's own uniquely named VEH file.

Part 2: Packing the MAS file

Step 1:

  • Create a new folder inside 'Bentley League Updates' named "Bentley MAS files"

  • Open MAS2.exe again
  • Navigate to the folder 'Bentley League Updates'
  • Select all the contents of 'Bentley League Updates'
  • Drag the files into the main window of the MAS tool



Step 2:

  • Select all contents in the MAS tool window and click on the 'create mas' icon in the top bar



  • Save the MAS as Bentley_Myleague.mas in 'Bentley MAS files'


Part 3: Packing the 'update rfcmp'

Step 1:

  • Click on the filing cabinet icon and check where the working directory is set to. This will be where the rfcmp file will save to at the end of this guide.



  • The default location will always be \Steam\steamapps\common\rFactor 2\Packages

Step 2:

  • Note which EVEN numbered version of the Bentley you have installed (in this example v2.46)
  • Inside the folder 'Bentley League Updates' right click and select NEW -> Text Document



  • Rename the file Bentley_Myleague_v2.46MLA.rfcmp - (MLA is 'My League Abbreviation')

Step 3:

  • Open MAS again (if it's not already open)
  • If MAS is still open click on the white page above to clear the window 



  • Click on the box icon at the top 'Create the package file'

  • In the dialog click on 'Create Single rfcmp package' button.

Step 4: Select Component

  • In the first pop up window start with the top Selection 'Add New Component' by clicking on the paper icon


    This next step is very important!
  • Navigate to \Steam\steamapps\common\rFactor 2\Installed\Vehicles
  • Find the folder for the car you want to update
  • In this case Bentley_Continental_GT3_2017
  • Select and copy the folder name
  • Paste 'Bentley_Continental_GT3_2017' into 'Edit New Component Name' and click save

Step 5: Component

  • Next to the File drop down click on the file cabinet icon
  • In the browse pop up navigate to "....Bentley League Updates\Bentley MAS files"
  • Click on the file Bentley_Myleague_v2.46MLA.rfcmp and rename Bentley_Myleague_v2.47MLA.rfcmp and click OPEN



  • 1. In the left field 'Version' put in v2.47MLA 
    2. Check the box 'Update From'
    3. In the right text field "Update from:" enter v2.46 (notice this is the base even numbered version)



  • In the 'type' dropdown select Vehicle



  • In the bottom window click on the box icon



  • In the browse pop up navigate to "....Bentley League Updates\Bentley MAS files" and select Bentley_Myleague.mas


  • 1. Make sure your mas file shows in the window
  • 2. Last step click the Package button at the bottom and then Install
  • 3. Note you do not have to click 'Install', but we highly recommend you install the rfcmp to check it works in Single player before distributing to your league.




  • The rfcmp file Bentley_Myleague_v2.47MLA.rfcmp will be saved into \Steam\steamapps\common\rFactor 2\Packages 

    And that is it!