Rizline:Guides/Extracting asset files from an Android device: Difference between revisions

Tags: Mobile edit Mobile web edit
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 2: Line 2:


== Prerequisites ==
== Prerequisites ==
# Download the [[Rizline:Rizline app|Rizline app]] on an Android device.
# 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:Guide/Downloading all assets directly]].
# 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}}.
# 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.
# Download [https://github.com/AssetRipper/AssetRipper/releases/ AssetRipper] to your PC.
Line 22: Line 22:
# Launch ''AssetRipper''.
# Launch ''AssetRipper''.
# Select '''File > Open File''' and navigate to one of the directories in the <code>files/UnityCache/Shared</code> subdirectory.
# 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 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 ID]]).
# 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.
# Select the <code>__data</code> file. That should only load one asset bundle.


Line 33: Line 33:
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.
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 [[Rizline:Audio files]] {{unfinished}}.
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].
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.
'''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]]