UE Explorer

UE Explorer is an UnrealScript decompiler for Unreal Engine 1, 2, and 3. Supporting all Epic Games for the PC such as Unreal, UT, UT2004, UT3, and the Unreal Development Kit(UDK).

What's a decompiler?

An UnrealScript decompiler is an application that does the opposite of what a compiler does, a decompiler translates the bytecodes(binary) to readable code, making it possible to research and learn from its code, and more(see below).

Why use a decompiler?

UE Explorer may be useful for many things, some of which are:

• Decompiling code is a great way to learn UnrealScript or programming techniques from games
• While not free of compiler errors, if you happen to lose your source code you'll be able to recover your source code quickly thanks to a decompiler
• Decompiling mods to check for malicious intent
• A useful resource to browse libraries or APIs with no documentation or lack thereof
• To investigate your own code to determine possible issues such as implicit casts with byte on bitwise operators
• Rebuild a mod to another engine or game

All of the above is assuming you have permission to do such things!

$teaser

Beware! Use UE Explorer only for learning purposes, UE Explorer is not designed for copying or recompiling other people's work, always ask for permission from its respective owners!

DO NOT PUBLISH DECOMPILED SOURCE CODE WITHOUT PERMISSION FROM ITS RESPECTIVE OWNERS

UnrealScript Features

Classes

UE Explorer decompiles any UnrealScript class up to great accuracy to the original code. Everything from comments, to objects, replication, and defaultproperties are properly output and browsable using a rich syntax highlighting editor.

Comments

Comments are insert into the generated code which are fetched from the MetaData within the package:

Fields

Constants, Enumerations, Structures, Variables, and functions are all decompilable.

DefaultProperties

Unlike other decompiles, UE Explorer does decompile every data type exposed in the defaultproperties block.

• Bytes, Ints, Floats, Bools
• Dynamic Arrays, Static Arrays
• Structs, Subobjects
• Enums, Delegates
• Strings

Archetypes

Archetypes are created instances of templated class object with their own set of default values(called DefaultProperties in classes).

Archetypes are a great technique for Level Designers to customize a set of classes such as a Monster whom's default values such as Health, Skin, and Weapons set may have been modified without having to interfere a programmer. All these archetypes are decompilable using UE Explorer's Objects->Content tab, this tab also lists all the sounds, textures and any other kind of content.

Interface Features

The UE Explorer's interface exposes a great amount of information such as the package's content, but also the technical details which can be an useful resource for some developers. These details are things such as the package's version number, licensee version, and the package's settings such as whether if the package is download or server side only.

Tools

UE Explorer provides a bunch of useful tools for people whom are interested in modding Unreal package files and anyone else interested in learning UnrealScript.

• Export decompiled and/or imported scripts from any package containing code
• Search in decompiled object or classes
• View the package or any object individual with an inbuilt hex-viewer providing colorful structures and ease of navigating throughout a package's objects with support for Unreal specific data types
• A clean interface of classes with all its fields decompilable individually using the tree view
• Has an inbuilt color code generator, useful for any modder or server administrator willing to color titles of a server of map objective etc!
• The dependencies treeview shows a deep detailed dependencies tree of packages such as maps or code up to point of why a loaded package is dependent on another specific package. Which is great for optimizing mods or games before releasing
• Export sounds from UE1 and UE2 games

Tables

Names

The names table lists all the unique names whom are used within the package.

Exports

The exports table lists all the objects whom exist in the package.

The exports table will provide loads of essential and useful information of each object such as the "Object Offset" which tells the position where said object exists in the package file.

This can be useful if you are willing to use a Hex-Editor to modify some bytes from said object.

Imports

The imports table is basically the equivalant of the in depth dependencies TreeList, except this one is provided in the raw format which is unorginazed.

This collection provides several details for each import. An import describes which object/class this package requires for it to function properly.

Each import will describe its class and in which package that class resists.

Generations

The generations table lists all the generations of this package which were built using the ConformCommandlet.

Conforming is used to keep updated packages compatible online with older versions of the same package.

This table is useful for validating if your package is indeed conformed.

Objects

Dependencies

The dependencies treeview exposes what a package is dependent on such as this image which shows that package A is dependent on package Core, and when expanded you can see why package A is dependent on Core.

Supported Games

UELib supports all of the following tested games! May support more than what's listed here!
Not all of those games are fully supported. Some may not be decompilable, but definitely openable.

Unreal Engine 1

Unreal Engine 2

Green colored numbers indicate swhat version since UE Explorer supports said game.

Unreal Engine 3

May also work on other games. Opening unsupported packages may lead to unexpected results! Make sure you have saved everything before opening any file!

Modding

Modding games with UE Explorer is possible to some certain extent.

These games are known to be modded by their communities, I suggest you could go learn how to mod games using Hex Editors together with the assistence of UE Explorer.

• Dishonored : Dishonored Ultimate Difficulty Mod - There's a guide on page 2.
• XCOM: Enemy Unknown : Modding Forum - Lots of guides and topics on modding XCOM.
• Aliens Colonial Marines : Editting Game Variables - A guide on modding variables.

You can find a lot more on Google.

Credits

The following people are credited because they've directly or indirectly influence the development of UE Explorer!

• Antonio Cordero Balcazar
  • UTPT and his documentation on the Unreal bytecode's
• Intelliyole
  
  • Unhood
• Gildor
  
  • Package version correction

Repository

Although the repository source code is private, you are still welcome to submit issues which could be a bug or a task/feature request.