A tool designed for low-level examination and modification of Unreal Engine game assets by hand.
C#
1,077
460 commits
updated Aug 31, 2026
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.
An experimental release of UAssetGUI is published with every new commit. If you have issues with the stable release of UAssetGUI, you may wish to try to use the experimental release. You can download the experimental release here: https://github.com/atenfyr/UAssetGUI/releases/tag/experimental-latest.
If you would like to set up UAssetGUI for Linux (through Wine), perform the following steps:
winetricks dotnetdesktop10 micross on the command line and go through all prompts that appear.
winetricks dotnetdesktop8 microsswinetricks dotnet472 microsswine UAssetGUI.exeYou 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 in major.minor string notation (e.g. 4.23 or 5.3, only available in v1.1.1+), an EngineVersion enum entry (e.g. VER_UE4_23 to refer to 4.23, VER_UE5_0 to refer to 5.0, etc., available in all versions) or as an integer (e.g. 23 to refer to 4.23, 29 to refer to 5.0, etc., available in all versions).
Specifying a set of mappings is optional, but if specified, must be the path to a mappings file on disk with extension (only available in v1.1.1+) or the name of a file within the UAssetGUI Mappings config directory with no extension (available in all versions).
UAssetGUI tojson <source> <destination> <engine version> [mappings name]
Example 1: UAssetGUI tojson A.uasset B.json 5.1 "C:\Mappings.usmap" (only in v1.1.1+)
Example 2: UAssetGUI tojson A.uasset B.json VER_UE5_1
Example 3: UAssetGUI tojson A.uasset B.json 27 Astro
UAssetGUI fromjson <source> <destination> [mappings name]
Example 1: UAssetGUI fromjson B.json A.umap
Example 2: UAssetGUI fromjson B.json A.umap ./Mappings.usmap (only in v1.1.1+)
Example 3: UAssetGUI fromjson B.json A.umap Outriders
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
If desired, you may wish to use UAssetGUI in portable mode. In portable mode, all configuration files, saved mappings, etc. are stored in a "Data" folder adjacent to the executable file, allowing UAssetGUI to be used on a USB drive or other portable media. This feature is only available in v1.1.0 or higher.
To set up portable mode, execute UAssetGUI with the following command line parameter. Once UAssetGUI has been launched in portable mode at least once, UAssetGUI can be executed normally (with no parameters) and it will remain in portable mode. To disable portable mode and return to normal operation, simply delete the "Data" folder adjacent to the UAssetGUI executable file.
Usage: UAssetGUI portable
If you'd like to compile UAssetGUI for yourself, read on:
git clone https://github.com/atenfyr/UAssetGUI.git
cd UAssetGUI
git submodule update --init
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."
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 may 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 Engine version that it was cooked with, and a mappings file for the game, if needed.
Please note: Your issue will NOT be reviewed if no test asset(s) are provided (unless the issue is completely unrelated to asset parsing).
We currently do not accept AI-generated code on the UAssetAPI or UAssetGUI repositories. UAssetGUI is mature, stable software, so all changes must be thoroughly tested and reviewed by a human. Pull requests containing AI-generated code, text, documentation, or other AI-generated assets will not be reviewed.
Source code for UAssetGUI is available on GitHub: https://github.com/atenfyr/UAssetGUI
UAssetAPI and UAssetGUI are distributed under the MIT license, which you can view in detail in the LICENSE file.
1,103 followers · starred Apr 2024
1,396 followers · starred Dec 2025
708 followers · starred Oct 2025
96 followers · starred May 2025
A tool designed for low-level examination and modification of Unreal Engine game assets by hand.
C#
1,077
460 commits
updated Aug 31, 2026
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.
An experimental release of UAssetGUI is published with every new commit. If you have issues with the stable release of UAssetGUI, you may wish to try to use the experimental release. You can download the experimental release here: https://github.com/atenfyr/UAssetGUI/releases/tag/experimental-latest.
If you would like to set up UAssetGUI for Linux (through Wine), perform the following steps:
winetricks dotnetdesktop10 micross on the command line and go through all prompts that appear.
winetricks dotnetdesktop8 microsswinetricks dotnet472 microsswine UAssetGUI.exeYou 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 in major.minor string notation (e.g. 4.23 or 5.3, only available in v1.1.1+), an EngineVersion enum entry (e.g. VER_UE4_23 to refer to 4.23, VER_UE5_0 to refer to 5.0, etc., available in all versions) or as an integer (e.g. 23 to refer to 4.23, 29 to refer to 5.0, etc., available in all versions).
Specifying a set of mappings is optional, but if specified, must be the path to a mappings file on disk with extension (only available in v1.1.1+) or the name of a file within the UAssetGUI Mappings config directory with no extension (available in all versions).
UAssetGUI tojson <source> <destination> <engine version> [mappings name]
Example 1: UAssetGUI tojson A.uasset B.json 5.1 "C:\Mappings.usmap" (only in v1.1.1+)
Example 2: UAssetGUI tojson A.uasset B.json VER_UE5_1
Example 3: UAssetGUI tojson A.uasset B.json 27 Astro
UAssetGUI fromjson <source> <destination> [mappings name]
Example 1: UAssetGUI fromjson B.json A.umap
Example 2: UAssetGUI fromjson B.json A.umap ./Mappings.usmap (only in v1.1.1+)
Example 3: UAssetGUI fromjson B.json A.umap Outriders
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
If desired, you may wish to use UAssetGUI in portable mode. In portable mode, all configuration files, saved mappings, etc. are stored in a "Data" folder adjacent to the executable file, allowing UAssetGUI to be used on a USB drive or other portable media. This feature is only available in v1.1.0 or higher.
To set up portable mode, execute UAssetGUI with the following command line parameter. Once UAssetGUI has been launched in portable mode at least once, UAssetGUI can be executed normally (with no parameters) and it will remain in portable mode. To disable portable mode and return to normal operation, simply delete the "Data" folder adjacent to the UAssetGUI executable file.
Usage: UAssetGUI portable
If you'd like to compile UAssetGUI for yourself, read on:
git clone https://github.com/atenfyr/UAssetGUI.git
cd UAssetGUI
git submodule update --init
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."
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 may 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 Engine version that it was cooked with, and a mappings file for the game, if needed.
Please note: Your issue will NOT be reviewed if no test asset(s) are provided (unless the issue is completely unrelated to asset parsing).
We currently do not accept AI-generated code on the UAssetAPI or UAssetGUI repositories. UAssetGUI is mature, stable software, so all changes must be thoroughly tested and reviewed by a human. Pull requests containing AI-generated code, text, documentation, or other AI-generated assets will not be reviewed.
Source code for UAssetGUI is available on GitHub: https://github.com/atenfyr/UAssetGUI
UAssetAPI and UAssetGUI are distributed under the MIT license, which you can view in detail in the LICENSE file.
1,103 followers · starred Apr 2024
1,396 followers · starred Dec 2025
708 followers · starred Oct 2025
96 followers · starred May 2025