BDroid X
1.5.0 · GitHub
More about this app
Browndust II Mod manager
English | 繁體中文 | Usability Survey |
BrownDust 2 Android Mod Manager
Manage and install your BrownDust 2 mods directly on your phone. No PC required.
✨ Key Features
- 📱 PC-Free Operation: Unpacks, converts textures (ASTC), and repacks mods entirely on your Android device.
- 🧠 Smart Mod Grouping: Automatically scans your mod folder and groups mods by the game files they modify, preventing conflicts.
- ⚡ Batch Processing: Select and install multiple mods from different groups in a single operation.
- 🔀 Shizuku Integration: Move repacked files to the game directory with a single tap.
- 👀 Live Animation Preview: Long-press any mod to preview its Spine animation before you install it.
- 🔧 Built-in Utilities: Includes tools to merge texture atlases and unpack game bundles.
🚀 Getting Started
Requirements
- Android 8 or higher.
- The latest official version of BrownDust 2 installed.
- Shizuku for one-tap file transfer (recommended, but the mods can also be moved manually).
Installation & Setup
- Download the App: Download the latest
.apkfrom the Releases page and install it. - Select Mod Folder:
- Open the app.
- Tap the "Select Mod Source Folder" button.
- Navigate to the folder where you store your mods and tap "Use this folder".
💡 Recommendation: For best results, create a dedicated folder (e.g.,
.BD2_Mods) in your phone's internal storage and place all your mod files there.
🛠️ How to Use
1. Prepare Your Mods (Important!)
For the app to recognize your mods, they must follow a specific structure. Each mod needs its own folder, and the filenames inside must exactly match the game's original asset names.
⚠️ Warning: All filenames must be lowercase (e.g.,
char000104.png, notChar000104.png). Additionally, the image filename referenced inside the.atlasfile must also be lowercase. Otherwise, the game might crash.
Example Folder Structure:
📁 .BD2_Mods/
├── 📁 Lathel_DarkKnight_IDLE/
│ ├── 📄 char000104.skel (or .json for the skeleton)
│ ├── 📄 char000104.atlas (the atlas mapping file)
│ └── 🖼️ char000104.png (the texture image)
│
└── 📁 Another_Mod/
└── ... (other mod files)
2. Install Mods
- Select Mods: In the app, check the boxes for the mods you want to install.
- Start Repacking: Tap the floating Repack (✓) button at the bottom right.
- Wait for Processing: The app will automatically download the necessary original game files and repack your selected mods. A dialog will show the live progress.
- Move Files to Game Directory:
- Once complete, a new
Sharedfolder containing all your modded game files will be saved to your phone'sDownloadfolder. - With Shizuku (Recommended): If Shizuku is running, a "Move to Game Directory" button will appear. Tap it to automatically move the files — this works even on Android 16+.
- Without Shizuku: You can manually move the
Sharedfolder into the game's cache directory using a third-party file manager, or copy the provided ADB command. - The destination path is:
/Android/data/com.neowizgames.game.browndust2/files/UnityCache/.
- Once complete, a new
🔧 Other Tools
Spine Animation Preview
Not sure what a mod looks like in action?
- Find the mod in the list.
- Long-press on it.
- A preview screen will open, playing the animation.
Spine Atlas Merger (Troubleshooting Tool)
Automated with manual fallback.
The app automatically detects and merges mismatched textures during repacking, preventing most crashes. However, if a mod still displays incorrectly:
- On the main screen, find the mod that is causing the crash. Select only that mod.
- Tap the "Merge Spine" button.
- The app will process the files. The originals will be backed up into a new
.oldsubfolder. - Re-install the newly merged mod. The crash should be resolved.
Standalone Bundle Unpacker
For users who want to extract original game files:
- Make sure no mods are selected on the main screen.
- Tap the floating unarchive (📤) icon.
- Select the
__datafile you want to unpack. - The extracted contents will be saved to the
Download/outputsfolder.
❤️ Support This Project
If you find this tool useful and want to support its development, please consider buying me a coffee
. Every contribution is greatly appreciated!
❓ FAQ
Q: My mods aren't showing up!
- A: Double-check that you've selected the correct "Mod Source Folder" in the setup. Also, ensure your mods are in unzipped folders and follow the correct folder structure.
Q: The game crashes after installing a mod.
A: This is usually due to one of the following:
- Texture Count Mismatch: The mod's
.pngcount differs from the original (the app usually fixes this automatically). - Incorrect Filenames: All filenames must be lowercase (e.g.,
char000104.png). The image reference inside.atlasmust also be lowercase.
If the issue persists, try using the 'Merge Spine' feature manually. If it still fails, the mod itself might be corrupted or incompatible.
- Texture Count Mismatch: The mod's
**Q: The installation failed. What should I do?_
- A: Failures are usually caused by:
- Poor network connection (failed to download original files).
- Incorrect mod filenames.
- An unexpected repacking error. Check the error message in the dialog for clues.
- A: Failures are usually caused by:
Q: The in-game graphics are broken after installing a mod.
- A: This usually means the mod is incomplete or not compatible with the Android version. A complete character mod requires three files:
.png,.atlas, and either.skelor.json.
- A: This usually means the mod is incomplete or not compatible with the Android version. A complete character mod requires three files:
🙏 Credits
This tool was made possible by these incredible open-source projects:
- browndust2-repacker-android: For the core repacking and texture compression techniques.
- ReDustX: For the
.json-to-.skelconversion logic and CDN download methods. - UnityPy: For reading and modifying Unity game assets.
- astc-encoder: For the official ASTC texture encoder.
⭐ Stars over time
How Shizuku is used
Can apply modded bundles and restore originals into the game folder via Shizuku `UserService` file copy.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku is used to move prepared game files from shared storage into the protected game folder for modding.
- Apply modded bundles: after repacking, the user can move the finished mod files into the game cache with a privileged directory copy through Shizuku.
- Restore original bundles: the user can move a downloaded original file back into the game cache the same way to undo a mod.
Android APIs or commands used
java.io.File.listFilesjava.io.File.mkdirsjava.io.File.inputStreamjava.io.File.outputStream
Notable details
Prepared files are first saved to the shared download folder, and the app also shows a copyable shell move command so the files can be moved manually when Shizuku is not available.
Changelog
What's new for version 1.5.0
What's New in v1.5.0
Performance & Memory
- Streaming Bundle Saving: Stream bundle data in chunks during repack instead of holding full uncompressed buffers in memory, significantly reducing crashes on large bundles and multi-mod batches.
- Original Bundle Cache: Added a 1 GB LRU disk cache for downloaded original game bundles so repeated installs and restores avoid re-downloading the same files.
- Faster Startup & Rescan: Separated mod file-list caching from catalog resolution and moved startup catalog checks to the background when local data is already cached.
- Controlled Concurrency: Separated parallel downloads from serialized repacks and capped Android texture worker concurrency to keep peak memory low.
Installation Reliability & Bug Fixes
- Improved Mod Resolution: Added path-based catalog scoring to prioritize primary character/dating/cutscene bundles over secondary NPC/event copies, recursive directory scanning/copying, and filtering for non-mod files (
__MACOSX,.DS_Store, previews,readme, etc.). - Spine Merging & Atlas Fixes: Preserved
.atlaspage headers (format,filter,repeat,pma), switched to 2D shelf packing (<=4096px) to prevent oversized/black textures, aligned merged PNG names with target bundle textures, enabled truncated PNG tolerance, and aborted repacks on partial asset failures. - Download & Temp Directory Safeguards: Added CDN download retries,
Content-Lengthintegrity checks, atomic.partwrites, writable temp directory checks, and in-memory Spine JSON-to-.skelconversion. - Stability & Security: Fixed
JSONObjectnull-string handling, moved Spine merge SAF writes off the main thread, fixed Spine preview URI decoding and HTML escaping, upgraded CI actions, and removed legacy dead code.
Permissions
4 permissions requested