This is the documentation for Enlighten.

Convert to vanilla UE5

Owned by geosw (Unlicensed)
Oct 31, 2024
2 min read

As .umap and .uasset files saved in Enlighten UE5 contain Enlighten-specific data, you can only use them with Enlighten UE5. To load these files in the vanilla Unreal Engine distribution, you can back up and remove the Enlighten-specific data.

This is useful for:

  • verifying whether certain behavior is specific to Enlighten, or also occurs in vanilla Unreal Engine
  • reporting bugs in vanilla Unreal Engine to Epic and provide them with assets to replicate the problem

Remove Enlighten-specific data

To remove Enlighten-specific data, use the EnlightenStripEnlightenData commandlet. The commandlet modifies the assets that the chosen asset depends on. It doesn't modify dependent assets in the Engine content folder.

<editor executable> <project name> -run=EnlightenStripEnlightenData <chosen asset file> [-AutoCheckOutPackages] [-StripAll] [-AllAsset]

Parameters:

<editor executable> This is the path path to your Unreal Engine executable.

<project name> The first command line argument to Unreal Engine is always the path to the project file containing the assets.

-run=EnlightenStripEnlightenData This is the commandlet that tells Unreal Engine to remove the Enlighten-specific data.

<chosen asset file> This argument to the above commandlet is the asset file to operate on. Use the full path to either a .umap or .uasset file.

[-AutoCheckOutPackages] Check out modified packages automatically

[-StripAll] Remove Enlighten-specific data from all levels in the project and their dependencies.

[-AllAsset] When used with StripAll, remove Enlighten-specific data from all assets in the project.


If the assets are read-only because the project is configured to use Perforce, the EnlightenStripEnlightenData commandlet reports an error. Either make the asset files writable on disk, or specify the optional -AutoCheckOutPackages argument.


The following example command removes Enlighten-specific data from MyProject/Content/Maps/MyLevel.umap and all assets it depends on. If Perforce is configured for the project, the assets are automatically added to the default pending changelist.

 UnrealEditor.exe MyProject -run=EnlightenStripEnlightenData /Game/Maps/MyLevel -AutoCheckOutPackages

This command modifies the asset files on disk. To avoid losing data, make sure you have a backup of the project content before using this command.

Create a streamlined project

The commandlet removes all references to Enlighten-specific data from the chosen asset file and dependent assets. This might leave unused empty .uasset files that previously contained Enlighten precompute data.

To remove all Enlighten-specific data or asset files:

  1. Make sure you have a backup of the project.
  2. Make all assets writable on disk.
  3. Run the commandlet for the chosen asset using the Enlighten UE5 editor build.
  4. Open the project in the vanilla Unreal Engine editor build.
  5. In the content browser, Migrate the chosen asset to a new empty project.

The resulting project contains only the files that the chosen asset depends on, and can be loaded in the vanilla Unreal Engine editor.