Rizline:Guides/Extracting asset files from an Android device

From Rhythm Game Wiki
Revision as of 08:18, 9 December 2024 by TadeLn (talk | contribs) (→Prerequisites)
Jump to navigation Jump to search

This guide will help you extract bundled asset files from an Android version of Rizline.

Prerequisites

  1. Download the Rizline app on an Android device.
  2. Launch the application and let it download the assets.
    Note: Some assets of Rizline are downloaded on-demand. Assets such as songs, charts, and high-quality images are downloaded only when they are needed. If you have never played a chart, haven't tapped on the song, or haven't enlarged an image, those specific files will not be there when you extract the files. For a more complete asset export, see: Rizline:Guides/Downloading all assets directly.
  3. Copy the game's files from your Android device to your PC. Rizline's files are located under Android/data/com.Rizline.PigeonGames in your device's file manager.
  4. Download AssetRipper to your PC.

Steps

Exporting all bundles

If you want to export all asset bundles, follow these steps:

  1. Launch AssetRipper.
  2. Select File > Open Folder and choose the files/UnityCache/Shared directory from the directory copied before. Wait for it to load the assets.
  3. Select Export > Export all Files and choose the directory where you want to extract the assets to. Wait for it to finish exporting.

That's it! Your assets should be in the __data/ExportedProject/Assets/ subdirectory.

Exporting a specific bundle

If you just want to export a specific asset bundle:

  1. Launch AssetRipper.
  2. Select File > Open File and navigate to one of the directories in the files/UnityCache/Shared subdirectory.
  3. Go into the directory that you want to extract (the name of the directory is the Asset Bundle Name).
  4. Go into the only subdirectory that is inside (the name of the directory is the Asset Bundle ID).
  5. Select the __data file. That should only load one asset bundle.

Exporting files from an APK file

There are some more files in the .apk file, but those are not as interesting. If you want to see them anyway, you can extract the .apk file using any .zip archive tool and then open the whole extracted folder using File > Open Folder in AssetRipper. [unfinished]

Extract audio files

Audio files are stored differently from other assets. They are still in the files/UnityCache/Shared/ directory, but they are not in a __data file, therefore AssetRipper cannot extract them.

You can find all audio files by going to files/UnityCache/Shared/ directory and searching for files with the string .acb in the filename. For example, the audio file for "Pastel Lines" is named pastellines.rekumochizuki.0.acb=318e00[verify], and is located in the subdirectory files/UnityCache/Shared/342f01e2d954c058db8a6d3cc0b1ec08/65c2c4bf21069b294687e5bcaf7239e4[verify]. Sometimes you may find multiple audio files with similar filenames but different numbers at the end (for example: grimheart.puru.0.acb=4468e0, grimheart.puru.0.acb=446940. This is because some audio files have been updated, but the old ones were not deleted from the cache. To figure out which of those is the old, and which is new, refer to the list on Rizline:Audio files [unfinished].

After you get the ACB file, you have to convert it using vgmstream. For single uses, you can use the vgmstream tool online, using the website [1], but if you need to convert ACB files often, you should use the command-line tool listed on the vgmstream website.

Note: Before converting the file, you have to remove the last 7-character-long suffix from the filename, so that it ends with .acb. For example, for grimheart.puru.0.acb=4468e0, you have to change it to grimheart.puru.0.acb before converting it.

Retrieved from "https://rgwiki.stary.pc.pl/w/index.php?title=Rizline:Guides/Extracting_asset_files_from_an_Android_device&oldid=1828"