Asset Extraction tool for World Flipper.

This tool extracts the assets from world flipper application installed on your device / emulator using ADB and FFDEC, rename digested file paths with original file path, restore corrupted png and mp3 data, export irregular (amf, orderedmap, etc) files in regular data format such as json.

Currently only supports Global / Japan variants.

Check out the release page of this repo.

Runs on Windows, Mac or Linux machines.

Hardware device / emulator asset pulling only supported by Windows 10 or greater.

Some regions may not be able to call asset download api (For example, KR/CN Ips are banned from JP api server.) If you have trouble pulling assets from API, consider using VPN to call those APIs

Requires Java 8 or later to run FFDEC.

if you're willing to extract assets from real device, your device must be rooted.

The tool isnt greatly optimized performance-wise, so your machine's cpu/ram usage may reach very high load while extraction.

The tool only tested for limited use cases, thus should have various bugs or even crahses among other enviornments. Basically this tool works best with modified, non-production adbd, which supports adb running as root permission and grants full access to data directory.

To use this tool, your device should at least have file-listing access to the /data directory.

• Nox player (version 7.0.x) - Recommended (Global)
• Bluestacks 5 (Not recommended - bad performance due to unabled adbd root access.)

• Pixel 2 (Android 11)
• Pixel 4 XL (Android 12)

Select the directory you want to use as workspace directory. Note that your directory must only includes english alphabets or numbers. I recommend you to use the directory under the root directory in the disk such as C:/wafuriextract

You need to pull raw asset files from your device/emulator or directly from wdfp api server.

Click on the Pull/Downlaod Assets and select the asset source, region variant and start pulling the assets. Wait until the pulling process is done.

When using your device or emulator, The device must downloaded all the assets from world flipper client before you use this tool.

Once you pulled raw assets successfully, click on the Extract Data button and select options you want and proceed.

Once the extraction is done, you can find inflated asset files located in the output directory under your extraction directory.

Do not close the app even if it hangs. The process might hangs a lot and several tasks require more than dozens of minutes. Be patient while extraction is in progress

You can turn on the delta extraction mode by clicking the delta icon button located at right side of extract data button.

In the delta extraction mode,

• You can pull new assets from API mode only.
• newly pulled assets will placed inside delta-latest directory under your workspace directory.
• once you pulled delta assets, Extract Data feature will only targets assets inside delta directory created above.
• after your delta extraction is done, delta-latest directory will be renamed to delta-{assetVersion} directory for better labeling.

U can use in-built commands for debugging or advanced usage. refer to the Command documentation for more details.

Refer to the FAQ for more details.

Thanks to @michaelcurry for the documentation.

• APK
• Decompiled SWF
• Master table
• Character image assets
• Character image atlases/frame/parts/timeline (exported as json format)
• Miscellaneous image assets.
• Audio files including BGM, Character voice lines, S/E and more.
• Cropped sprites based on atlases and sprite sheet
• Animated images generated from sprites (Character images only)
• Skill/Action descriptors for characters / bosses / items, including all the details about the skills.
• Summarized Gacha, EX Boost rates table.

• Support extraction of ability texts
• Data viewer

The repository is open to your contribution! if you're having problem with the issues that listed here, feel free to open PRs to resolve it and make other pepople can benefit from your contribution.

• Whitespaces in Windows user name / extraction directory path causing crashes on extraction process. (Due date: TBD)

I won't actively troubleshoot the bugs as far as it works for me, so if you're having trouble using the tool on your side, in most cases you'll have to fix the problem yourself, or at least provide me all the details about your environments, runtime context, ETC. Please include all the details when you open issue here. Also feel free to open any PR.

If you want more asset coverage added to tool, please provide the details about assets you want to export, including file formats, asset path, format of data, etc.

The application is built from the electron-react-boilerplate. Refer to the repository to check how to install dependencies and start development on your local machine.