Unreal Engine 5 Documentation has been moved to the Epic Developer Community

Unwrapping UVs for lightmaps is time-consuming and one way you can mitigate this is to use Unreal Engine 4's (UE4) auto-generation tool to generate a lightmap UV from your existing texture UVs on import or through the Static Mesh Editor .

Caveats and Considerations

By default, an auto-generated lightmap UV repacks the existing UV charts from the static mesh's first UV (UV Channel 0 in UE4). This UV is commonly used as the texture UV, so it's possible that the UV charts aren't laid out or set up in a way that is best suited for a lightmap UV, even with the auto-generation tools in UE4.

Consider the following when creating an auto-generated lightmap UV.

• Generated lightmap UVs require an existing source UV to repack and that process is only as good as the UV used meaning that if the UV charts aren't broken up and properly laid out, a good repack will not be possible.

• During repacking, UE4 will not split UV chart edges to create separate UV islands. It only repacks the existing UV charts from the source UV index.

• UV charts are normalized when generated over maximizing coverage of the UV space with independently scaled or stretched charts.

Import Options Settings

During import, a lightmap UV will be generated for any static mesh by default when Generate Lightmap UVs is enabled. The lightmap UV will be generated from UV Index 1 of your Static Mesh (UV Channel 0 in UE4) and assigned to Lightmap Coordinate Index 1.

Lightmap Generation Settings

The Static Mesh Editor Build Settings contains settings to generate and repack lightmap UVs. These options enable you to generate a lightmap UV without having to do so during import or post import if you want to refine the generated lightmap UV.

Enable Generate Lightmap UVs to use the UV generation options detailed below in the table to control how the Lightmap UV is generated and repacked:

Generating a Lightmap UV

The following steps walk through the process of generating a new lightmap UV from the Static Mesh Editor.

1. Open the Static Mesh Editor . In the Details panel, navigate to the Build Settings of LOD0 .
   

   Click image for full size.

2. Generate lightmap UVs with the following settings:
   

   • Enable Generate Lightmap UVs .

   • Set the Min Lightmap Resolution to an ideal power of 2, which should be the lowest lightmap resolution that this mesh would ever use. This ensures that less light and shadow artifacts might affect the UV charts.

   • Typically, the Source Lightmap Index should be left on 0 or set to an existing UV channel to generate the lightmap UV from. Only available UV channels will be available to choose from.

   • The Destination Lightmap Index sets the UV channel to create or store the lightmap UV in. It can be any value (where value represents the actual number of current UV channels for this Static Mesh) plus one.

3. Click Apply Changes .

4. In the Details panel under General Settings , set the following:
   

   • Enter a Lightmap Resolution that this static mesh should use by default for any instances placed in a level. The resolution entered should be higher than the Min Lightmap Resolution used for generating the lightmap UV in the Build Settings .

   • Set the Lightmap Coordinate Index to the UV channel being used for your Lightmap UV. Typically, this should match the Destination Lightmap Index used to generate the lightmap UV in the Build Settings . This UV channel dictates which UV channel is used when generating the lightmap textures during a lighting build.

In this example, the texture UV has been used to create a new lightmap UV. The texture UV is used as the source to repack for the lightmap UV, and the Texture UV has been laid out in a way that works best not to waste any texture space. With that approach, parts of the mesh are scaled larger (or smaller) based on their importance to get adequate texture resolution without wasting space in the texture.

When the lightmap UV is generated, it is scaled to have the same density (normalized) and then packed into the UV space with enough padding between each UV chart to avoid light and shadow artifacts from a light build. Here, you may notice a little bit of wasted space in the generated lightmap UV, however, this is negligible and would not justify reworking the UV in a custom tool just to make it use this space.

Regenerating Existing Lightmap UVs

Regenerating (or repacking) an existing lightmap UV can be performed using the Static Mesh Edtior's Build Settings . There are benefits to regenerating a lightmap UV for a Static Mesh.

• It enables you to change the padding between UV charts to use a higher or lower Min Lightmap Resolution without reimporting the mesh. This is most ideal when you have a lot of individual UV charts and gets a tighter pack in the lightmap UV.

• It enables you to repack any existing lightmap UVs from any Source Lightmap Index , including a previously generated lightmap UV channel.

The following steps demonstrate regenerating a custom UV from an imported static mesh:

1. Open the Static Mesh Editor . In the Details panel, navigate to the Build Settings of LOD0 to set the following options:
   

   • Optional Set the Min Lightmap Resolution to a new value that is higher or lower. This adjusts how much padding should be between the UV charts.

   • Set the Source Lightmap Index to the UV channel you want to re-pack

   • Set the Destination Lightmap Index to be the same one as the Source Lightmap Index.

2. Click Apply Changes .

Below is a comparison of the custom lightmap UV that was originally imported with the static mesh. You'll notice that the UV charts have been disproportionately scaled to one another, but it's perfectly acceptable as a lightmap UV because it meets the criteria for no overlapping UVs. Regenerating the UV will normalize all the UV charts for an evenly distributed light and shadow bake result. Each UV chart will also be given an appropriate amount of padding between them to ensure less shadow and light leaking artifacts.