Skip to content

UE-Explorer/UE-Explorer

Repository files navigation

UE Explorer

UE Explorer is an easy-to-use browser and decompiler for Unreal Engine packages (.upk, .u).

app

Install

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

Features

  • UnrealScript decompilation with high accurracy.
  • Export any UnrealScript classes, or entire package of classes.
  • Export any sound of an Unreal package.

Exploring:

  • Explore a tree of classes to navigate all decompiled UnrealScript classes.
  • Explore a tree of content to navigate the properties of any non-UnrealScript object.
  • View all the dependencies of an Unreal package, including the object that it is dependant on.

Modding:

  • Hex Viewer with rich defined-structures to help with debugging and/or hex-modding.
  • A specialized UnrealScript tokens output to assist with hex-modding.

It has support for:

  • Unreal Engine 1
  • Unreal Engine 2, UE2.5
  • Unreal Engine 3

UE2X and UE4/5 have not been supported as of yet

p.s. the program can open loose UE4 .uasset files

However many games may have modified the engine to some extent.

A list of games that have been confirmed to work can be viewed here.

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