# JsonAsAsset [![Discord](https://camo.githubusercontent.com/a73a3dd0493a0ccf50724572638274e5c626545fee8ea599cf7714327cbcf563/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4a6f696e253230446973636f72642d436f6c6c6563746f723f636f6c6f723d303336336666266c6f676f3d646973636f7264266c6f676f436f6c6f723d7768697465267374796c653d666f722d7468652d6261646765)](https://discord.gg/xXEw4jc2UT) [![GitHub Downloads (all assets, all releases)](https://camo.githubusercontent.com/52eec0c4aedc780d04974aa2b65bfd72fc4ceca0f1721ec423b1e57e39e31a09/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f4a736f6e417341737365742f4a736f6e417341737365742f746f74616c3f7374796c653d666f722d7468652d6261646765266c6162656c3d444f574e4c4f41445326636f6c6f723d23303366666338)](https://github.com/JsonAsAsset/JsonAsAsset/releases) [![GitHub Repo stars](https://camo.githubusercontent.com/c9ad4ce9b4246ba8c27bc2cc34e76229ca31bde75f45260d2d8a1a6699169ea3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f4a736f6e417341737365742f4a736f6e417341737365743f7374796c653d666f722d7468652d6261646765266c6f676f3d26636f6c6f723d676f6c64)](https://github.com/JsonAsAsset/JsonAsAsset/stargazers) [![Unreal Engine 5 Supported)](https://camo.githubusercontent.com/b60f3aef15b1c445e5f8823e9bcf3a5fd0b333d88b42bf0032ec5eea640e3e38/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5545352e302b2d626c61636b3f6c6f676f3d756e7265616c656e67696e65267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d67726579)](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#install) [![Unreal Engine 4.27.2 Supported)](https://camo.githubusercontent.com/cf1eaa8e04567b3f537220a15b4c29d136a7742741e74c199cba2ded35d8327a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f342e32372e322d626c61636b3f6c6f676f3d756e7265616c656e67696e65267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d67726579)](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#install) [![Unreal Engine 4.26.2 Supported)](https://camo.githubusercontent.com/7f9c9927cc1de94f076a6707bb4734c8874330a1c7e0bf2085bb02353e2b60ab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f342e32362e322d626c61636b3f6c6f676f3d756e7265616c656e67696e65267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d67726579)](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#install) [![Unreal Engine 4.26.0 Supported)](https://camo.githubusercontent.com/d93dca34eabfc167c28f70371fd855ed43c7b64a1b9b5f4df19cddbfc9943b06/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f342e32362e302d626c61636b3f6c6f676f3d756e7265616c656e67696e65267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d67726579)](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#install) ### Description: A user friendly plugin for [Unreal Engine](https://www.unrealengine.com/en-US) that reads [JSON](https://www.json.org/json-en.html) files extracted from [FModel](https://fmodel.app), and regenerates assets as they were from the game's files. ✨ [Contributors](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#contribute) ### Example Use: - Porting **materials**, data assets, data tables *[(see more here)](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#introduction)* - Porting **physics assets** for skeletal meshes - Porting **sound effects** to Unreal Engine - Automating the porting process for users The goal of this project is to simplify the process for the porting and modding communities, enabling them to more easily port over assets into Unreal Engine. ----------------- ### **Table of Contents**: > 1. [Introduction to JsonAsAsset](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#introduction) > 1.1 [Supported Asset Types](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#supported-asset-types) > 3. [→ Installation](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#install) > 2.1 [FModel](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#setup-fmodel) > 2.2 [Settings](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#setup-settings) > 4. [→ Using JsonAsAsset](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#plugin-usage) > 5. [Local Fetch](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#local-fetch) > 4.1 [Setup Local Fetch Settings](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#setup-local-fetch) > 4.2 [Launching Local Fetch](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#launch-local-fetch) **Extras**:
> - [Common Errors 🐛](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#common-errors) > - [Licensing 📗](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#licensing) ----------------- ## 1. Introduction to JsonAsAsset > [!WARNING] > Please note that this plugin is intended solely for **personal and educational use**. Do not use it to create or distribute **commercial products** without obtaining the necessary **licenses and permissions**. It is important to respect **intellectual property rights** and only use assets that you are **authorized to use**. We do not assume any responsibility for the way the created content is used. JsonAsAsset is a user-friendly Unreal Engine plugin for importing assets from packaged games using JSON files. Primarily from CUE4Parse and the use of the application [FModel](https://fmodel.app) to export JSON files. ------------------ #### 1.1 Supported Asset Types | Asset Category | Asset Types / Description | |--------------------------------|------------------------------------------------------------------------------------------------------------------------| | Curve Asset Types | CurveFloat, CurveTable, CurveVector, CurveLinearColor, CurveLinearColorAtlas | | Data Asset Types | DataAsset, SlateBrushAsset, SlateWidgetStyleAsset, AnimBoneCompressionSettings, AnimCurveCompressionSettings, UserDefinedEnum, UserDefinedStruct | | Table Types | CurveTable, DataTable, StringTable | | Materials | Material, MaterialFunction, MaterialInstanceConstant, MaterialParameterCollection, SubsurfaceProfile | | Sound Classes | Most/all sound classes are supported. SoundWave is downloaded by [Local Fetch](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#local-fetch). | | Animation Asset Types | Skeleton, SkeletalMeshLODSettings, BlendSpace, BlendSpace1D, AimOffsetBlendSpace, AimOffsetBlendSpace1D | | Physics Asset Types | PhysicsAsset, PhysicalMaterial | | Sequencer Asset Types | CameraAnim | | Landscape Asset Types | LandscapeGrassType, FoliageType_InstancedStaticMesh, FoliageType_Actor | ##### The following asset types add onto a pre-existing asset | Asset Category | Asset Types / Description | |-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------| | Animations | AnimSequence, AnimMontage [Animation Curves] | **Material/Niagara Data**:
Unreal Engine games made below 4.12 (a guess) will have material data, but not niagara data, any games made above that version will most definitely not have any material data nor niagara data, and therefore the actual data will be stripped and cannot be imported. **Unless** you are using a User Generated Content editor, then it's possible material data and niagara data will be there. **NOTE:** If your game uses custom C++ classes or structures, you need to define them before importing with JsonAsAsset. JsonAsAsset does not create C++ files for you. (create them manually from SDKs or automate them) See [Unreal Engine Modding Projects](https://github.com/Buckminsterfullerene02/UE-Modding-Tools?tab=readme-ov-file#game-specific-template-projects) for game-specific template projects. ## 2. Installation > [!NOTE] > JsonAsAsset may not work with every Unreal Engine version. Please check the [Releases page](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/releases) for compatibility details. Follow these steps to install **JsonAsAsset**: 1. **Visit the Releases Page:** Go to the [Releases page](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/releases) for the plugin. 3. **Download the Appropriate Release:** Download the release that matches your version of Unreal Engine. If a matching release isn’t available, [**compile the plugin yourself**](https://dev.epicgames.com/community/learning/tutorials/qz93/unreal-engine-building-plugins). 5. **Extract the Files:** Extract the downloaded files to your project’s `Plugins` folder. If the folder doesn’t exist, create it in the root directory of your project. 7. **Open Your Project** Launch your Unreal Engine project. 8. **Access the Plugins Window:** Navigate to **Edit → Plugins**.

10. **Enable JsonAsAsset:** In the Plugins window, search for `JsonAsAsset` and enable it. 11. **Restart the Editor:** Restart the Unreal Engine editor to apply the changes. -------------------- #### 2.1 Setup FModel If you haven't already, **install FModel and set it up correctly, then proceed with the setup**. [

](https://fmodel.app) The JSON format/file has to be from a program that fits the format of FModel's JSON export files:

[FModel](https://fmodel.app) *(Software for exploring Unreal Engine games)*

-------------------

#### 2.2 Setup Settings 1. **Open Plugin Settings:** Click on the JsonAsAsset dropdown, then select Open Plugin Settings. 3. **Import Settings from FModel:** Locate Load External Configuration and press **FModel Settings**, your settings should be changed. If not, copy your export directory from FModel. ---------- That’s the basic setup! Here's how to use JsonAsAsset. ##### Using JsonAsAsset 1. Find a asset in [FModel](https://fmodel.app), and save it by right clicking and pressing `Save Properties`. Locate the file on your computer and copy the location. 2. Press onto the [JsonAsAsset](https://github.com/JsonAsAsset/JsonAsAsset) button on your tool-bar, and a file import should pop-up.

3. Paste in the file's path, select the file and press open. 4. The asset will import, and bring you to the created asset in the content browser. (if the asset type is supported) To bulk import assets and **what they reference**, you must set up [`Local Fetch`](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#setup-local-fetch)! ## 4. Local Fetch [Local Fetch](https://github.com/JsonAsAsset/LocalFetch) is a way to automate importing assets that other assets reference, built into JsonAsAsset. **It supports all asset types except AnimSequence/AnimMontages.** Learn how to [set up Local Fetch](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/#setup-local-fetch). ------------------------ #### 4.1 Local Fetch Settings 1. **Open Plugin Settings:** Click on the JsonAsAsset dropdown, then select Open Plugin Settings.

2. **Enable Local Fetch:** Locate the property **Enable Local Fetch** and turn it on. 3. **Setup Local Fetch's Settings:** Make sure to set these in your settings: - **Directory**: specific Paks folder of your game - **Unreal Engine**: version that your game is running - **Mappings File**: file path to your mappings file - **Encryption Keys**: if your game needs AES Keys, set them ###### Fetch Encryption from an API You can automatically have your AES Keys changed if your game has a API ran by someone else, you can fetch aes keys and mappings from an API in the section **Local Fetch - Encryption**. ------------ #### 4.2 Launch Local Fetch

Running the API requires ASP.NET 8.0 to be installed; please install this [here](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.1-windows-x64-installer). Go ahead and click on the JsonAsAsset logo and hover over the list `"Command-line Application"` and press `"Execute Local Fetch (.EXE)"`. A window should pop-up, and once the console says `[CORE] Running API`, Local Fetch has been successfully started! Make sure to keep this window open until you are done with JsonAsAsset. JsonAsAsset will now use Local Fetch to import if a missing asset is referenced. ## Common Errors 🐛

Attempted to create a package with name containing double slashes. PackageName: ...

------------ Please set your Export Directory to your actual "Output/Exports" directory ***WRONG***: T:/FModel/Output ***RIGHT***: T:/FModel/Output/Exports

Assertion failed: TextureReferenceIndex != INDEX_NONE

------------ This is a known issue in our code that we haven't fully resolved yet. While previous attempts to fix it have been unsuccessful, here’s a partial solution to reduce its occurrence: - Re-launch your Unreal Engine project, go to JsonAsAsset's plugin settings and enable ***"Skip Result Node Connection"***. Also enable ***"Allow Package Saving"***.

Local Fetch closes instantly when executing

------------ There may be a few reasons why the application automatically closes, but mostly the issue stems from something missing: ### 1. Your settings aren't correct, and need modifications > Make sure all the information about your game is set in the settings. ### 2. ASP.NET 8.0 not installed > Running the API requires ASP.NET 8.0 to be installed, please install this [here](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.1-windows-x64-installer).

## Licensing 📗 JsonAsAsset is licensed under the MIT License, read more in the [LICENSE](https://github.com/JsonAsAsset/JsonAsAsset/raw/main/LICENSE) file. The plugin also uses [Detex](https://github.com/hglm/detex) and [NVIDIA Texture Tools](https://docs.nvidia.com/texture-tools/index.html). ## ✨ Contributors Thanks go to these wonderful people:

_Tector
Developer

_GMatrixGames
Developer

_Zylox
Maintainer

Nathan Felipe
Help with SoundCue Code

- Thanks to the people who contributed to [UEAssetToolkit](https://github.com/Buckminsterfullerene02/UEAssetToolkit-Fixes)! They have helped a lot. - Logo uses a font by [Brylark](https://ko-fi.com/brylark), support him at his ko-fi! #### [Would you like to contribute?](https://github.com/JsonAsAsset/JsonAsAsset/blob/main/Source/README.md#key-information-for-contributors-)