Since Patch 10.2 we support an easy way to include vehicle related mods. There is now no need to unpack any boot pakfiles or use any tools to run the mods.
Three types of mods are currently supported:
- Full vehicle mods
- Custom liveries (more than one per vehicle)
- Tyre Mods
The vehicle and livery mods are registered with the game via a mods.txt file (example below). Tyre mods are via a tiremod.rg file. Both of these are placed in the game data root folder (same location as the exe)
Note: These instructions are how to register community created mods with the game, not how to create the mods themselves. See existing mods for examples.
Vehicles mods are registered via mods.txt by adding the crd entry along with sub entries to set the tyres and hud to use by the vehicle.
To add a vehicle the format is:
On loading the game will search for the vehicle mod CRD file and add it to the vehicle list, when the vehicle is selected it will attempt to load it. We have added overrides in code to allow loose loading of the following types when loading a vehicle mod:Code:(path to vehicle crd file) :tyres: (list of tyres that the vehicle can use) :hud: (vehicle name) } Only add one of :hud: or :hudmotec: :hudmotec: (vehicle name) }
Multiple vehicle mods can be registered via mods.txt, see the attached file for examplesCode:*VEHNAME*.cdfbin *VEHNAME*.edfbin *VEHNAME*.gdfbin *VEHNAME*.sdfbin *VEHNAME*.hdtbin Collision/*VEHNAME*.xml Collision/*VEHNAME*.joi.xml Collision/*VEHNAME*.sys.xml statistics/*VEHNAME*.mrdf vehicles/*VEHNAME*.vdfm *VEHNAME*.csd *VEHNAME*.cpt *VEHNAME*.cgp *VEHNAME*.cdv *VEHNAME*.cdp *VEHNAME*.vhf *VEHNAME*_cockpit.vhf *VEHNAME*.rcf *VEHNAME*_hr.rcf
This refers to adding custom liveries to non-mod vehicles.
Place the modified RCF in the data folder and then register it with mods.txt. That RCF will now be loaded instead of the default one in the game data. Note some vehicles look for a HR RCF file first, so that file will have to be modified and registered instead.
As an example the following lines can be added to mods.txt to override both of the livery RCF files for the Formula A
To add new tires, simply add the tiremod.rg in your root folder: tiremod.txt (rename to "tiremod.rg")
The file itself can have any new treads, carcasses, heat models, and tires. Any tire with the same name as an existing tire will be ignored. Any RECORD with the same name as an existing RECORD will be ignored.
For an example you can look at this test implementation and MDMTs R8 Mod