Files
BA-AD/README.md
2025-07-14 13:17:24 +08:00

7.0 KiB

logo

Blue Archive - Asset Downloader

A tool and library that downloads the latest Blue Archive assets.

Install

Release

You can download the latest pre-build binaries at Releases

Windows | Linux | MacOS

Cargo

cargo install --git "https://github.com/Deathemonic/BA-AD" --locked --release

Usage

Download all assets from JP server

baad download japan

Download all assets from Global server

baad download global

Examples

# Force update the APK and fetches the latest catalogs
baad --update

# Downloads the TableBundles from JP server and save it in a folder named Downloads
baad download japan --tables --output ./Downloads

# Downloads the MediaResources from the Global server that contains CH0230 in it
baad download global --media --filter "CH0230"

# Downloads both AssetBundles and MediaResources from JP Server
baad download japan --assets --media

# Downloads the AssetBundles with a limit of 15 concurrent downloads
baad download global --assets --limit 15 

# Downloads all AssetBundles, TableBundles, and MediaResources from JP server that contains CH0069 in it using fuzzy search  
baad download japan --filter "CH0069" --filter-method fuzzy 
Command Line

baad --help

Command/Option Short Description
download Download game files
help Print this message or the help of the given subcommand(s)
--update -u Force update
--clean -c Cleans the cache
--verbose -v Enable verbose output
--help -h Print help
--version -V Print version

baad download --help

Command Description
global Download from Global server
japan Download from Japan server
help Print this message or the help of the given subcommand(s)

baad download {japan|global} --help

Option Description Default Possible Values
--assets Download the assetbundles
--tables Download the tablebundles
--media Download the mediaresources
--output <OUTPUT> Output directory for the downloaded files ./output
--limit <LIMIT> Set a limit on the concurrent downloads 10
--retries <RETRIES> Number of retry attempts for failed downloads 10
--filter <FILTER> Filter by name
--filter-method <FILTER_METHOD> Filter method to use contains exact, contains, regex, fuzzy, glob, contains-ignore-case, starts-with, ends-with
--help Print help

Building

  1. Install rustup
  2. Clone this repository
git clone https://github.com/Deathemonic/BA-AD
cd BA-AD
  1. Build using cargo
cargo build

Library

baad = { git = "https://github.com/Deathemonic/BA-AD" }

For more info check out Library

Other Projects

  • BA-AX: A tool and library that extracts Blue Archive assets.
  • BA-MU: A tool that re-dump AssetBundle for Blue Archive.
  • BA-FB: A tool for dumping and generating Blue Archive flatbuffers.
  • BA-CY: Library for handling Blue Archive catalogs, tables, serialization/deserialization, encryption, and hashing.

Contributing

Don't like my shitty code and what to change it? Feel free to contribute by submitting a pull request or issue. Always appreciate the help.

Acknowledgement

Blue Archive is a registered trademark of NAT GAMES Co., Ltd., NEXON Korea Corp., and Yostar, Inc. This project is not affiliated with, endorsed by, or connected to NAT GAMES Co., Ltd., NEXON Korea Corp., NEXON GAMES Co., Ltd., IODivision, Yostar, Inc., or any of their subsidiaries or affiliates. All game assets, content, and materials are copyrighted by their respective owners and are used for informational and educational purposes only.