Editing Rizline:Guides/Extracting asset files from an Android device

This guide will help you extract bundled asset files from an Android version of ''[[Rizline:Rizline|Rizline]]''.

== Prerequisites ==
# Download the [[Rizline:Rizline application|Rizline application]] on an Android device.
# Launch the application and let it download the [[Rizline:assets|assets]].<br>'''Note:''' Some assets of ''Rizline'' are [[Rizline:Assets#Assets downloaded on-demand|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]].
# Copy the game's files from your Android device to your PC. ''Rizline''<nowiki/>'s files are located under {{Tooltip|<code>Android/data/com.Rizline.PigeonGames</code> in your device's file manager|The actual path is /storage/emulated/0/Android/data/com.Rizline.PigeonGames}}.
# Download [https://github.com/AssetRipper/AssetRipper/releases/ AssetRipper] to your PC.

== Steps ==

=== Exporting all bundles ===

If you want to export all [[asset bundles]], follow these steps:
# Launch ''AssetRipper''.
# Select '''File > Open Folder''' and choose the <code>files/UnityCache/Shared</code> directory from the directory copied before. Wait for it to load the assets.
# 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 <code>__data/ExportedProject/Assets/</code> subdirectory.

=== Exporting a specific bundle ===

If you just want to export a specific [[asset bundle]]:
# Launch ''AssetRipper''.
# Select '''File > Open File''' and navigate to one of the directories in the <code>files/UnityCache/Shared</code> subdirectory.
# Go into the directory that you want to extract (the name of the directory is the [[asset bundle name]]).
# Go into the only subdirectory that is inside (the name of the directory is the [[asset bundle hash]]).
# Select the <code>__data</code> file. That should only load one asset bundle.

=== Exporting files from an APK file ===

There are some more files in the <code>.apk</code> file, but those are not as interesting. If you want to see them anyway, you can extract the <code>.apk</code> 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 <code>files/UnityCache/Shared/</code> directory, but they are not in a <code>__data</code> file, therefore ''AssetRipper'' cannot extract them.

You can find all audio files by going to <code>files/UnityCache/Shared/</code> directory and searching for files with the string <code>.acb</code> in the filename. For example, the audio file for "Pastel Lines" is named <code>pastellines.rekumochizuki.0.acb=318e00</code>{{verify|Is this still true? The checksum may have changed by now}}, and is located in the subdirectory <code>files/UnityCache/Shared/342f01e2d954c058db8a6d3cc0b1ec08/65c2c4bf21069b294687e5bcaf7239e4</code>{{verify|Is this still true? The asset bundle names}}. Sometimes you may find multiple audio files with similar filenames but different numbers at the end (for example: <code>grimheart.puru.0.acb=4468e0</code>, <code>grimheart.puru.0.acb=446940</code>. 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 the page: [[Rizline:Audio files]].

After you get the <code>ACB</code> file, you have to convert it using [https://vgmstream.org/ vgmstream]. For single uses, you can use the vgmstream tool online, using the website [https://katiefrogs.github.io/vgmstream-web/], but if you need to convert <code>ACB</code> files often, you should use the command-line tool listed on the [https://vgmstream.org/ 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 <code>.acb</code>. For example, for <code>grimheart.puru.0.acb=4468e0</code>, you have to change it to <code>grimheart.puru.0.acb</code> before converting it.

[[Category:Guides]]
[[Category:Rizline guides]]