Getting started

Quick start

Install the plugin, pick a place, and hit Confirm. Your first level takes about five minutes, most of it download time.

Requirements

Install

  1. In the Epic Games Launcher, open Fab Library, find Terrain Sampler, and click Install to Engine.
  2. Open your project and go to Edit → Plugins. Search for “Terrain Sampler”, tick Enabled, and restart the editor.
  3. A Terrain Sampler menu now appears in the editor's main menu bar.

Generate your first level

  1. Open the tool. Choose Terrain Sampler → Open Terrain Sampler.
  2. Find your place. Type a location such as Santa Monica or Moab, Utah and press Go. The map flies there. You can also pan and zoom the map by hand.
  3. Choose the footprint. Pick 1, 4 or 9 tiles. Each tile is 2 km on a side, so that's 4, 16 or 36 km². The reticle stays in the middle of the map, so drag the map until the area you want sits inside it. The readout under the map shows its center and size.
  4. Pick modifiers. Toggle Roads, Road markings and Textures. The Expected Output box tells you exactly what will be built.
  5. Confirm. Press Confirm Selection. A checklist shows each stage as it fetches and builds. When it finishes, the camera frames the new terrain.
  6. Play. Press Play. You spawn at a PlayerStart in a real street lane. If the level already had a PlayerStart (the Basic template has one), Terrain Sampler offers to delete it, because Unreal picks one at random when there are several.
The Terrain Sampler picker with a 4-tile footprint over Telluride, Colorado and Roads switched on.
The picker: tile count on the left, search and map in the middle, modifiers and the expected output on the right.

Save the level when it's done. The generated meshes are saved as they're built, but the landscape and actors live in your level until you save it.

What happens during generation

The progress screen runs these stages in order. Stages you switched off are skipped.

The progress screen partway through a run, fetching elevation tile 3 of 4.
Stages you switched off are grayed out.
StageWhat it does
Fetch elevationDownloads USGS 3DEP heights for each tile.
Fetch roadsDownloads OpenStreetMap roads, crossings and stop lines for the footprint, plus measured lidar heights for its highways, ramps and bridges.
Build landscapeCreates one landscape per tile (1009 × 1009 vertices) and grades the roads into the terrain.
Apply materialAssigns the landscape material: asphalt, grass, rock and concrete.
Generate roadsAdds lane markings, curbs, sidewalks and parkways, bridge decks and retaining walls, plus the PlayerStart.

If a stage fails, the progress screen shows why and offers Retry. Retry resumes from the failed stage and reuses everything already downloaded.

Generating again in the same level

If the level already holds Terrain Sampler terrain, you'll be asked what to do with it:

Terrain Sampler only ever removes terrain it made itself. Anything you built by hand is left alone.

Tips