Skip to content

Repository files navigation

UE Explorer

Package explorer tool for Unreal Engine (.upk, .u) with UnrealScript decompilation, browsing, and hex inspection

Discord Website Release Downloads

app demo

Features

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 .T3D format)
  • Package dependency tree navigation (including referenced objects)

Package Exporting:

  • Export any decompiled UnrealScript class to .uc
  • Export any Sound and SoundNodeWave in 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.

Support Development

If UE Explorer helps your research, modding, or learning, please consider supporting its continued development.

GitHub Sponsors PayPal

UE Explorer and UELib are free and open source, and community support helps fund updates, fixes, and new features.

Install

You can download and install UE Explorer for Windows using one of the following sources:

Opening decompressed packages

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.exe executable.
  • A new folder unpacked should have been created in the same directory as the executable.
  • You now open the .upk file respectively from the unpacked directory 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|zlib e.g. decompress.exe -lzo "Core.upk"
  • -game=<TAG> (you can use -taglist to list all applicable tags) e.g. decompress.exe -lzo -game=xcom2 "Core.upk"
  • -ps3, if necessary.

Command-line interface

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.
  • -console Launches the program as a console window.
    • -silent The console will automatically close when it has finished its tasks.
    • -export=classes|scripts Exports all classes or scripts from the specified package file.
  • -newwindow Launches the program in a new window, as opposed to a new tab in the currently running program.

How to contribute

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.

How do I add support for a game?

This is the repository for the UI which is using UELib to do most of its Unreal related work.

See the UELib for more.

Guides

UE Explorer has been widely used to dig into and mod Unreal Engine based games. Various communities have written guides, such as:

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:

Credits

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.

Releases

Packages

Used by

Contributors

Languages