Skip to main content

Wwise UE Fixer

Every Perforce pull broke our audio. I got sick of fixing it by hand, so I automated the whole thing.

Role Tool Developer
Type Dev Tool
Year 2024
Stack Batch Script, Python
Python Batch Script Wwise Unreal Engine Perforce

Why This Exists

Every Perforce pull on Shadow Frames was the same ritual. Sync, open the project, silence. Wwise paths broken, actors mute, plugin settings gone. Then 20 minutes of manually reconnecting things before anyone could hear a single sound.

After the third morning in a row doing this, I wrote a script. It scans your .uasset and config files, finds every Wwise reference that points to nothing, restores the plugin settings, and rebuilds the configs. One click. It timestamps a backup of your project first, because I learned the hard way what happens when you don't.

The whole Shadow Frames team ran it after every Perforce sync. What used to eat 20 minutes became a 10-second button press. Nobody asked me to build it. I just couldn't stand doing the same thing by hand one more time.

How It Works

Finds the Broken Stuff

Walks through every .uasset and config file in the project. If a Wwise reference points to nothing, it flags it. Finds the dead links and lists them all.

Puts It Back Together

Restores plugin settings, updates configs, rebuilds every broken asset reference. The same 15-step manual process you were doing by hand, except it takes seconds.

Backs Up First

Timestamps a full backup of your project before changing a single file. I added this after a bad experience. If anything goes wrong, you just roll back.

Features

Every Change Logged

Every file it touches gets logged with a reason. When someone asks "what did your tool do to my project?" you can show them line by line.

Won't Touch Your Other Stuff

Only modifies Wwise-related files. Your Blueprints, meshes, levels, materials - all exactly where you left them.

Used on a Real Project

Ran daily on Shadow Frames for months. Full team pulling from Perforce constantly. It never broke a project. That's what mattered most.