Metadata-Version: 2.4
Name: unreal-assets-to-glb
Version: 4.27.2.0
Summary: Extract static meshes (.glb) and base-color textures (.png) from uncooked Unreal Engine .uasset files, with an optional browser level preview.
Author: Velikiy Prikalel
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/Prikalel/unreal-assets-to-glb
Project-URL: Repository, https://github.com/Prikalel/unreal-assets-to-glb
Project-URL: Issues, https://github.com/Prikalel/unreal-assets-to-glb/issues
Project-URL: Changelog, https://github.com/Prikalel/unreal-assets-to-glb/releases
Keywords: unreal-engine,uasset,umap,glb,gltf,ue4,ue5,static-mesh,exporter,game-assets
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: numpy>=1.24.0
Requires-Dist: tqdm>=4.60.0
Requires-Dist: pyooz>=0.0.8
Requires-Dist: pygltflib>=1.16.0
Requires-Dist: Pillow>=9.0.0
Dynamic: license-file

# UE4.27 UAsset Parser & Exporter

Extracts static meshes (glb) and base color textures (PNG) from Unreal Engine 4.27 `.uasset` files. Supports browser-based level preview with `--preview`.

## Requirements

- Python 3.10+
- numpy
- Pillow
- pyooz (provides the `ooz` Oodle-decompression module)
- pygltflib
- tqdm

## Usage

```bash
# Extract meshes and textures
python main.py ./Input

# Extract and preview a level in browser (port 3050)
python main.py ./Input --preview L_Showcase.umap

# Preview without re-exporting
python main.py ./Input --skip-export --preview L_Showcase.umap

# Export without textures
python main.py ./Input --skip-textures

# Export only meshes with certain filesname (all containing Pipe in name)
python main.py ./Input --filter Pipe
```

The input directory should contain a `.uproject` file and a `Content/` folder with `.uasset` / `.umap` files.

The output is `./Export` folder created in current workspace.

## Features

- level parts (level isntansing) included in preview
- material parent recursive search
- material slot indexes recognition
- only 1 UV channel
- texture override in material instance

## Not included

- lights,
- colliders,
- PBR textures,
- vertex colors,
- tangents,
- LOD
- shaders,
- texture baking,
- Nanite,
- animation decompression
- skeletons/bones
