Description:

A user-friendly plugin for Unreal Engine that reads JSON files extracted from CUE4Parse (often FModel), and regenerates assets as they were from the game's files.

✨ Contributors

Example Use:

• Importing materials, data assets, and data tables — see more
• Porting physics assets for skeletal meshes
• Porting sound effects to Unreal Engine
• Automating asset porting workflows

This project aims to streamline the porting and modding experience, making it easier to bring game assets into Unreal Engine.

---

[!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.

---

Table of Contents:

1. Supported Asset Types
2. → Installation
   2.1 FModel
   2.2 Settings
3. → Using JsonAsAsset
4. → Cloud Server

Extras:

• Common Errors 🐛
• Licensing 📗

---

1. Supported Asset Types

Here are the supported asset types for JsonAsAsset:

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 a Cloud Server.
Animation Asset Types	PoseAsset, 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 for game-specific template projects.

2. Installation

Follow these steps to install JsonAsAsset:

1. Visit the Releases Page:
   Go to the Releases page for the plugin.
2. 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.
3. 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.
4. Open Your Project
   Launch your Unreal Engine project.
5. Access the Plugins Window:
   Navigate to Edit → Plugins. <img align="right" width="387.4" height="75.4" src=https://github.com/user-attachments/assets/c0867324-5129-49e4-9f9c-9804c93cdf73>
6. Enable JsonAsAsset:
   In the Plugins window, search for JsonAsAsset and enable it.
7. 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.

The JSON format/file has to be from a program that fits the format of FModel's JSON export files:

FModel (Software for exploring Unreal Engine games)

---

<img align="right" width="315" height="190.4" src=https://github.com/user-attachments/assets/909e2db1-e0d9-4aae-9b8b-7190cf6718b3>

2.2 Setup Settings

1. Open Plugin Settings:
   Click on the JsonAsAsset dropdown, then select Open Plugin Settings.

2. 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.

---

4. Using JsonAsAsset

1. Find a asset in FModel, 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 button on your tool-bar, and a file import should pop-up. <img align="right" width="220" height="98" src=https://github.com/user-attachments/assets/514d7661-f2f6-4343-8c9c-ed875ddb5156>

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 a Cloud Server!

4. Cloud Server

A Cloud Server is a server that hosts a Web API, allowing JsonAsAsset to communicate directly with the game files. JsonAsAsset will automate importing assets that assets reference. It supports all supported asset types except AnimSequence/AnimMontages. Use and setup a app that has a built-in cloud server.

The following apps can host a Cloud Server:

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".

Licensing 📗

JsonAsAsset is licensed under the MIT License, read more in the LICENSE file. The plugin also uses Detex and NVIDIA Texture Tools.

✨ Contributors

Thanks go to these wonderful people:

Tector Developer	GMatrixGames Collaborator	Zylox Maintainer
Nathan Felipe Help with SoundCue Code

• Thanks to the people who contributed to UEAssetToolkit! They have helped a lot.
• Logo uses a font by Brylark, support him at his ko-fi!

Would you like to contribute?