> For the complete documentation index, see [llms.txt](https://docs.sollumz.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sollumz.org/documentation/fragments.yft/vehicle-setup/paint-colors.md). # Paint Colors Paint layers determine which of the vehicle's paint colors a material is tinted with in-game: the **Primary** color, **Secondary** color, **Pearlescent** color, **Wheel** color, **Interior Trim** color or **Dashboard** color. To select the paint layer for a material, select the mesh object, then navigate to `Material Properties > Sollumz > Fragment (Vehicle Paint)`.

Material Properties > Sollumz > Fragment (Vehicle Paint)

This panel only appears on materials that use a `VEHICLE` shader.

Paint Layer	Description
`Custom - Not Paintable`	Cannot be painted at mod shops. The `matDiffuseColor` parameter is used as the paint color RGB values.
`Default - Not Paintable`	Cannot be painted at mod shops. White is used as the paint color, or grey when the vehicle is scorched.
`Primary`	Use the Primary paint color.
`Secondary`	Use the Secondary paint color.
`Pearlescent`	Use the Pearlescent paint color. Note this does not apply the pearlescent effect, it simply paints the material with the pearlescent color.
`Wheel`	Use the Wheel paint color.
`Interior Trim`	Use the Interior Trim paint color.
`Dashboard`	Use the Interior Dashboard paint color.

The paint layer is not stored as a separate parameter, it is just a friendly way of setting the material's `matDiffuseColor` value parameter, which is what the game actually reads. When you choose a paint layer, Sollumz appends it to the material name (for example `vehicle_paint1 [PRIMARY]`) so you can tell at a glance how each material will be painted. `Custom` and `Default` add no suffix. {% hint style="info" %} Not all vehicle shaders are paintable. If you are trying to set up a paintable vehicle material and the paint layer selector is greyed out with the "Not a vehicle paint shader. Shader must have a matDiffuseColor parameter." message, then you need to use a different shader. Typically you'd want to use a `vehicle_paint` shader for the body of a vehicle. {% endhint %} #### Previewing paint colors To see what the paint layers look like in the viewport, select the Fragment root object and navigate to `Object Properties > Sollumz > Vehicle Render Preview`. There is a color picker for each paint layer, along with dirt and light emissive settings. These colors only affect how the vehicle looks in Blender's Material Preview and Rendered viewport shading modes. They are not exported and have no effect in-game.

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.sollumz.org/documentation/fragments.yft/vehicle-setup/paint-colors.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.