top of page
Search

GCR Wwise Helper

We are excited to introduce one of our in-house tools designed to enhance the workflow for designers within Wwise. This tool aims to streamline project maintenance and promote organization, ensuring a smooth and tidy project environment.

In order for the tool to work, we need Wwise 2023. Older projects won't work with all features.

Table of Contents


Connection

There are two options for how we can connect the helper to a Wwise project.

Option 1:

  • Insert the path to your WwiseConsole.exe, typically found in Wwise 2023.1.0.8367\Authoring\x64\Release\bin.

  • Input the path to the Wwise project.

  • Ensure that the "Connect Open" option is unchecked.

This launches the Wwise project in the console, enabling you to execute WAAPI commands.

Option 2:

  • Ensure your Wwise project is open.

  • Check the "Connect Open" option.

This will connect the tool to the open Wwise project.


Connection view

Naming Convention Check

Ensuring a clean, well-structured, and appropriately named Wwise project is paramount, particularly for larger projects. Establishing a naming convention is the first step in maintaining consistency throughout the project. To make sure that everyone sticks to the chosen convention, the tool can run this check to find all of the wrongly named assets.

All variables that can be set for the Actor-Mixer Hierarchy.

We spent a lot of time developing and discussing naming conventions. With the tool we came up with fields that can be adjusted by the user.


The tool differentiates between container settings and section settings.

Sections are Master-Mixer-Hierarchy, Events, Switches, etc.

Section settings are:

  • Enable

  • allow uppercase

  • allow space

  • prefix

Container settings are:

  • mandatory number suffix

  • max number suffix

  • mandatory string suffix

  • string suffix (can have multiple by separating them with ",")


In the Execution tab, we are also able to set a path in which to check for. This is especially handy in bigger projects, where a whole check might take some time and you just want to check your newest changes. Entering the Wwise path works with IntelliSense and just clicking the part you need.


Setting an entry point to check your naming convention.

Manage Originals

If you ever felt the need to sort your originals and delete the ones you don't need anymore, then this is the tool for you. Every Wwise container type you check will create a subfolder in the Originals folder and sort the .wav files in them. It will automatically change the path references in Wwise, so nothing will break. Files that are used multiple times have a special folder "Multiple".

Manage originals view

Balance Property

This will let you balance properties in a hierarchy. For example you have the following structure:

  • Actor-Mixer Volume: 5

    • Random Container Volume -5

    • Sequence Container Volume -3

After running the tool, it will look like this:

  • Actor-Mixer Volume: 2

    • Random Container Volume -2

    • Sequence Container Volume 0

This works with all of these types if there is one. It wont be distracted by folders or other containers that don't have these properties.


Check Color Coding



The tool is selecting objects either by type of the container, we call it Class here, or Part of the name.

There is a hierarchy with which the colors can be assigned.

  1. Single Hard

    1. Every container found will need that color and can't be overwritten

    2. Only accounts for single containers, not for their children

  2. Hierarchy Hard

    1. Can only be overwritten by single hard.

    2. Children of the containers found will also need that color assigned to be valid.

  3. Single Soft

  4. Hierarchy Soft


Query Manager

With the Query Manager, you are able to use your own queries created by WAQL in combination with Wwise Queries. It lets you run multiple Queries simultaneous with an AND/OR filter. When you click the query results, it will focus that file in the Wwise project window. If the project is open. Like that you are able to quickly locate your results.

Query Manager

WAQL IntelliSense

If you want to create queries on your own, there is the Query creator. With WAQL, you can create new queries and save them. We also support WAQL IntelliSense there, which makes it a great tool for learning WAQL in general, to use it in the List View inside of Wwise.



Future Work

We have plenty more features planned for this tool and are actively developing these. Next up will be

  • container refactoring

  • automated switch container creation

 
 
 

Comentarios

bottom of page