Skip to content

README.md

Latest commit

 

History

History
185 lines (134 loc) · 9.31 KB

README.md

File metadata and controls

185 lines (134 loc) · 9.31 KB
Raw
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 baad-cli

Usage

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

# Cleans everything, can also use to fix any problems
baad --clean

# 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 the AssetBundles from CN server that contains CH0230 in it using contains but ignore case 
baad download china --assets --filter "CH0230" --filter-method contains-ignore-case

# Downloads MediaResources from CN server matching multiple characters with a regex (alternation = multi filter)
baad download china --media --filter "(ch0230|ch0255|hoshino).*battle" --filter-method regex

# 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

# Downloads all teen AssetBundles from the Global server using iOS platform
baad download global --assets --platform ios --teen

# Downloads all AssetBundles from the JP server using Windows platform 
baad download japan --assets --platform windows
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=<LEVEL> -v Enable verbose output (minimal, full)
--help -h Print help
--version -V Print version

baad download --help

Command Description
global Download from Global server
japan Download from Japan server
china Download from China 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
--proxy <PROXY> Proxy URL for downloads
--boost Aggressive downloading, this can trigger CDN rate limiting
--platform <PLATFORM> Platform to download android android, ios, windows
--teen Download Teen assets (Global only)
--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

Add baad to your Cargo.toml:

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

Download all assets from the JP server:

use baad::catalog::{Catalog, JapanCatalog};
use baad::download::{ResourceCategory, ResourceDownloader};
use baad::Platform;

#[tokio::main]
async fn main() -> eyre::Result<()> {
    // Pick what to download and from which platform
    let catalog = JapanCatalog::new(vec![ResourceCategory::Assets], Platform::Android)?;
    let downloads = catalog.prepare_downloads().await?;

    // Download into ./output
    let downloader = ResourceDownloader::builder()
        .output_dir("./output".into())
        .limit(10)
        .retries(10)
        .build();
    downloader.download(downloads, None).await?;

    Ok(())
}

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: A library for handling Blue Archive Cryptography.
  • BA-BR: A tool that repacks AssetBundle for Blue Archive.

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

Copyright - 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.