---
id: unitypy
version: "1.25.3"
license: MIT License Copyright (c) 2019-2026 K0lb3 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# UnityPy — A Unity extraction and patching package

License: permissive · Maintenance: active · Downloads: 210.2K/mo

## What it is and what it does

UnityPy is a Python library that reads and writes Unity game assets—textures, sprites, meshes, and other serialized objects—extracted from game bundles, APK files, and asset containers. It parses the native typetree structure that Unity uses internally, allowing you to inspect and modify assets in their original form rather than as opaque binary blobs. The library can load assets from file paths, folders, byte streams, or raw bytes, automatically detecting whether the input is a WebFile, BundleFile, Asset, or APK.

The package has 10 runtime dependencies, including compiled C extensions for compression (brotli, lz4) and texture decoding (texture2ddecoder, etcpak, astc-encoder-py). On Windows, Visual C++ Redistributable is required. The C-based typetree reader can crash Python without warning in some cases; a Python fallback exists but must be enabled manually. The library is actively maintained and supports Python 3.8 and newer, with precompiled wheels for most platforms and Python versions.

Use it for:

- Extract textures and sprites from game asset bundles for analysis or archival.
- Modify game assets (rename objects, change texture data) and save edited bundles back to disk.
- Automate bulk extraction of specific object types (meshes, audio, configuration files) from game files.
- Inspect the structure and metadata of Unity serialized assets for reverse-engineering or data-mining projects.
- Parse APK files from mobile games to access embedded Unity assets.
- Patch game assets programmatically by parsing as dict or class, modifying fields, and writing back.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

UnityPy extracts and edits Unity asset files (textures, sprites, meshes, and other object types) from game bundles, APK files, and serialized assets, supporting both read and write operations via native typetree structures.

Yes, if you need to extract or edit Unity game assets. The library is actively maintained with recent releases and has no known security vulnerabilities. Install friction is moderate due to compiled dependencies and a potential C-typetree crash risk, but precompiled wheels and a fallback mode mitigate these. MIT license is permissive for both open and commercial use. Pin the version if you cannot tolerate breaking changes between minor releases.

## Install

pip install unitypy
uv add unitypy
poetry add unitypy

## Installing UnityPy

Before you install: Medium install friction: 10 runtime dependencies including compiled C extensions (brotli, lz4, texture2ddecoder, etcpak, astc-encoder-py). On Windows, Visual C++ Redistributable is required. The C-typetree reader can crash Python without warning; a fallback mode exists but must be manually enabled. Active maintenance with recent releases.

License in practice: MIT License (permissive): you can use, modify, and distribute UnityPy freely in commercial and private projects, but must include the license notice. The author requests sponsorship or charitable donation for commercial use.

Quickstart:

import UnityPy

env = UnityPy.load('path/to/asset_file')
for obj in env.objects:
    if obj.type.name == 'Texture2D':
        data = obj.parse_as_object()
        img = data.image
        img.save('output.png')

Visual C++ Redistributable required on Windows; C-typetree reader may crash Python without warning (disable via configuration if needed).

Verify before relying:

- Whether the C-typetree crash occurs in typical workflows or only edge cases.
- Performance characteristics when processing large asset bundles or many objects.
- Compatibility with all Unity versions and asset formats beyond the documented examples.
- Whether breaking changes between minor versions (x.y) are frequent enough to require version pinning in production.
- Actual download volume and user base size to assess community support.

## Package facts

- License: MIT License Copyright (c) 2019-2026 K0lb3 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 210.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

unity asset extractor, extract unity game files, unity texture extraction, parse unity bundles, unity asset editor, game data mining, unity serialized file parser, game-modding, asset-extraction, reverse-engineering

[View on SkillFed](https://skillfed.io/packages/unitypy) · [View on PyPI](https://pypi.org/project/unitypy/)