Help

Troubleshooting

Most failures are a network hiccup, and Retry fixes them. Retry resumes from the stage that failed and keeps everything already downloaded.

Generation errors

Location outside the USThis location is in Canada. Terrain Sampler covers the United States only, so pick a location inside the US.

Elevation and road data cover the United States only, so Terrain Sampler checks the country before downloading anything. Nothing in your level is changed.

Press Back to Picker and choose a place inside the US. Near a border, move the reticle so its center is on the US side.

Couldn't get elevationCouldn't get elevation for tile 1 of 4 from USGS. The service may be busy, or your connection may be down: press Retry in a minute. The Output Log has the details.

The USGS elevation service was busy or unreachable, even after Terrain Sampler tried each request again automatically. Check your connection, wait a minute and press Retry. Tiles already downloaded are kept.

Can't reach the map data serverCould not reach the map data server. Check the internet connection and retry.

Check your connection, then press Retry. On a studio network, make sure a firewall or proxy isn't blocking the editor's web requests.

If you see The map data server returned HTTP … instead, the server is briefly overloaded. Wait a moment and retry.

A map data cell was unreadableA map data cell was unreadable. The data download may be corrupt; retry, or check the Map Data setting.

A download was cut off. Press Retry. If it keeps happening, check that Map Data is still on its default.

Map data folder not foundMap data folder not found: … Check Project Settings > Terrain Sampler > Map Data.

Osm Data Root has been changed to a folder that doesn't exist. Reset it to its default in Settings.

The area is invalid or too largeThe area is invalid or too large for the map data cells.

Pick a footprint from the tile buttons (1, 4 or 9 tiles). If you used the TerrainSampler.Generate console command, check the coordinates: they're MinLat MinLon MaxLat MaxLon, in that order.

Tile has no usable heightmapTile 2 of 4 has no usable heightmap. Return to the picker and generate again.

An elevation download came back incomplete. Close the progress screen, return to the picker, and generate again.

Roads weren't builtRoads were not baked; rebuild the landscape to include them.

Roads are graded into the terrain while the landscape is built, so they can't be added afterwards. Generate again with Roads on, and choose Yes to replace the existing terrain.

“No roads found”

That area has none mapped in OpenStreetMap. That's normal in wilderness. The terrain is still built.

Highways, ramps or bridges look wrong

Roads are built from OpenStreetMap and public elevation data, and highways are only as accurate as that data. Ordinary streets are well mapped. Freeway interchanges, ramps and bridge decks depend on how each one is mapped: where OpenStreetMap draws a ramp in the wrong place or the elevation data has no reading of a deck, the deck can be lumpy, hump over the road below, or leave a short piece floating.

Searching too quicklySearching too quickly. Nominatim allows one request per second.

The place-search service allows one search per second. Wait a moment and press Go again.

Search finds nothing, or the wrong place

Add a state, e.g. Springfield, Illinois rather than Springfield. You can always pan and zoom the map by hand until the reticle is where you want it.

Could not reach the geocoding service means search is offline or blocked. Picking on the map still works.

The map is blank or gray
  • Check your internet connection. The basemap streams in as you browse.
  • If you changed Tile Url Template, reset it to the default.
  • Make sure the engine's Web Browser plugin is enabled in Edit → Plugins. Terrain Sampler turns it on automatically, but a project can override that.

In the editor

There's no Terrain Sampler menu

Open Edit → Plugins, search “Terrain Sampler”, make sure it's Enabled, and restart the editor.

The Generated folder keeps growing

Use Terrain Sampler → Delete Unused Generated Meshes…. See Cleaning up old meshes.

Big cities are slow to build or cook

Dense downtowns produce a lot of road geometry. 9 tiles of a big city can take 5 minutes or more and over 20 GB of memory. Start with 1 tile, and use 9 tiles for less dense areas. If navigation warns about large collision meshes on sidewalks, you can exclude TerrainSampler_RoadDetails from navigation.

A road stops at a hillside

That's a tunnel. Terrain Sampler builds the ground, so it leaves out tunnels that run under a hill, and the road on either side stops square at the portal. The cut at a tunnel portal is real: it's in the USGS elevation. Bridges and overpasses are built as concrete decks on piers, and underpasses are built like any road.

Sky shows past the edge of the level

The generated ground ends at the edge of the area you picked, so a low or wide camera can see past it. Frame shots looking inward, pick a larger footprint, or add a large flat plane just under the lowest ground as a stand-in horizon.

Still stuck?

Email support.rrinc@gmail.com. We acknowledge every message within 24 hours. To help us fix it fast, include: