Blue Archive - Bundle Repacker

A tool that repacks AssetBundle for Blue Archive.

Install

Release

You can download the latest releases

Windows | Linux | MacOS

Usage

BA-BR automates the process of transferring modifications from a modded AssetBundle to an original (or "patch") AssetBundle. This is useful for updating mods when a game receives a new patch.

The process works as follows:

1. Compare: The tool identifies assets that exist in both the --modded and --patch bundles by matching their names and types.
2. Export: Matched assets from the --modded bundle are exported to a Dumps folder.
3. Import: The exported files are then read, and their data is used to overwrite the corresponding assets in the --patch bundle.
4. Save: A new, modified AssetBundle is saved in the Modded folder, containing the original patch content updated with your mods.

Basic Example

# Basic usage
babr -m your_modded.bundle -p game_asset.bundle

# Multiple patch bundles
babr -m your_modded.bundle -p textures.bundle meshes.bundle audio.bundle

# Export only (no import)
babr -e -m your_modded.bundle -p game_asset.bundle

# Exclude specific asset types
babr --exclude texture2d,audioclip -m your_modded.bundle -p game_asset.bundle

# Custom output directory with PNG export
babr -o ./output --image png -m your_modded.bundle -p game_asset.bundle

Command Line

babr --help

Argument	Alias	Description	Default
--include <types>		Asset types to include (e.g., --include texture2d,audioclip).
--exclude <types>		Asset types to exclude (e.g., --exclude gameobject,transform).
--only <types>		Only process assets of these specific types.
--output <path>	-o	Output directory for Dumps and Modded folders.
--export	-e	Export assets only without importing.	false
--compress <type>	-c	Compression type for output bundle (None, LZMA, LZ4, LZ4Fast).	lz4
--image-format <format>	--image	Sets the export format for textures (Tga, Png, Bmp, Jpg).	tga
--text-format <format>	--text	Sets the export format for text assets (Txt, Bytes).	txt
--no-crc	-nc	Skip CRC matching on output bundles.	false
--types	-t	Lists all available asset types and exits.	false
--verbose	-v	Enables detailed debug logging.	false
--modded <path>	-m	(Required) Path to the modded asset bundle, directory, or single file.
--patch <path...>	-p	(Required) Path(s) to the patch asset bundle(s). Must be last argument.

Note: The -p/--patch argument uses params, so it captures all remaining arguments. Place all other options before -p.

Building

1. Install .NET SDK
2. Clone this repository

git clone https://github.com/Deathemonic/BA-BR
cd BA-BR

3. Download the FMOD Engine 2.03.11 and place the native libraries in the appropriate folders:

   • Windows (BABR.FMOD/Native/win/): fmod.dll, fsbank.dll, libfsbvorbis64.dll, opus.dll
   • Linux (BABR.FMOD/Native/linux/): libfmod.so, libfsbank.so, libfsbvorbis.so, libopus.so
   • macOS (BABR.FMOD/Native/osx/): libfmod.dylib, libfsbank.dylib, libfsbvorbis.dylib, libopus.dylib

4. Build using dotnet

dotnet build

Other Projects

• BA-AD: A tool and library that downloads the latest Blue Archive assets.
• BA-AX: A tool and library that extracts Blue Archive assets.
• BA-FB: A tool for dumping and generating Blue Archive flatbuffers.
• BA-CY: A library for handling Blue Archive Cryptography.

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

• nesrak1/UABEA
• nesrak1/AssetsTools.NET
• FMOD
• Perfare/AssetStudio

---

_{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.}