UnityPackFF Asset Bundle Header Conversion Scripts

When importing animated models into FusionFall, you first export asset bundles from Unity 2.6.1 using the Unity AssetBundle Export Script. However, those Unity-created bundles have header data and object references that FusionFall's client can’t understand directly.

That's where these Python header scripts come in: they rewrite the headers of those exported bundles to match FusionFall’s custom format and file structure expectations.

Run with the example command below:
mob_headers.py CustomAssetBundle-example 2

nano_headers.py

Rewrites the asset bundle header for nanos exported from Unity.

Key functions:

• Reassigns object IDs to avoid conflicts.
• Renames internal paths to follow nano/ structure.
• Injects a FusionFall-compatible preload and container section.

Why it's crucial:
FusionFall expects nano assets in a specific structure (nano/). Unity exports won’t match that by default, this script corrects that, making the bundle usable in game.

2. wear_headers.py​

Processes and fixes Unity asset bundles for wearables (clothing, accessories, etc.) by setting correct paths and references.

Key Features:

• Assigns IDs to each object in the bundle.
• Adjusts file paths to point to the wear/ folder.
• Handles textures too (texture/).

Importance:
Used for importing player items and wearable assets into the game. FusionFall requires precise pathing (wear/) to correctly load 3D wearable assets during runtime.

3. mob_headers.py​

Purpose:
Specializes in importing enemy or NPC animated models. Adjusts the header information to integrate mob assets into FusionFall.

Key Features:

• Renames paths under mob/.
• Updates asset object IDs and references.
• Includes support for related assets like textures.

Importance:
Vital for importing animated enemy models (mobs). FusionFall distinguishes mobs by folder (mob/) and expects bundled animation references to be in sync with that format.

How All These Fit Together​

1. Unity Asset Bundle Export Script:
   • Exports .unity3d bundles from Unity 2.6.1 with all dependencies.
2. Bundle Header Conversion Scripts:
   • Modify the exported Unity bundles:
     • Remap internal asset IDs.
     • Adjust header structure.
     • Assign appropriate paths (wear/, nano/, mob/).