UAssetGUI is a tool designed for low-level examination and modification of Unreal Engine game assets by hand.
You can find pre-built binaries of UAssetGUI in the Releases tab of this repository.
You can run the program with command line arguments to export to and import from JSON, without opening the GUI.
UAssetGUI tojson <source> <destination> <engine version> [mappings name]
Example: UAssetGUI tojson A.uasset B.json VER_UE4_25
UAssetGUI fromjson <source> <destination> [mappings name]
Example: UAssetGUI fromjson B.json A.umap Outriders
If you'd like to compile UAssetGUI for yourself, read on:
- Visual Studio 2022 or later
- Git
- Clone the UAssetGUI repository:
git clone https://github.com/atenfyr/UAssetGUI.git- Switch to the new UAssetGUI directory:
cd UAssetGUI- Pull the required submodules:
git submodule update --init-
Open the
UAssetGUI.slnsolution file in Visual Studio, right-click on the UAssetGUI project in the Solution Explorer, and click "Set as Startup Project." -
Right-click on the solution name in the Solution Explorer, and press "Restore Nuget Packages."
-
Press the "Start" button or press F5 to compile and open UAssetGUI.
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.
UAssetAPI and UAssetGUI are distributed under the MIT license, which you can view in detail in the LICENSE file.
