Vi3W
Skip to content

Guides

Roblox normal map not working: OpenGL, tangents and other fixes

Fix Roblox normal maps that look inverted, flat or missing: OpenGL vs DirectX, tangents, SurfaceAppearance setup, and lighting that hides detail.

3 min read

A stone tile with deep bumpy detail lit from the side, next to a flat lifeless version of the same tile
Illustration. A working normal map adds depth without extra geometry.

Quick answer

Why is my normal map not working in Roblox?

Most often the map is in DirectX format, so bumps look inverted. Roblox only supports OpenGL tangent-space normal maps. Other causes are a mesh exported without tangents, the map placed in the wrong slot, a Part instead of a MeshPart, or lighting too flat to show detail.

What a normal map should do

A normal map fakes small surface detail, like cracks, bolts and fabric weave, by telling the lighting which way each pixel faces. It's a purple-blue image. A completely flat one is uniform RGB (127, 127, 255) (surface appearance).

A purple-blue normal map square beside a sphere showing bumpy lit detail
Illustration. The purple-blue image tells light which way each pixel faces.

Fix 1: DirectX vs OpenGL (bumps look inverted)

Roblox supports only OpenGL-format, tangent-space normal maps. Many tools export DirectX format by default, including Substance's default preset and many texture sites. The two differ in the green channel, so a DirectX map makes bumps look like dents and lights them from the wrong side.

Fix: Invert the green channel in an image editor, or re-export with the OpenGL preset. In Substance Painter, choose an OpenGL normal export. In Blender, baked normal maps are OpenGL by default.

Fix 2: The mesh has no tangents

Tangent-space normal maps need tangent data on the mesh, and Roblox's SurfaceAppearance reference says the mesh must include tangents. Without them, the normal map shades wrongly or not at all.

Fix: Export from Blender as FBX with Tangent Space enabled in the Geometry options, or use glTF, which includes tangents when the material has a normal map. Make sure the mesh has UVs, since tangents are calculated from them.

Fix 3: It's in the wrong place

  • On a MeshPart, the normal map goes in a child SurfaceAppearance's normal map property.
  • On Parts and terrain, use a MaterialVariant's Normal map (materials).
  • A Decal or Texture object can't use a normal map.

If the MeshPart has both a SurfaceAppearance and a MaterialVariant, Studio applies only the SurfaceAppearance settings (meshes).

Fix 4: The lighting hides it

Normal maps show detail through light and shadow. Under flat, even lighting there's nothing to show.

  • Try LightingStyle = Realistic in Lighting. With Unified Lighting, this replaced the old Future setting (announcement).
  • Test with a light at a low angle, or a moving PointLight, to see the bumps.
  • Turn up EnvironmentSpecularScale for shiny materials.

Our lighting settings guide covers the options.

Fix 5: Seams

Visible lines across the model usually sit on UV seams. Roblox's surface appearance page suggests hiding texture seams where possible. Bake the normal map with the same UVs you export, and place seams in less visible spots.

Fix 6: The map is greyscale

A black-and-white bump or height map isn't a normal map. Convert it to a normal map first in an image tool or texture baker.

Checklist

  1. OpenGL format (green channel up).
  2. Mesh exported with tangents and UVs.
  3. Map in a SurfaceAppearance on a MeshPart, or in a MaterialVariant.
  4. Lighting that rakes across the surface.
  5. Seams hidden or minimised.

Start with PBR maps that match

Vi3W generates textured models with PBR materials, retopologises them, and exports GLB, FBX or OBJ. GLB carries the materials in one file and is a simple route into the Studio Importer. Check the normal map's look after import, using the steps above if anything looks inverted. Make a model in Vi3W.

Last reviewed