FMOD Studio: Encounterd Error: ERR_HEADER_MISMATCH There is a version mismatch between the FMOD header and either the FMOD Studio library or the FMOD Low Level library

Hi there,

For context:

  • I’m using Unity 2021.1.13f1
  • I recently updated to FMOD 2.01.11

Had to update our version of FMOD and immediately ran into this error:
FMOD Studio: Encounterd Error: ERR_HEADER_MISMATCH There is a version mismatch between the FMOD header and either the FMOD Studio library or the FMOD Low Level library.
UnityEngine.Debug:LogError (object)
FMODUnity.EditorUtils:CheckResult (FMOD.RESULT) (at Assets/Plugins/FMOD/src/Editor/EditorUtils.cs:36)
FMODUnity.EditorUtils:CreateSystem () (at Assets/Plugins/FMOD/src/Editor/EditorUtils.cs:263)
FMODUnity.EditorUtils:get_System () (at Assets/Plugins/FMOD/src/Editor/EditorUtils.cs:338)
FMODUnity.EventManager:UpdateCache () (at Assets/Plugins/FMOD/src/Editor/EventManager.cs:144)
FMODUnity.EventManager:RefreshBanks () (at Assets/Plugins/FMOD/src/Editor/EventManager.cs:30)
FMODUnity.EventManager:Startup () (at Assets/Plugins/FMOD/src/Editor/EventManager.cs:486)
UnityEditor.EditorApplication:Internal_CallDelayFunctions ()

It looks like something didn’t update since I imported the package downloaded from FMOD, but no matter how many times I attempt to reinstall the FMOD package, it doesn’t make a difference. I’ve even tried nuking all of my files and redownloading the whole project from Unity Hub, but to no avail.

Other symptoms include:

  • FMOD not showing up in the package manager
  • Clicking ‘FMOD > About Integration’ displays my version of FMOD as ‘Version 0.00.00’

The only relevant post I can find is this one, and the user never listed their resolution steps, as they didn’t know what they were either.

Any help would be greatly appreciated.

just delete everything FMOD related from your project while the Unity app is closed and then import the package again.

What’s the best way for me to find everything FMOD related? I tried deleting every file and folder with FMOD in its name while Unity was closed, then reimporting, but that didn’t seem to work.

Usually deleting everything under Assets/Plugins/FMOD and reinstalling should get it back to a good state. This definitely sounds like a bug though, can you please let me know what version of FMOD you had before updating so I can try reproducing?

Our original version of FMOD was Studio.01.10.00. We had to update because we’re working on a Nintendo Switch Port, so we can’t step our version backwards to eliminate the issue.

This only appears to happen in the Windows version of Unity, while the Mac version is stable. Unfortunately, the Nintendo SDK only work with Windows machines, hence the problem.

In that case there are some additional steps when updating from 1.10. Can you please try getting your 1.10 files back in, updating the plugin to 2.01.11, and finally moving everything from Assets/Plugins/Editor/FMOD to Assets/Plugins/FMOD/src/Editor?