Works in Unreal Engine 5.0 to 5.8. Updated November 2026.
Quick answer: the packaged game usually opens a map you didn’t expect.
- Open Project Settings > Maps & Modes and set Game Default Map to your first level (for example your main menu).
- Open Project Settings > Packaging and add every level to List of maps to include in a packaged build.
- Package again and test.
Why it works in the editor but not packaged
When you press Play in the editor, Unreal plays the level you have open. The packaged game ignores that. It starts with the Game Default Map, and it only contains the levels and assets that were cooked. If either is wrong, you get an empty, black world.
Fix 1: Set the Game Default Map
In Project Settings > Maps & Modes:
- Game Default Map: the level the game starts in.
- Editor Startup Map: only affects the editor. It doesn’t matter for the packaged game.
Also check Default GameMode here. If your level relies on a Game Mode set only in World Settings, that still works, but only if the level itself loads.
Fix 2: Make sure every level is cooked
Levels you open with Open Level (by Name) are just a name in a string. The cooker can’t see that link, so the level may be left out.
- Go to Project Settings > Packaging.
- Expand the advanced options under Packaging.
- Add each level to List of maps to include in a packaged build.
Assets loaded only by a path string have the same problem. Add their folder to Additional Asset Directories to Cook.
Fix 3: Read the packaged game’s log
Run the packaged game once, close it, then open its log:
<PackagedFolder>\Windows\<ProjectName>\Saved\Logs\<ProjectName>.log
This works in Development builds. Shipping builds write little or no log, so test with Development first (Platforms > Windows > Binary Configuration). Search the log for Error and for Failed to load.
Other causes
| Symptom | Likely cause | Fix |
|---|---|---|
| Black screen, but you hear sounds or music | A loading or fade widget never gets removed | Check your loading screen removes itself; use Remove from Parent |
| Black screen, UI shows | The camera is inside a wall or the pawn didn’t spawn | Add a Player Start to the level, check the Game Mode’s Default Pawn Class |
| World is there but very dark | Only static lights and lighting was never built | Build lighting, or set lights to Movable |
| Black screen or crash on some PCs | Graphics driver or DirectX 12 problem | Update drivers, or test with the -dx11 launch option |
| Main level black, sub-levels missing | Streaming levels aren’t loaded | Set them to Always Loaded or load them in Blueprint |
Test with Play > Standalone Game in the editor before packaging. It behaves more like the packaged game and catches many of these problems faster.
FAQ
Shipping build is black but Development works. Look for logic behind the Is Packaged for Distribution node, and for plugins or code that only run in Development builds.
Can I see the console in a packaged game? In Development builds, press the ~ key. Shipping builds disable the console.
Will Fix Up Redirectors help? If the log shows failed asset loads, yes. Right-click Content and choose Fix Up Redirectors before packaging.