Version
menu_open
Warning: you were redirected to the latest documentation corresponding to your major release ( 2021.1.14.8108 ). Should you wish to access your specific version's documentation, please download the offline documentation from the Audiokinetic Launcher and check the Offline Documentation option in Wwise Authoring.

Could not find plug-in dynamic library

The specified Dynamic Library for a Plug-in was not found on disk. The name of the Plug-in is specified with the error. This error happens if the Plug-in is used in the project but is not linked statically to the game executable. When this happens, Wwise tries to find the corresponding Dynamic Library file (file extensions DLL, SO, BUNDLE, or PRX, depending on the platform).

The dynamic linking strategy is optional, the game developer chooses their preferred linking strategy. However, if a Plug-in is used in the Wwise Project, it's code must be linked to the game. Note that it is possible to mix linking strategies, using static linking for some plug-ins and dynamic linking for others.

Probable causes:

  • When linking statically AllPluginFactories.h is not used (which is ok) but the Plug-in include file (***Factory.h) is missing or library was not linked.

  • When linking dynamically, the dynamic library (file extensions .dll, .so, .bundle or .prx) was not deployed to the target console.

  • When linking dynamically, the dynamic library search path was not set correctly. By default, it is automatically set properly but some implementers like to change it through AkInitSettings::szPluginDLLPath

  • Unity users: A recent change was done in the Wwise Project that includes a new plug-in, but the game build did not package the expected DLL.

Recommended resolution steps:

  • Make sure the specified plug-in Factory include file is included in one .cpp of your game. Make sure the corresponding library is linked statically. See Integration Details - Plug-Ins

  • If AkInitSettings::szPluginDLLPath is changed from default in your game, make sure the path exists.

  • If using dynamic linking, make sure the required dynamic library is included in your packaging/distribution system, and installed on the target console.

  • Unity users: rebuild your game, it should include the missing file.

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise