https://github.com/mos9527/unitypylive2dextractor

Unity Live2D Asset Extractor / Unity Live2D 资源解包工具
https://github.com/mos9527/unitypylive2dextractor

live2d unity unitypy

Last synced: 21 days ago
JSON representation

Unity Live2D Asset Extractor / Unity Live2D 资源解包工具

• Host: GitHub
• URL: https://github.com/mos9527/unitypylive2dextractor
• Owner: mos9527
• Created: 2024-08-18T02:32:12.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-23T12:26:45.000Z (about 1 year ago)
• Last Synced: 2025-01-31T03:35:22.769Z (10 months ago)
• Topics: live2d, unity, unitypy
• Language: Python
• Homepage: https://github.com/mos9527/sssekai
• Size: 12.7 KB
• Stars: 10
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# UnityPyLive2DExtractor

[![Windows Build](https://github.com/mos9527/UnityPyLive2DExtractor/actions/workflows/python-publish.yml/badge.svg)](https://github.com/mos9527/UnityPyLive2DExtractor/blob/main/.github/workflows/python-publish.yml) 

[![Releases](https://img.shields.io/github/downloads/mos9527/UnityPyLive2DExtractor/total.svg)](https://GitHub.com/mos9527/UnityPyLive2DExtractor/releases/) 

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) 

General purpose [Live2D](https://www.live2d.com/) Asset recovery tool built w/ [UnityPy](https://github.com/K0lb3/UnityPy) and [sssekai](https://github.com/mos9527/sssekai)

As the name suggests, this project is heavily inspired by [Perfare/UnityLive2DExtractor](https://github.com/Perfare/UnityLive2DExtractor). With a few key differences:

- All Live2D types are implemented with [dumped TypeTree](https://github.com/mos9527/UnityPyLive2DExtractor/blob/main/external/typetree_cubism.json) and [generated types](https://github.com/mos9527/UnityPyLive2DExtractor/blob/main/typetree_codegen.py). This should help with compatibility issues.

    - Do note, however, that you may need to update the TypeTree if the Live2D version changes.

    - Generate the TypeTree with [UnityPyTypetreeCodegen](https://github.com/mos9527/UnityPyTypetreeCodegen) and replace the existing TypeTree at `UnityPyLive2DExtractor/generated`

    - A valid command could be something like

        ```bash

        UnityPyTypetreeCodegen --unity-version 2019.4.34f1 --asm-dir Game/Managed --outdir .\UnityPyLive2DExtractor\generated

        ```

- New (not necessarily better) asset discovery method. Though proven to be more reliable in some cases.

## Installation

- Install the script from PyPI

```bash

pip install UnityPyLive2DExtractor

```

- Or, you can use the pre-built executables for Windows from [Releases](https://github.com/mos9527/UnityPyLive2DExtractor/releases/).

## Usage

```bash

UnityPyLive2DExtractor  

```

Where `` is the path to your game's path, and `` is the directory to extract the Live2D assets to.

## References

- https://github.com/Perfare/UnityLive2DExtractor

- https://github.com/K0lb3/TypeTreeGenerator

- https://github.com/K0lb3/UnityPy