Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Unreal Engine requires you Learn to select a Build Configuration before Packaging your Project. This document helps to identify which one to select.

...

Build Configurations refer to the different when you are packaging.

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#F4F5F7

Different settings and options used when building a project.

...

1. Development Configuration

...

It has additional debugging information and focuses on providing fast iteration times and easier debugging.

Note

It has less Less performance optimizations to speed up the compilation process.

Not suitable for final, optimized builds meant for distribution and the game may run more slowly than in a shipping build.

2. Debug Configuration

It has additional information and debug symbols for easier debugging.

It might have fewer optimizations compared to a development build.

Note

Debug builds are slower Slower and larger than their Release counterparts.

They include additional checks and information that can impact performance.

Debug builds are not Not suitable for final final game releases due to their reduced performance.

3. Shipping Configuration

...

It is optimized for performance and removes unnecessary debugging information to reduce file size.
Generally, it is faster and more efficient than a Development Build.

Note

While optimized Optimized for performance and size, it but lacks detailed debugging information, making it challenging to diagnose issues.

It is not suitable for development or testing phases but is crucial for creating the final game build.

4. Test Configuration

Similar to the Shipping configuration, but has additional checks and safeguards to catch potential issues during testing.

It is often Often used for testing purposes and may include certain debugging features but is generally more optimized than a development or debug build.

Note

It is slower Slower than the Shipping configuration due to the added checks and may have a larger exe file size.

It is primarily used for internal testing before the final release.

5. DebugGame Configuration

...

It provides a compromise between fast iteration times and debugging capabilities.

Note

While faster Faster than Debug builds, it but still includes includes some additional checks and debugging information, making them larger and slower than Development builds.

It's important to choose Choose the appropriate Build Configuration based on the current phase of development and specific requirements.

Developers often switch between configurations during different stages of a project, using Development or Debug configurations during active development and testing, then transitioning to Test or Shipping configurations for performance and release considerations.

Info

For Debugging a code project, select DebugGame.

For most other development with minimal debugging support, but better performance, select Development.

For the final Shipping build, which will have no debugging information and no debugging-oriented features (such as drawing debug shapes or printing debug messages on the screen), select Shipping.

Panel
panelIconIdatlassian-info

...

panelIcon:info:
bgColor#F4F5F7

Note :

Blueprint-only projects will not have the option to create a DebugGame build.

Was this article helpful? Comment Below. Let us know your feedback.

We don't have a way to export this macro.

Need help? Contact Support

...