Known Limitations - thethiny/NRS-Asset-Manager GitHub Wiki

Known Limitations

Array Element Type Detection

UE3 doesn't serialize array element types. Element types are inferred from property names via whitelists (STRING_ARRAY_KEYS, NAME_ARRAY_KEYS, INT_ARRAY_KEYS). Unknown array keys default to StructProperty.

Symptom: "Name index out of range" errors when encountering an unknown TArray<FString> or TArray<FName>.

Fix: Add the array's key name to the appropriate whitelist in ue3_properties.py.

MapProperty Variants

Maps also require key/value type inference from the property name. Unknown map keys will raise NotImplementedError.

MK11 PSF Decompression

Some MK11 PSF files cause Oodle v5 DLL segfaults during decompression. This appears to be a DLL compatibility issue. Parsing with skip_bulk=True works around this.

MK11 aut_fi / ben_fi Files

These files have compression flag 221804592 which doesn't map to any known CompressionType enum value. They may be from a different engine version or use a format not yet supported.

Audio Exports

NRSAudioBank, NRSAudioEvent, and NRSAudioStreamingSource exports parse successfully but have no handler — the raw data is likely RIFF/WAV audio that needs a dedicated handler.

Unsupported Export Types

The following export types have no handler and are extracted as raw binary blobs:

  • SkeletalMesh — 3D mesh data
  • MaterialInstanceConstant — Material parameters
  • MKClothSet — Cloth simulation data
  • AnimSequence — Animation data
  • Various script/package types
⚠️ **GitHub.com Fallback** ⚠️