conversionvariant.py — Header Format Fix (No Transfer)
Purpose:This is a safer variant of transfer3.py focused solely on converting a source bundle's internal structure and header format into a target FusionFall-compatible format—without importing external objects from other bundles.
Header Fix Logic:
- Reassigns path IDs starting from a safe base (default: 238975)
- Rebuilds m_PreloadTable, m_Container, and m_MainAsset using FusionFall path conventions (wear/, texture/, etc.)
- Ensures all ObjectPointers in preload/contents are updated to match new path IDs
- Doesn’t involve two bundles or cross-bundle transfer
- Doesn’t risk contaminating your GameObjects with unrelated data
- Great for fixing bundles that were built with incompatible ID layout or Unity versions (e.g., academy assets)
transfer3.py — Asset Transfer with Header Rebuild (Bugged)
Purpose:This script attempts to transfer all objects (excluding path ID 1) from a source bundle into a target bundle, assigning them new path IDs and updating all references accordingly. It also rewrites the target bundle’s header (m_PreloadTable, m_Container, etc.) to include the newly transferred assets.
Header Fix Logic:
- Preserves target bundle's original m_MainAsset
- Appends new entries to m_PreloadTable and m_Container with correctly resolved path IDs
- Formats asset paths into FusionFall-friendly categories (wear/, texture/, bgm/)
- Ensures all added assets are valid ObjectPointers
While it does correctly patch the header format for FusionFall compatibility, it blindly appends every asset—including possibly unrelated or non-target GameObjects—resulting in random images or junk being inserted into your bundle. This often corrupts the GameObject structure and crashes the game.
rename_animation.py — AnimationClip Renamer
Purpose:Utility script to rename or list AnimationClip objects inside a Unity asset bundle. It ensures the m_Name or fallback fields like Base.m_Name are updated for a given key ID.
Not a header fixer, but useful when:
- You need to rename animation keys in bundles you’re cleaning/fixing
- Helps verify correct assets are retained post-transfer or conversion