Here’s a rundown of the most common problems people run into with Teragon, along with their causes and fixes. Most causes trace back to either path settings or the order in which you build your maps. If you still can’t solve it, make use of the #discussions channel on the official Teragon Discord.
POIs aren’t placed / look wrong
Symptoms like the following almost always share the same cause = path settings.
- The town tiles are there, but no POIs are sitting on them
- Wilderness (wilderness/region) POIs are placed overlapping each other
- No thumbnail appears when you select or hover over a POI (note: you have to zoom in a little for it to show)
- Wilderness POIs are cut off at the edge of the map
- In-game, only the towns are raised higher than their surroundings, creating steps (cliffs) around the town
- Where a POI should be, there’s instead a square hole dug all the way down to bedrock
How to fix:
- Vanilla POIs don’t appear → Check that Game Directory points to the correct folder containing the game’s
.exe. - Custom POIs don’t appear → Check that Add Source Path correctly points to where your POIs are (your Mods folder, a subfolder of it, etc.). If it points to the whole Mods folder or the top of each MOD, be sure to enable the Subdirectories checkbox.
- Typo in the POI Property List → If a POI name in the list doesn’t match the file name exactly, it won’t be found.
Hollow Town
Sometimes you get a town that only has an outer ring with an empty center (this is different from a case where a town surrounds a mountain or lake). This is caused by a town in the Town Property List whose max size is larger than about 8 tiles but has no center parameter. Add a center parameter to any town over 8 tiles and it’s resolved.
Update Preview drops you to desktop / fatal error from a missing map
The most common cause is referencing a map you haven’t created yet (or whose name is different).
- For each map whose name you specify in
Update Preview(Biome Map / Region Map, etc.), you need to run the command that creates that map first. For example, entering a Biome Map Name and running Update Preview before you’ve created the biome map will crash (improved in v0.50.0 and later). - A typo in a name causes the same error. Check that the name matches between when it’s created and when it’s referenced.
- Check that the command that creates the map isn’t disabled. Note that having multiple commands that create the same map, with only some enabled, is not a problem (as long as at least one is enabled per map, you’re fine).
No towns generate at all
The main reasons Create Towns produces no towns are as follows.
- The terrain is too rough … Towns need flat ground to sit on. Raise the Flatness Threshold or Elevation Deviation Threshold in
Create Towns, or reduce hills, mountains, and lakes to secure flat land. - The terrain is too high / too low … In
Create Townsyou can set the minimum and maximum elevation for towns. If the terrain is outside that range, no towns are built. Also note that tall POIs and POIs that extend deep underground can’t be placed without enough elevation headroom (e.g., if you place a town at 250m, there’s only 5m up to the max of 255m, so any POI taller than 5m can’t be placed). - The path is wrong so no POIs are found … Check your paths in
Tools → Initial Setup. When this is the cause, it looks like the flat ground where a town should go is visible in the preview, but nothing is there.
When you’re stuck, the quickest route is to first open the Console (F7) tab and look for error messages (the saved log doesn’t show the details). To isolate a cause, it’s also effective to use Interrupt at the bottom to stop right after each command and check the preview.