Packaged Game Shows a Black Screen in Unreal Engine 5: How to Fix It

Table of Contents

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.

  1. Open Project Settings > Maps & Modes and set Game Default Map to your first level (for example your main menu).
  2. Open Project Settings > Packaging and add every level to List of maps to include in a packaged build.
  3. 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.

  1. Go to Project Settings > Packaging.
  2. Expand the advanced options under Packaging.
  3. 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

SymptomLikely causeFix
Black screen, but you hear sounds or musicA loading or fade widget never gets removedCheck your loading screen removes itself; use Remove from Parent
Black screen, UI showsThe camera is inside a wall or the pawn didn’t spawnAdd a Player Start to the level, check the Game Mode’s Default Pawn Class
World is there but very darkOnly static lights and lighting was never builtBuild lighting, or set lights to Movable
Black screen or crash on some PCsGraphics driver or DirectX 12 problemUpdate drivers, or test with the -dx11 launch option
Main level black, sub-levels missingStreaming levels aren’t loadedSet 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.

Related tutorials