Reference

Settings

Terrain Sampler works with no setup. These settings are for changing the map you pick from, or where road data comes from.

Open them at Edit → Project Settings → Plugins → Terrain Sampler. They're saved per project.

Basemap

The basemap is the map you browse in the picker. It's only for choosing a location: it never ends up in your level.

SettingDefaultWhat it does
Tile Url Templatehttps://tiles.openfreemap.org/styles/positronA MapLibre style URL, or a raster tile template containing {z}/{x}/{y} and an optional {key}.
Tile AttributionOpenFreeMap creditThe credit shown in the map corner. Update it if you change provider.
Tile Max Zoom19The deepest zoom level the provider serves (1–22).
Grayscale BasemapOffDesaturates a color basemap to match the tool's look. The default map is already gray.
Tile Api KeyblankReplaces {key} in the template, for providers that need one.

The default, OpenFreeMap, is free for commercial use with no key and no request limit. You don't need to change it.

Switching provider? Use one you're licensed for. Map tile requests come from your editor, under your account with that provider. Don't point this at OpenStreetMap's own tile servers: their usage policy requires a custom User-Agent that the embedded browser can't send.

Map Data

SettingDefaultWhat it does
Osm Data RootTerrain Sampler's map data serverWhere road data is downloaded from. Leave this alone unless support asks you to change it.
Osm Data RegionusThe region's data under the root.

If you've changed these and generation starts failing, select the setting and use the reset arrow next to it to restore the default.