Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AssetRipper #954

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 3 additions & 78 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,81 +1,6 @@
# uTinyRipper
[![Download uTinyRipper](https://a.fsdn.com/con/app/sf-download-button)](https://sourceforge.net/projects/utinyripper/files)
# Attention

[![Build status](https://ci.appveyor.com/api/projects/status/yd78hqp83f7vjkwb?svg=true)](https://ci.appveyor.com/project/mafaca/utinyripper)
[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/UtinyRipper/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Work on this repository has been suspended.

uTinyRipper is a tool for extracting assets from serialized files (*CAB-*\*, *\*.assets*, *\*.sharedAssets*, etc.) and assets bundles (*\*.unity3d*, *\*.assetbundle*, etc.) and converting them into native Engine format.
The [AssetRipper](https://github.com/AssetRipper/AssetRipper) fork has taken over development. Please redirect all [pull requests](https://github.com/AssetRipper/AssetRipper/pulls) and [issues](https://github.com/AssetRipper/AssetRipper/issues) to that repository. Support for newer versions has already been added there.

Important note: work on this project has been suspended. The Author is going to restart it from scratch, please redirect development and focus on other things. So don't waste your time on PRs, propositions or complex issues. The only exception is bug fixes.

Supported versions: 1.x to 2019.x (since development is suspended, 2020.x or greater won't be supported)

## Export features
* Scenes
* Prefabs (GameObjects with transform components)
* AnimationClips (legacy, generic, humanoid)
* Meshes
* Shaders (native listing)
* Textures
* Audio
* Fonts
* Movie textures
* Materials
* AnimatorControllers
* Avatars
* Terrains
* TextAssets
* Components:
* MeshRenderer
* SkinnedMeshRenderer
* Animation
* Animator
* Canvas
* Light
* ParticleSystem
* Colliders
* Rigidbody
* AudioSource
* Camera
* MonoBehaviour (Mono only)
* MonoScript (Mono only)

## Structure

* *uTinyRipperCore*

Core library. It's designed as an single module without any third party dependencies.

* *uTinyRipperGUI*

Basic graphic interface application. It has some extra converters, so additionally it exports:
* AudioClip .wav export
* Texture2D .png export (with Sprites)
* Shader DirectX blob export
* References to build-in Engine assets

* *uTinyRipperConsole* and *uTinyRipperConsoleNETCore*

Sample console application which is designed to test Core library functionality.
It's a command line application. Drag and drop resource file(s) or/and folder(s) onto the .exe to retrieve the assets. It will then automaticly try to find resource dependencies, create a 'Ripped' folder and extract all supported assets into the created directory.
As this is a sample application, I'm not going to improve it in any way.



### Requirements:

If you want to build a solution, you'll need:

\- .NET Framework 4.7.2 + .NET Core 2.0 SDK

\- Compiler with C# 7.3 syntax support (Visual Studio 2017)


If you want to run binary files, you need to install:

\- [.NET Framework 4.7.2](https://support.microsoft.com/en-us/help/4054530/microsoft-net-framework-4-7-2-offline-installer-for-windows)

\- [Microsoft Visual C++ 2015](https://www.microsoft.com/en-us/download/details.aspx?id=53840) Redistributables

\- [Unity 2017.3.0f3 or greater](https://unity3d.com/get-unity/download/archive) (NOTE: your editor version must be no less than the game's version)