forked from ata4/disunity
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
41 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,9 +1,46 @@ | ||
DisUnity | ||
========= | ||
======== | ||
|
||
An experimental command-line toolset for Unity asset and asset bundle files, mostly designed for extraction. | ||
An experimental command-line toolset for Unity asset and asset bundle files written in Java, mostly designed for extraction. | ||
|
||
Download | ||
-------- | ||
### Download | ||
|
||
The latest build can be found on the [releases page](https://github.com/ata4/disunity/releases). | ||
|
||
### A note about the versions | ||
|
||
0.3 works best with Unity 3.x and has most of the original extraction features. | ||
|
||
0.4 is a somewhat incomplete and untested upgrade to support Unity 4 and 5 and has some of the extraction features of 0.3. | ||
|
||
0.5 is a code rewrite to properly support all Unity games from 2 to 5 that also comes with unit tests. Right now, it only | ||
supports raw file reading and writing without any object deserialization, therefore it also can't extract any asset data directly. | ||
|
||
### Usage | ||
|
||
disunity <command> [options] <file> | ||
|
||
**Note:** depending on the platform, you may need to run disunity.bat (Windows) or disunity.sh (Linux/MacOS). In case the launch script fails, try `java -jar disunity.jar`. | ||
|
||
### Available commands (v0.5) | ||
|
||
## Asset commands | ||
|
||
| Command | Purpose | ||
| :---------------- | :---------------- | ||
| asset blocks | List data block offsets and sizes. Could be useful for manual extraction. | ||
| asset externals | List asset file dependencies. | ||
| asset header | Display some information from the file header. | ||
| asset objectids | List object identifiers (Unity 5 and higher only). | ||
| asset objects | List object data entries. | ||
| asset types | Display embedded runtime type information. | ||
| asset unpack | Unpacks raw data blocks from a file. Could be useful for manual extraction. | ||
|
||
## Asset bundle commands | ||
|
||
| Command | Purpose | ||
| :---------------- | :---------------- | ||
| bundle list | List bundled files. | ||
| bundle info | Display some information from the file header. | ||
| bundle pack | Pack files into a bundle. Requires a bundle property file. | ||
| bundle unpack | Unpack files from a bundle. |