Description

JsonAsAsset is an Unreal Engine plugin that reads JSON files from CUEParse (FModel), and rebuilds assets like materials, data tables, physics assets, and more.

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

Licensing

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

---

Table of Contents

1. Asset Types
2. Installation
3. → Workflow

Extras:

• Common Errors 🐛

---

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

---

Asset Types

If an asset type isn't listed below, it's not currently supported by the plugin.

	Asset Types
🟢 Curve	CurveFloat, CurveTable, CurveVector, CurveLinearColor, CurveLinearColorAtlas
🟣 Data	DataAsset, SlateBrushAsset, SlateWidgetStyleAsset, AnimBoneCompressionSettings, AnimCurveCompressionSettings, UserDefinedEnum, UserDefinedStruct
🔵 Table	CurveTable, DataTable, StringTable
🟠 Material	Material, MaterialFunction, MaterialInstanceConstant, MaterialParameterCollection, SubsurfaceProfile
🟧 Texture	TextureRenderTarget2D, RuntimeVirtualTexture
🟡 Sound	Most/all sound classes are supported. SoundWave is downloaded by a Cloud Server!
🔴 Animation	PoseAsset, Skeleton, SkeletalMeshLODSettings, BlendSpace, BlendSpace1D, AimOffsetBlendSpace, AimOffsetBlendSpace1D
⚪ Physics	PhysicsAsset, PhysicalMaterial
🟤 Sequencer	CameraAnim
🟩 Landscape	LandscapeGrassType, FoliageType_InstancedStaticMesh, FoliageType_Actor

The following asset types add onto a pre-existing asset

	Asset Types
🔴 Animation	AnimSequence, AnimMontage (Animation Curves)

🟠 Material Data Prerequisites

Unreal Engine games made below 4.12 (a guess) will have material data, any games made above that version will most definitely not have any material 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 will be there.

🟣 C++ Classes Prerequisites

If your game uses custom C++ classes or structures, you need to define them.

See Unreal Engine Modding Projects for game-specific template projects.

Installation

[!IMPORTANT] If you haven't already, install FModel and set it up correctly, then proceed with the setup.

​There is a specific FModel version for material data support found in the discord server.
Material Data Prerequisites still apply. ​

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

Workflow

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="206" height="96" src=https://github.com/user-attachments/assets/6a9bf925-484b-4c23-b0ed-c59d58c5d07c>

3. Select the file and press open.

4. The asset will import, and bring you to the created asset in the content browser.

[!TIP]

Want to import entire asset chains automatically? 💡

Enable Cloud in Plugin Settings, and setup a Cloud Server. Click here to get to Cloud releases.

Once the Cloud is started, JsonAsAsset will fetch every referenced asset for you hands-free.

Common Errors 🐛

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

✨ Contributors

Thanks go to these wonderful people:

Tector Creator

GMatrixGames Collaborator

Zylox Casual Maintainer

• 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?