UAsetGUI

UAssetGUI

UAssetGUI is a powerful tool for low-level examination and modification of Unreal Engine game assets. This guide will provide a comprehensive walkthrough on how to use UAssetGUI effectively.

Installation

1. Download Pre-Built Binaries: You can find pre-built binaries of UAssetGUI in the Releases tab of the repository.

2. Extract the Archive: Unzip the downloaded archive to your desired location.

Command Line Arguments

UAssetGUI offers command-line arguments for seamless JSON export and import without opening the GUI.

Exporting to JSON

`bash

UAssetGUI tojson [mappings name] [asset file] [output JSON file] [Unreal Engine version]

`

Example:

`bash

UAssetGUI tojson A.uasset B.json VERUE425

`

This command will export the A.uasset file to a JSON file named B.json, using the mappings defined in [mappings name] and specifying the Unreal Engine version as VERUE425.

Importing from JSON

`bash

UAssetGUI fromjson [input JSON file] [output asset file] [game name]

`

Example:

`bash

UAssetGUI fromjson B.json A.umap Outriders

`

This command will import the B.json file into a A.umap asset file, assuming the game is Outriders.

Compilation

If you wish to compile UAssetGUI from source, follow these steps:

Prerequisites

1. Visual Studio: Download and install the latest version of Visual Studio.

2. Git: Install Git for version control.

3. .NET Framework: Ensure .NET Framework is installed on your system.

Initial Setup

1. Clone the Repository:

`bash

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

`

2. Navigate to the Directory:

`bash

cd UAssetGUI

`

3. Initialize Submodules:

`bash

git submodule update --init

`

4. Open Solution File: Open the UAssetGUI.sln solution file in Visual Studio.

5. Set Startup Project: Right-click on the UAssetGUI project in the Solution Explorer and click "Set as Startup Project".

6. Restore NuGet Packages: Right-click on the solution name in the Solution Explorer and press "Restore NuGet Packages".

Compilation

1. Compile and Open: Press the "Start" button or press F5 to compile and open UAssetGUI.

Contributing

Contributions to UAssetGUI are highly valued!

Pull Requests: Submit pull requests for bug fixes, new features, or improvements.

Issues: Report any bugs or feature requests by creating an issue on the repository.

If you encounter a "failed to maintain binary equality" error with an Unreal Engine .uasset file, please open an issue on the UAssetAPI issues page, including:

The problematic asset file.

The game name.

The Unreal Engine version used for cooking the asset.

The mappings file for the game (if applicable).

License

UAssetGUI is distributed under the MIT license. You can find the full license details in the LICENSE file.