AssetTools

AssetTools is a standalone utility designed to automate and manage Unreal Engine assets outside of the editor.

• It can generate the JSON file from the uasset file, allowing us to see is data structure.

• It can also recreate the original uasset file from the JSON file.

• The TechNotes can be found in TECHNOTES.

---

✨ Features

Current state:

• 🗂️ Works with non cooked UE4 and UE5 assets files like .uasset and .umap.
• 🗂️ Works with non cooked only.
• 🖥️ Cross-platform (Windows/Linux, if applicable).

Maybe in the future:

• 🔁 Bulk Asset Renaming – Mass-rename assets using rules, prefixes, patterns or data files
• 🔍 Dependency Graph Analysis – Detect what assets depend on others (or are unused)
• 📥 Automated Asset Importing – Batch import textures, meshes, audio, etc. programmatically

---

🚀 Getting Started

📦 Installation

git clone --depth 1 https://github.com/PedroMartinsMenezes/AssetTools.git
cd AssetTools
dotnet build

▶️ Basic Usage

UAsset to Json

Generates JSON file from uasset file:

AssetTool.exe uasset-to-json -i Input.uasset -o Output.json

Json to UAsset

Generates uasset file from JSON file:

AssetTool.exe json-to-uasset -i Input.json -o Output.uasset

Checking the tool

Before using the Tool, please check if it work for your particular asset file:

AssetTool.exe Input.uasset -log

✅ Current Tool Status

The AssetTool is capable to geneare JSON files from the UASSET and UMAP files generated from several UE versions. Please see the TECHNOTES to see how to run the UnitTests.

UE Source Codes

UE Version	File Count (uasset / umap)	Status	Unit Test (uasset / umap)
UE_5.6	19026 / 170	100%	Test_UE56_Assets / Test_UE56_Maps
UE_5.5	16240 / 188	100%	Test_UE55_Assets / Test_UE55_Maps
UE_5.4	15577 / 179	100%	Test_UE54_Assets / Test_UE54_Maps
UE_5.3	13560 / 162	100%	Test_UE53_Assets / Test_UE53_Maps
UE_5.2	9997 / 155	100%	Test_UE52_Assets / Test_UE52_Maps
UE_5.1	9733 / 155	100%	Test_UE51_Assets / Test_UE51_Maps
UE_5.0	8717 / 148	100%	Test_UE50_Assets / Test_UE50_Maps
UE_4.27	7436 / 137	100%	Test_UE427_Assets / Test_UE427_Maps
UE_4.26	7039 / 134	100%	Test_UE426_Assets / Test_UE426_Maps
UE_4.25	5992 / 96	100%	Test_UE425_Assets / Test_UE425_Maps
UE_4.24	5240 / 67	100%	Test_UE424_Assets / Test_UE424_Maps
UE_4.23	4127 / 38	100%	Test_UE423_Assets / Test_UE423_Maps
UE_4.22	3833 / 38	100%	Test_UE422_Assets / Test_UE422_Maps
UE_4.21	3622 / 39	100%	Test_UE421_Assets / Test_UE421_Maps
UE_4.20	3377 / 38	100%	Test_UE420_Assets / Test_UE420_Maps
UE_4.19	2998 / 39	100%	Test_UE419_Assets / Test_UE419_Maps
UE_4.18	2829 / 37	100%	Test_UE418_Assets / Test_UE418_Maps
UE_4.17	2727 / 37	100%	Test_UE417_Assets / Test_UE417_Maps
UE_4.16	2649 / 35	100%	Test_UE416_Assets / Test_UE416_Maps
UE_4.15	2708 / 35	100%	Test_UE415_Assets / Test_UE415_Maps
UE_4.14	2676 / 35	100%	Test_UE414_Assets / Test_UE414_Maps
UE_4.13	2599 / 35	100%	Test_UE413_Assets / Test_UE413_Maps
UE_4.12	2534 / 32	100%	Test_UE412_Assets / Test_UE412_Maps
UE_4.11	2221 / 32	100%	Test_UE411_Assets / Test_UE411_Maps
UE_4.10	2122 / 31	100%	Test_UE410_Assets / Test_UE410_Maps
UE_4.9	2124 / 31	100%	Test_UE409_Assets / Test_UE409_Maps
UE_4.8	2498 / 31	100%	Test_UE408_Assets / Test_UE408_Maps
UE_4.7	1614 / 24	100%	Test_UE407_Assets / Test_UE407_Maps
UE_4.6	1897 / 27	100%	Test_UE406_Assets / Test_UE406_Maps
UE_4.5	1873 / 27	100%	Test_UE405_Assets / Test_UE405_Maps
UE_4.4	1643 / 22	100%	Test_UE404_Assets / Test_UE404_Maps
UE_4.3	1647 / 22	100%	Test_UE403_Assets / Test_UE403_Maps
UE_4.2	1523 / 18	100%	Test_UE402_Assets / Test_UE402_Maps
UE_4.1	1461 / 16	100%	Test_UE401_Assets / Test_UE401_Maps
UE_4.0	1433 / 12	100%	Test_UE400_Assets / Test_UE400_Maps

UE Samples Projects

Source	File Count	Status	Unit Test
Cropout	498	100%	Test_Cropout_Assets
StackOBot	1931	100%	Test_StackOBot_Assets
Lyra	8722	100%	Test_Lyra_Assets

UE ThirdParty Plugins

Source	File Count	Status	Unit Test
Smartsuit	56	100%	Test_UE54_Assets and Test_UE54_Maps

📘 Use Cases

Scenario	Benefit
Cleaning a legacy project	Bulk rename + dependency cleanup
Preparing assets for Marketplace submission	Automated prefixing & validation
Importing 1000+ assets from DCC tools	Batch import without opening UE
CI/CD asset validation	Run in GitHub Actions / Jenkins
Detecting unused or circular dependencies	Visual dependency graph export

🛠️ Roadmap

• GUI version for non-technical users

• Export dependency graph to .png / .svg

• Add CSV/JSON rename rule system

• Support drag-and-drop import pipeline

• Unreal Editor plugin version for integrated workflow

🤝 Contributing

Pull Requests and Issues are welcome! If you have ideas, bugs, or feature requests, feel free to open an issue.

⭐ Support the Project

If this tool is useful to you, please consider giving it a star — it helps visibility and development.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.