Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dirkchristianbecker/unity_unpacker

A command line too, that allows users to unpack unitypackage files.
https://github.com/dirkchristianbecker/unity_unpacker

Last synced: about 20 hours ago
JSON representation

A command line too, that allows users to unpack unitypackage files.

Awesome Lists containing this project

README

        

# Unity Unpacker
'Unity Unpacker' is a command line tool designed to unpack '.unitypackage' files.

'.unitypackage' files are essentially gzip/tar archives that contain a directory for each asset in a unity project. The name of the directory is the guid that was assigned to the asset by the Unity Editor. Each asset has an accompanying '.meta' file that contains import settings for the Unity Editor/Engine.

What this tool does is first unpack the package into a temporary directory and after that moving the assets and the accompanying meta files over to the target directory. The tool will create all directories the package contains, so it reflects the folder structure of the package in the Unity Editor. However the extension '.meta' will be changed to '.unitymeta' since the meta extension is too generic and creates conflicts with other game engines.

## Usage
Unity unpacker requires at least one parameter, the file name i. E.:
```
./unity_unpacker -f test.unitypackage
```
This command would extract the file test.unitypackage in the current working directory. If no target path is provide, the tool creates a directory with the same name as the name of the package (test in this example), in the current working directory.

However, using the 'dir' parameter the target directory can be passed to the tool. On top of that the 'tmp_dir' parameter can be used to set a directory the package is unpacked to, before moving the assets files over to the target directory.
```
./unity_unpacker -f assets/test.unitypackage -d assets/test -t assets/tmp
```

All directories that are needed will be created.

By default the temporary directory will be deleted after all assets have been moved over to the target. However, if 'remove_tmp' is set to false, the temp directory will remain. This can be usefull for debugging purposes.

## Assets
All assets are from https://opengameart.org and are licenced as CC0.