Here is a guide to addressing some of the more common issues you may run into using RoadBLD.

General RoadBLD Debugging Steps

These are the first things to try if you’re seeing unexpected results or crashes.

  1. For any visual artifacts(missing triangles, a road element doesn’t appear, something you just modified in a tool still shows in its original position, etc), hit Refresh Roads. This will recalculate all roads & connections in the level.
  2. If you are still seeing something that doesn’t look right after clicking Refresh Roads, use the Move Roads tool to adjust the positioning of the affected road(s). It’s possible that roads are only partially overlapping in a way that causes issues when trying to calculate intersections.
  3. If it still appears that something is corrupted after trying the 2 previous steps, hit Recreate Roads. This destroys and respawns all the roads and all their data to fix any corruption. However, with this method some custom markings or custom corner adjustments may be lost.

Debugging Crashes

  1. Check that all versions are the same. You want RoadBLD to have the same version as your Road Kits.

  2. Ensure it works in a fresh project. Some project settings may be incompatible with RoadBLD.

  3. Install it into your project Plugins folder, instead of the engine Plugins folder. Some projects require the plugin installed into the project Plugins folder.

    Untitled

  4. If materials aren't rendering (greyed out or black), your project settings may be incompatible. Check that you have common requirements like “Virtual textures” and “Virtual Texture Opacity” enabled in your project settings.

  5. If you’re seeing glowing spots on your meshes, try ensuring GBuffer Format is set to Default in Engine > Rendering within your Project settings.

  6. If you’re seeing RoadBLD actors disappearing when playing, check if these actors are being streamed out in World Partition - Unreal often doesn't give procedural meshes the correct boundaries, so you can sometimes have Actors being streamed out too early until you convert them to Static Meshes. You can select the actors and uncheck "is spatially loaded" to fix this until you are ready to save them as Static Meshes.

Debugging Tool Behavior

Examples of tool behavior issues are road brushes glitching, landscapes stretching when aligned to the road, or blocks generating in odd shapes.

  1. Check if it happens in a new level. Sometimes you may have set up your level in a way that makes it incompatible with a CityBLD tool, such as using invisible blocking volumes that the tools interact with.
  2. Check if it happens in a fresh project. Certain plugins, like the Landscaping plugin, generate environments that CityBLD tools cannot interact with normally.