Page Info
Engine Version:

Mesh Paint User Guide

Choose your OS:

Mesh Paint Mode provides a quick and easy way of adjusting color and texture on your meshes. The following sections cover all of the critical skills you will need to make the most out of this powerful tool.


The Mesh Paint tool allows you to paint vertex colors on Static Meshes interactively in the level viewport. You can paint multiple instances of a single mesh with unique color/alpha values, and use that data however you would like in your materials.

Color data can be visualized directly, and you can easily edit multiple meshes at the same time. Also, the tool has special features for painting "blend weights" that allow you to interpolate between multiple textures per-pixel.


The Mesh Paint tool relies on a pair of colors for its work. Users may choose a Paint Color as well as an Erase Color and swap between them at any time. Color selections are made by way of a standard Color Picker window .


Painting on meshes is easy! The first thing to remember is that you can only paint on selected meshes. This helps you restrict painting to only specific objects, while still allowing you to paint across multiple selected Mesh Actors if necessary.

To select multiple Mesh Actors, hold Shift and press the Left Mouse Button to select and add a mesh.

While Mesh Paint mode is active, the selected Actor will be outlined and denoted with a red crosshair (if multiple meshes are selected, each mesh will be highlighted and the crosshair will appear on the last mesh selected). After selecting one or more meshes, when you move the mouse over them, you should see the circular paint brush!


The Mesh Paint tool is a brush-based system. Using the included settings, you can establish a brush designed for wide areas or fine details. It is important to keep in mind, however, that as the nature of the tool is to paint color onto actual vertices, you will often need to make settings adjustments based on the vertex density of your mesh.


Mesh Paint Mode includes a variety of different view modes to aid in visualizing how vertex color is being applied to your meshes within the viewport. The view can display just the vertex colors, or can selectively view individual channels (red, green, blue, and alpha).

Advanced Topics

Although using the Mesh Paint tool is extremely easy and intuitive, there are some important considerations to think about, particularly in how you want to affect your meshes. Mesh Paint can handle painting on individual level-placed instances of meshes and can also be used to paint weight values for multi-texture setups. These topics are all discussed below.

Setting up Materials

The mesh paint system requires the material of the mesh to contain a Vertex Color expression as this is how the vertex color data is passed from the mesh to the material. The following sections cover ways to set up a material so that it can be used with Mesh Paint mode.