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.
| Setting | Default | What it does |
|---|---|---|
| Tile Url Template | https://tiles.openfreemap.org/styles/positron | A MapLibre style URL, or a raster tile template containing {z}/{x}/{y} and an optional {key}. |
| Tile Attribution | OpenFreeMap credit | The credit shown in the map corner. Update it if you change provider. |
| Tile Max Zoom | 19 | The deepest zoom level the provider serves (1–22). |
| Grayscale Basemap | Off | Desaturates a color basemap to match the tool's look. The default map is already gray. |
| Tile Api Key | blank | Replaces {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
| Setting | Default | What it does |
|---|---|---|
| Osm Data Root | Terrain Sampler's map data server | Where road data is downloaded from. Leave this alone unless support asks you to change it. |
| Osm Data Region | us | The 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.