Skip to content

Important Migration Notes (24.1)

Alessandro Famà edited this page Jan 30, 2025 · 8 revisions
  • Delete the previous installed Wwise addon in res://addons/Wwise before upgrading and follow the new Getting Started Guide in the Wiki.
  • If you encounter a Unable to load addon plugin at res://addons/Wwise/plugin.cfg error popup after upgrading, please open the project.godot file and delete that plugin from there. Unfortunately, Godot doesn't seem to automatically remove plugins that were removed from the file system.
  • Project settings that were removed or renamed in the new version of the Wwise integration will still persist in the project.godot file. To avoid displaying these, you can manually open the project.godot file and remove them.
  • If you were extensively using custom nodes, you will need to reassign the selected Wwise objects to the respective properties in the custom nodes.
  • Most of the Wwise singleton functions now accept a Node* instead of an Object* for registered game objects.
  • The post_event functions in the Wwise singleton will register passed nodes as Game Objects automatically.
  • The Init Bank is now loaded by default at startup.
  • The CookieWrapper object passed to the _callback versions of Wwise functions has been removed. You can now pass a Callable directly to these functions.
  • You no longer need to add the .bnk and .wem file extensions to the Filters to export non-resource files/folders setting in the Godot Export window. The integration now handles this automatically.
  • Generating Wwise IDs is now completely optional.
Clone this wiki locally