ShizuStore

BDroid X

Ark-Repoleved

1.5.0 · GitHub

Download APK
Games Android 8.0+ 4 days ago MIT
239 ShizuStore
11.7k GitHub
93 Stars
42 MB Size

More about this app

Browndust II Mod manager

GitHub All Releases GitHub release (latest by date)

English | 繁體中文 | Usability Survey | Static Badge

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

  1. Download the App: Download the latest .apk from the Releases page and install it.
  2. 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, not Char000104.png). Additionally, the image filename referenced inside the .atlas file 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

  1. Select Mods: In the app, check the boxes for the mods you want to install.
  2. Start Repacking: Tap the floating Repack (✓) button at the bottom right.
  3. 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.
  4. Move Files to Game Directory:
    • Once complete, a new Shared folder containing all your modded game files will be saved to your phone's Download folder.
    • 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 Shared folder 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/.

🔧 Other Tools

Spine Animation Preview

Not sure what a mod looks like in action?

  1. Find the mod in the list.
  2. Long-press on it.
  3. 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:

  1. On the main screen, find the mod that is causing the crash. Select only that mod.
  2. Tap the "Merge Spine" button.
  3. The app will process the files. The originals will be backed up into a new .old subfolder.
  4. Re-install the newly merged mod. The crash should be resolved.

Standalone Bundle Unpacker

For users who want to extract original game files:

  1. Make sure no mods are selected on the main screen.
  2. Tap the floating unarchive (📤) icon.
  3. Select the __data file you want to unpack.
  4. The extracted contents will be saved to the Download/outputs folder.

❤️ Support This Project

If you find this tool useful and want to support its development, please consider buying me a coffee Support me on Ko-fi. 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:

      1. Texture Count Mismatch: The mod's .png count differs from the original (the app usually fixes this automatically).
      2. Incorrect Filenames: All filenames must be lowercase (e.g., char000104.png). The image reference inside .atlas must 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.

  • **Q: The installation failed. What should I do?_

    • A: Failures are usually caused by:
      1. Poor network connection (failed to download original files).
      2. Incorrect mod filenames.
      3. An unexpected repacking error. Check the error message in the dialog for clues.
  • 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 .skel or .json.

🙏 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-.skel conversion logic and CDN download methods.
  • UnityPy: For reading and modifying Unity game assets.
  • astc-encoder: For the official ASTC texture encoder.

⭐ Stars over time

Close

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.listFiles
  • java.io.File.mkdirs
  • java.io.File.inputStream
  • java.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.

Close

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 .atlas page 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-Length integrity checks, atomic .part writes, writable temp directory checks, and in-memory Spine JSON-to-.skel conversion.
  • Stability & Security: Fixed JSONObject null-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.
Close

Permissions

4 permissions requested

  • android.permission.INTERNET
  • android.permission.READ_EXTERNAL_STORAGE
  • moe.shizuku.manager.permission.API_V23
  • com.example.bd2modmanager.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
Close