Experimental header conversion scripts for UnityPackFF

FREE Experimental header conversion scripts for UnityPackFF

Experimental header conversion scripts for UnityPackFF
1.png


🔁 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
Difference from transfer3.py:
  • 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
Problem:
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
Top