
Package explorer tool for Unreal Engine (.upk, .u) with UnrealScript decompilation, browsing, and hex inspection
UnrealScript Decompilation:
- High-accuracy UnrealScript decompilation
- Export individual classes or entire packages
Package Exploration:
- Class tree navigation for decompiled UnrealScript
- Content tree for inspecting object properties (pseudo
.T3Dformat) - Package dependency tree navigation (including referenced objects)
Package Exporting:
- Export any decompiled UnrealScript class to
.uc - Export any
SoundandSoundNodeWavein its raw form i.e. a.wav
Package Modding:
- Structured Hex Viewer for inspecting and editing binary data
- UnrealScript bytecode token output for low-level analysis and hex modding workflows
Engine Support:
- Unreal Engine 1
- Unreal Engine 2, UE2.5
- Unreal Engine 3
UE2X and UE4/5 have not been supported as of yet, except for limited experimental parsing of loose UE4 .uasset containers
Note: Many games ship with engine modifications; compatibility may vary depending on custom forks or heavily altered packages. A list of games that have been confirmed to work can be viewed here.
If UE Explorer helps your research, modding, or learning, please consider supporting its continued development.
UE Explorer and UELib are free and open source, and community support helps fund updates, fixes, and new features.
You can download and install UE Explorer for Windows using one of the following sources:
- EliotVU: https://eliotvu.com/portfolio/download/21/ue-explorer
- GitHub: https://github.com/UE-Explorer/UE-Explorer/releases
- winget:
winget install "ue explorer"
In most cases you can open any .upk, .u, .xxx (compressed) etc. files anywhere, but, for UE Explorer 1.6.1 and older, packages must be decompressed before hand.
In order to decompress a package you can use a third-party tool such as Gildor's Unreal Package Decompressor
- Drag and drop the compressed package on top of the
decompress.exeexecutable. - A new folder
unpackedshould have been created in the same directory as the executable. - You now open the
.upkfile respectively from theunpackeddirectory using UE Explorer
If the decompression failed then it it's likely that the compression codec could not be detected by the tool, or the tool has no support for that package format. Using the commandline, you can append arguments to tell the tool what codec to use for decompression:
-lzo|lzx|zlibe.g.decompress.exe -lzo "Core.upk"-game=<TAG>(you can use-taglistto list all applicable tags) e.g.decompress.exe -lzo -game=xcom2 "Core.upk"-ps3, if necessary.
You can launch UE Explorer in console mode, by appending the -console argument to the ueexplorer.exe executable.
The program accepts the following arguments:
[file-path]The package file path to open.-consoleLaunches the program as a console window.-silentThe console will automatically close when it has finished its tasks.-export=classes|scriptsExports all classes or scripts from the specified package file.
-newwindowLaunches the program in a new window, as opposed to a new tab in the currently running program.
The project is built on the .NET Framework 4.8 WinForms library using C#.
If you want to contribute to the app you can do so by doing one of the following:
- Open an issue
- Or make a pull-request by creating a fork of this repository, create a new branch and commit your changes to that particular branch, so that I can easily merge your changes.
This is the repository for the UI which is using UELib to do most of its Unreal related work.
See the UELib for more.
UE Explorer has been widely used to dig into and mod Unreal Engine based games. Various communities have written guides, such as:
- Borderlands Modding
- Dishonored Ultimate Difficulty Mod
- Aliens Colonial Marines: Editing game variables
- Modding Guide - Gal*Gun Double Peace
- Batman Arkham City - Hacking Unrealscript
Do you have or know of a guide that's missing here? Feel free to submit a pull-request, inform us in the discussion board
Furthermore, many communities have been spun up that make extensive use of UE Explorer:
- Arkham Workshop, Graphics Processing Community - A Batman series modding community
- Bioshock Modding Hub
- Borderlands Modding
- Infinity Blade: Modding
- ReEnergized Community - A Transformers modding community
- Unreal Engine Modding
This project is an independent, community-developed tool and is not affiliated in any way with, endorsed by, or sponsored by Epic Games, Inc. Unreal, Unreal Engine, UDK, and the Unreal U logo are property of Epic Games, Inc.
