Documentation

​
​

Development

User Acquisition

Monetization

Industry

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
  • Run builds
  • Build results
    • Check build results
    • Troubleshooting Build Automation failures
      • Troubleshoot common issues
      • Builds fail immediately
      • Unrecognized project error
      • Clone hangs when you use Git submodules
      • Lightmap baking
      • Android build failures
      • Errors after migration to a new Xcode version
      • macOS notarization failure
      • Problems with iOS Build Automation during XCode export
      • iOS build can't download or install from Unity Build Automation
  • Optimize build speed
  • Manage artifact retention rules
  • Manage concurrent builds
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  2. Build results
  3. Troubleshoot Build Automation failures

Unity Build Automation lightmap baking

Resolve Unity Build Automation lightmap baking issues and understand common causes and solutions.
Read time 1 minute
Last updated 10 months ago

Symptoms

  • Builds you create with Unity Build Automation are much darker than a local build.
  • 3D assets are dark when you use Unity Build Automation to build the game.

Causes

Unity Build Automation doesn't support building lightmaps, and if you try to build a lightmap the builds might be too dark and have poor build performance. There are two possible causes:
  • You use Precomputed Realtime GI for your scene and have the Auto Build for lightmaps enabled.
  • You haven't checked in your build maps into your repository.

Resolution

Turn off Auto Build in your scenes and manually build and commit your lightmaps. Depending on what your scene includes and your lighting settings, you need to commit the following files:
  • LightingData.asset
  • LightmapSnapshot.asset
  • Lightmap-xxx.exr
  • Lightprobe-xxx.exr
The files are in a subfolder named after the scene in the same folder as your scene. For more information about lightmaps please refer to this documentation on how to set up your scene and lights for baking.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Symptoms

    • Causes

    • Resolution


Report a problem with this page