Skip to content

Repository files navigation

ABVME

Asset Bundles Viewer Modifier and Exporter

A simple tool for viewing, modifying, and exporting Unity Asset Bundles. Easy to use like AssetStudio, but focused on making asset modification simpler. Built with Python using UnityPy.

📸 Screenshot

Click to expand

Usage

  • Pre-built Windows builds from Releases:
    • Setup (ABVME-Windows-x64-Setup.exe) — per-user install under Local AppData; Start Menu; optional .bundle / .unity3d file association; can update from About
    • Portable (ABVME-Windows-x64-Portable.zip) — unzip and run; updates via the Releases page
  • Linux: portable zip from Releases
  • Or clone and run from source:
    git clone https://github.com/com55/ABVME.git
    cd ABVME
    • Using uv (Recommended)
      uv sync
      uv run main.py
    • Using pip
      pip install -r requirements.txt
      python main.py

Features

  • Asset Preview - View asset contents directly in the app (lazy Dump tab; copy image from preview)
  • Asset Export - Export single or multiple selected assets
  • Asset Replacement - Confirm before every replace (button / menu / drag-drop)
    • Texture2D — optional Texture Replace Options (format, mipmaps, filter/wrap, and more); short confirm with Options…, or always show the full dialog
    • TextAsset — accepts any non-bundle file; if the suffix is not in that object's container, a confirm dialog appears
  • Bundle Saving - Save modified AssetBundles back to disk (all / selected / per-bundle)
  • Save / Options - Compression (including LZ4HC), resource patch method (Inline / Orphan cleanup / Rebuild .resS), and CRC correction (Off / On / Auto for Windows); Save dialog can collapse options and list only changed files
  • Table - Size column; empty name/container/source shown as dim (none); replaced rows highlighted green; filter by Type and Source File
  • Menus - File / Asset / Options / About; Display all assets; in-app Check for Updates from About
  • Open Folder - Load top-level .bundle / .unity3d from a folder (Ctrl+Shift+O); confirms before loading 100+ files
  • Drag & Drop
    • Drop files anywhere on the window (table, preview, and empty space all count)
    • AssetBundles (.bundle, .unity3d, or UnityFS) open; an overlay shows Open vs Replace while dragging
    • Other files replace the selected asset
  • Open from Explorer - Selecting multiple bundle files and opening them loads everything into one window (launches within ~500ms are merged)
  • Shortcuts - Ctrl+O, Ctrl+Shift+O, Ctrl+Shift+S, Ctrl+R, Ctrl+E, Ctrl+Q
  • Supported asset types
    • TextAsset — view, export, replace
    • Texture2D — view, export, replace

TODO

  • Mesh support
  • CRC Corrector - Make CRC32 the same as the original file after modification
  • Bundles Migration - Transfer modifications to new base files
  • Atlas Image Unpacker
  • SpineSkeletonDataConverter integration (add-on)
  • SpineViewer to render preview file integration (add-on)
  • BA-AD integration to find and download files when migrating to other platforms where they were not downloaded (add-on)

Contributing

  • Found a bug or have a suggestion? Please open an issue
  • Pull requests are welcome!

Acknowledgments

License

MIT

About

Asset Bundles Viewer Modifier and Exporter.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages