Overview

This document explains how to package the project as a Windows Shipping build in Unreal Engine 5.x.


1. Pre-Packaging Setup

1.1 Add Maps to the Packaged Build

Navigate to:

Edit → Project Settings → Project → Packaging

Under List of Maps to Include in a Packaged Build, click + and add all required maps:

/Game/Maps/MainMenu
/Game/Maps/InterviewScene
/Game/Maps/Town
/Game/Maps/Mart

Important:

  • Include the Game Default Map

  • Include streamed/sub-level maps

  • Missing maps will not be packaged


1.2 Verify Default Maps

Navigate to:

Project Settings → Maps & Modes

Verify:

  • Editor Startup Map

  • Game Default Map


2. Set Build Configuration

Switch to Shipping mode:

Platforms → Windows → Build Configuration → Shipping

Or:

Edit → Project Settings → Packaging
→ Build Configuration: Shipping

Build Modes

Mode | Purpose -- | -- DebugGame | Debugging Development | Testing Shipping | Final distribution

Always use Shipping for release builds.


3. Package the Project

Start packaging:

Platforms → Windows → Package Project

Choose an output folder, for example:

D:\Builds\FSE100_Shipping\

4. Output Structure

After packaging completes:

Windows\
├── ProjectName.exe
├── ProjectName\
├── Engine\
└── ...

Run:

ProjectName.exe

Important:
Distribute the entire folder, not just the .exe.


5. Recommended Packaging Settings

Navigate to:

Project Settings → Packaging

Enable:

  • Use Pak File

  • Include Prerequisites

  • Full Rebuild (before final release)


6. Common Build Issues

Maps Not Loading

  • Ensure maps are added to the packaging list

  • Verify Game Default Map


Shipping Build Crash

Check .uproject:

Incorrect:

"AdditionalDependencies": [
"Engine",
"UnrealEd"
]

Correct:

"AdditionalDependencies": [
"Engine"
]

UnrealEd must NOT be included in Shipping builds.


7. Recommended Team Workflow

  1. Pull latest changes

  2. Test Development build

  3. Switch to Shipping

  4. Enable Full Rebuild

  5. Package

  6. Test executable

  7. Zip entire Windows folder

  8. Share