Multi-paint setups

The multi-paint setup consists of up to 3 paint entries, and the set name. Each paint gets applied to its respective color palette , allowing all of the available paint colors to be set when spawning a vehicle.

Picking the multi-paint setup when spawning a vehicle.

Multi-paint setups appear in their own tab in the paint menu of the vehicle configurator. Multi-paint setups in vehicle configurator.

Defining multi-paint setups

Multi-paint setups can be defined either in a paint library , or in the main info.json file of a vehicle. In both cases, the definition looks the same:

"multiPaintSetups" : {
  "team_offroad_colors" : {
    "name": "Orange Race Colors",
    "paint1": "signal_orange",
    "paint2": "palladium_gray",
    "paint3": "black_diamond"
  },
  "rennspecht_green_colors" : {
    "name": "Rennspecht Green Colors",
    "paint1": "rennspecht_green",
    "paint2": "palladium_gray"
  },
  (...)
}

The keys “paint1”, “paint2” and “paint3” refer to the Paint IDs of the paints that will be applied for the 1st, 2nd and 3rd color palette respectively. If the setup is defined inside the paint library file, the paints must be library paints too. When defining it inside an info.json file, they can also be standard paints, in which case the paint names are used instead of IDs. If paint2 or paint3 is not defined, paint1 will be used for that color palette instead.

A vehicle’s info.json file can use both its own multi-paint setups and common ones from a paint library.

"multiPaintSetups": [
  "rennspecht_green_colors",
  "rennspecht_black_colors",
  "rennspecht_blue_colors",
  {
    "name": "Battlehawk Purple",
    "paint1": "Extra Purple",
    "paint2": "Satin Black",
    "paint3": "Satin Gray"
  },
  {
    "name": "Battlehawk Green",
    "paint1": "Goblin Green",
    "paint2": "Satin Black",
    "paint3": "Satin Gray"
  },
],

In both cases, all the paint colors from paint library must be declared in the libraryPaints section beforehand. They can be assigned with the custom class to prevent overcrowding the paint selector.

A multi-paint setup can contain only 1 paint, and have the same name as said paint, disguising itself as a paint option. This is useful for adding an option for selecting a single color paint for vehicles with a two-tone paint design equipped by default.

Using multi-paint setups as default

Both inside the vehicle’s main info.json file, and within the specific info_[config name].json file of any configuration, a multi-paint setup replaces the old “defaultPaintName1/2/3” values. The legacy method still works for backwards compatibility purposes, but the defaultMultiPaintSetup takes precedence. It can be used in one of the following ways:

• By providing the name of the multi-paint setup you have defined in info.json or imported from the library. For example: "defaultMultiPaintSetup":"Champagne". In this case, when spawning the vehicle via vehicle selector, this multi-paint setup will be highlighted.

The default multi-paint setup for the configuration is highlighted.

• By defining your own setup specific for this configuration. For example:

"defaultMultiPaintSetup":
{
  "name": "Turbo Race",
  "paint1": "Royal Blue",
  "paint2": "Solar Yellow",
  "paint3": "Solar Yellow"
}

In this case, the setup will only be visible in the multi-paint list with this specific configuration selected.

The default multi-paint setup getting added when selecting the custom configuration that uses it.

Modders are advised to completely replace the usage of the defaultPaintName syntax with the multi-paint setups.