Troubleshooting
This section covers the following issues:
- Faces not rendering (or appearing black)
- Pink Shaders
- Spotty Textures on Lightmapped GameObjects
- Missing FbxPrefab or assembly reference error
Faces not rendering (black)
If you are editing Mesh elements and suddenly notice that some of your faces have turned black, there are two common causes: * There is a problem with auto-lightmapping.
- You have two edges or two vertices in a single Mesh, and they are sharing the same space.
First, check the Auto Lightmap UVs setting on the Lightmap UV Editor window. Sometimes faces appear as black if auto-lightmapping hasn't rendered them yet. This usually happens if there are more rendering jobs than your resources can handle (particularly on older machines).
To access the Auto Lightmap UVs setting:
Open the Lightmap UV Editor window (Tools > ProBuilder > Editors > Open Lightmap UV Editor).
Disable the Auto Lightmap UVs option.
If you turn off the automatic lightmapping option and you still see faces that are not rendering, it may be that you have doubled vertices in your Mesh.
To fix elements that are sharing the same place:
- Select the entire Mesh.
- Open the Options window for the Weld Vertices tool and make sure that the Weld Distance value is very low (for example, 0.01 or 0.0001). This ensures the tool doesn't weld vertices that are close but not doubled.
- Click the Weld Vertices button.
Tip: You can enable the Show Scene Info property in the ProBuilder Preferences window while debugging. This displays information about the selected Mesh, including the total number of vertices, edges, and faces, and how many are currently selected in the top left corner of the Scene view.
Pink Shaders
If you are upgrading a project from the Asset Store package make sure to run the Convert to Package Manager utility.
If you are using the new Standard Rendering Pipeline (SRP) you may have issues compiling the ProBuilder default Shader. As a workaround, you can set the default Material preference.
Spotty Textures on Lightmapped GameObjects
This happens when the GameObject does not have a UV2 channel.
To build the UV2 channel:
- Select the affected GameObject(s).
- Run the Lightmap UVs tool.
Missing FbxPrefab or assembly reference error
You may see one or more of these errors if you have imported the FBX Exporter package, then later removed it:
<project-folder>/Addons/Fbx.cs(66,81): error CS0246: The type or namespace name `FbxNode' could not be found. Are you missing an assembly reference?
<project-folder>/Addons/Fbx.cs(11,19): error CS0234: The type or namespace name `Formats' does not exist in the namespace `UnityEditor'. Are you missing an assembly reference?
<project-folder>/Addons/Fbx.cs(8,7): error CS0246: The type or namespace name `Autodesk' could not be found. Are you missing an assembly reference?
To resolve these errors, you can follow either of these fixes:
- Re-import the FBX Exporter package.
- Open PlayerSettings (from the top menu: Edit > Project Settings > Player) and remove the PROBUILDER_FBX_PLUGIN_ENABLED flag from Scripting Define Symbols.