a backup of https://github.com/razmoth/HoYoStudio

HoYoStudio

Check out the original AssetStudio project for more information.

---

This is probably the last releast on HoYoStudio before the DMCA takedown notice is applied by Hoyoverse on Github, Thank you so much to everyone who has helped in the making of this project as well as those who have provided feedback, until next time. https://github.com/Razmoth/HoYoStudio/releases/tag/v0.17.00

---

New Discord Server:

Join here for more discussions, questions, suggestions and feedback.

---

This is the release of HoYoStudio, Modded AssetStudio that should work on:

- Genshin Impact.
- Honkai Impact 3rd.
- Honkai: Star Rail.
- Tears of Themis.

Note: Requires Internet connection to fetch asset_index jsons.

---

Some features are:

- Change selected Game by using "Option -> Specify Game".
- Integration with "Radioegor146" repo to load asset_index through "Options -> Specify AI version".
- Exportable Assets (not all of them) with XOR/JSON support for "MiHoYoBinData"
- Togglable debug console.
- Container/filename recovery for Assets.
- Build AssetMap, An asset list of assets inside game files.
- Build CABMap/AssetMap through CLI (with supported `Unity Type` and `Regex` filters).
- Export assets through CLI (with supported `Unity Type` and `Regex` filters and grouping).

---

How to use:

1. Build CABMap (Misc. -> Build CABMap).
2. Load files.

---

CLI Version:

Description:

Usage:
  AssetStudioCLI <input_path> <output_path> [options]

Arguments:
  <input_path>   Input file/folder.
  <output_path>  Output folder.

Options:
  --silent                                                Hide log messages.
  --type <Texture2D|Sprite|etc..>                         Specify unity class type(s)
  --filter <filter>                                       Specify regex filter(s).
  --game <BH3|GI|SR|TOT> (REQUIRED)                       Specify Game.
  --map_op <AssetMap|Both|CABMap|None>                    Specify which map to build. [default: None]
  --map_type <JSON|XML>                                   AssetMap output type. [default: XML]
  --map_name <map_name>                                   Specify AssetMap file name.
  --group_assets_type <ByContainer|BySource|ByType|None>  Specify how exported assets should be grouped. [default: 0]
  --no_asset_bundle                                       Exclude AssetBundle from AssetMap/Export.
  --no_index_object                                       Exclude IndexObject/MiHoYoBinData from AssetMap/Export.
  --xor_key <xor_key>                                     XOR key to decrypt MiHoYoBinData.
  --ai_file <ai_file>                                     Specify asset_index json file path (to recover GI containers).
  --version                                               Show version information
  -?, -h, --help                                          Show help and usage information

---

NOTES:

- in case of any "MeshRenderer/SkinnedMeshRenderer" errors, make sure to enable "Disable Renderer" option in "Export Options" before loading assets.
- in case of need to export models/animators without fetching all animations, make sure to enable "Ignore Controller Anim" option in "Options -> Export Options" before loading assets.

---

Special Thank to:

• Perfare: Original author.
• Khang06: genshinblkstuff for blk/mhy0 extraction.
• Radioegor146: gi-asset-indexes for recovered/updated asset_index's.
• Ds5678: AssetRipper[discord at #mihoyo channel] for information about Asset Formats & Parsing.
• mafaca: uTinyRipper for YAML and AnimationClipConverter.