UAssetGUI

UAssetGUI is a tool designed for low-level examination and modification of Unreal Engine game assets by hand.

Installation

You can find pre-built binaries of UAssetGUI in the Releases tab of this repository.

Command line arguments

You can run the program with command line arguments to perform various tasks, such as exporting and importing from UAssetAPI JSON without opening the GUI.

In the following cases, the engine version can either be specified as an EngineVersion enum entry (e.g. VER_UE4_23 to refer to 4.23, VER_UE5_0 to refer to 5.0, etc.) or as an integer (e.g. 23 to refer to 4.23, 29 to refer to 5.0, etc.). Specifying a set of mappings is optional, but if specified, must be the name of a file within the Mappings config directory (with no extension).

Export to JSON

UAssetGUI tojson <source> <destination> <engine version> [mappings name]

Example 1: UAssetGUI tojson A.uasset B.json VER_UE5_1

Example 2: UAssetGUI tojson A.uasset B.json 27 Astro

Import from JSON

UAssetGUI fromjson <source> <destination> [mappings name]

Example 1: UAssetGUI fromjson B.json A.umap

Example 2: UAssetGUI fromjson B.json A.umap Outriders

Open a specific file in the GUI

UAssetGUI [file name] [engine version] [mappings name]

Example 1: UAssetGUI (to simply open the GUI without opening a file)

Example 2: UAssetGUI test.uasset

Example 3: UAssetGUI test.uasset 23

Example 4: UAssetGUI test.uasset VER_UE5_4 Bellwright

Compilation

If you'd like to compile UAssetGUI for yourself, read on:

Prerequisites

• Visual Studio 2022 or later
• Git

Initial Setup

1. Clone the UAssetGUI repository:

git clone https://github.com/atenfyr/UAssetGUI.git

2. Switch to the new UAssetGUI directory:

cd UAssetGUI

3. Pull the required submodules:

git submodule update --init

4. Open the UAssetGUI.sln solution file in Visual Studio, right-click on the UAssetGUI project in the Solution Explorer, and click "Set as Startup Project."

5. Right-click on the solution name in the Solution Explorer, and press "Restore Nuget Packages."

6. Press the "Start" button or press F5 to compile and open UAssetGUI.

Contributing

Any contributions, whether through pull requests or issues, that you make are greatly appreciated.

If you have an Unreal Engine .uasset file that displays "failed to maintain binary equality," feel free to submit an issue on the UAssetAPI issues page with a copy of the asset in question along with the name of the game, the Unreal version that it was cooked with, and a mappings file for the game, if needed.

License

UAssetAPI and UAssetGUI are distributed under the MIT license, which you can view in detail in the LICENSE file.