UEFormat — FModel / Blender Edition

An edited UEFormat pipeline for moving Unreal Engine assets from FModel into Blender through validated .uemodel, .ueanim, and .uescene files.

This repository is a working fork of h4lfheart/UEFormat. It keeps the original exchange format and plugins while extending the workflow around FModel exports, Blender scene import, material links, and reproducible tests.

Edited pipeline

Unreal Engine archives
        │
        ▼
FModel / CUE4Parse exporters
        │  .uemodel · .ueanim · .uescene
        ▼
UEFormat validation and resource links
        │
        ▼
Blender 5.2 importer

The edited pipeline focuses on complete, inspectable imports instead of only single static meshes. It preserves source provenance and reports failures at the scene and resource boundary so exported data can be diagnosed and tested.

Plugins

• Blender importer
• Unreal Engine plugin

Edited capabilities

• UEScene actor, hierarchy, static-mesh, material, and light import into Blender.
• Strict required-model validation with staged scene import and rollback on failure.
• UEMODEL geometry, skeleton identity, source LOD selection, and material-slot mapping.
• FModel material and texture URI resolution with explicit source-slot provenance.
• Material parameter metadata retention and safe handling of sparse or renamed links.
• Optional ISM/HISM flattening while retaining shared instanced geometry by default.
• UEANIM timing and source tick semantics preserved for Blender animation import.
• Operator, deployed-Blender, fixture, release-parity, and golden-data coverage.

Supported Exporters

• FortnitePorting
• FModel
• CUE4Parse

Testing

The Python suite covers protocol readers, FModel material links, UEScene validation and staging, Blender operator behavior, fixture-based imports, and release source parity. From this repository root, run:

pytest -q

Blender deployment smoke tests are kept alongside the regular Python tests so the source addon and the managed Blender addon can be checked separately.

Format Specification

• Generic
• UEModel
• UEAnim
• UEPose

Upstream and scope

The exchange format remains compatible with the upstream UEFormat project wherever possible. Changes in this fork are centered on the FModel-to-Blender workflow: scene-level import reliability, material and texture resource links, source identity, diagnostics, and verification. Upstream protocol and plugin work remains credited to the original maintainers.