Docs menu

Unreal Landscape heightmaps

16-bit PNG heightmaps sized for Unreal Engine Landscape, with the import steps written for you.

The Unreal export writes the terrain’s heights as 16-bit greyscale PNG heightmaps for Landscape mode’s Import from File. In the app, choose Export Unreal heightmap… in the Export tab.

What it writes

Next to <name>.png the export writes:

  • <name>_unreal.txt: the import steps, with every value to type in.
  • <name>.json: the same settings, for scripts.

Sized for Landscape

A landscape is a grid of components, so its resolution is components × quads + 1 vertices on each side. The export picks the nearest such resolution at or finer than the project’s mesh spacing, so every pixel is a landscape vertex and the area’s edges are the landscape’s edges. By default a component is 2 × 2 sections of 127 quads, the size Epic recommends for large landscapes. You can change it in the app.

Tiles for World Partition

A heightmap larger than the tile limit (4096 px by default) is split into equal tiles named <name>_x<column>_y<row>.png. Unreal offers to read them as one image.

Importing

The steps file has the exact numbers for your area. In outline:

  1. Open a level without World Partition, for example File › New Level › Basic. Unreal 5.7 and later import a heightmap into a World Partition level wrongly, repeating one part of it across the landscape.
  2. Enter Landscape mode (Shift+2). In the Manage tab choose New, then Import from File.
  3. Choose the heightmap, or any tile of a tiled one, and answer Yes when Unreal asks whether to use the tiled image path. Leave Flip Y Axis off.
  4. Type in the location, scale, section size and number of components from the steps file.
  5. Check that Overall Resolution matches the steps file, then choose Import.
  6. To stream the landscape with World Partition, convert the level afterwards with Tools › Convert Level.

Heights and axes

Every vertex sits at its true elevation, in centimetres, as Unreal uses them. Z = 0 is 0 m in the elevation data’s datum: the EGM2008 geoid for COP30, EGM96 for SRTMGL1. +X is the area’s east and +Y its south.