Version

menu_open
Wwise SDK 2024.1.0
execute-lua-script

Execute a Lua script. Optionally, specify additional Lua search paths, additional modules, and additional Lua scripts to load prior to the main script. The script can return a value. All arguments will be passed to the Lua script in the "wa_args" global variable.

Arguments

FILE

Specify the file path of the main Lua script to load and execute.

Arguments Schema

Options

--allow-migration

Allow migration and save of the Wwise project before executing the operation.

--do-file LUAFILE1
--do-file LUAFILE1 LUAFILE2 ...
--do-file LUAFILE1 --do-file LUAFILE2 ...

Specify an array of Lua files to load before the main Lua script is loaded and executed. This option must be followed by a absolute file name.

--lua-path PATH1
--lua-path PATH1 PATH2 ...
--lua-path PATH1 --lua-path PATH2 ...

Specify a search path for Lua modules loaded. This option must be followed by a Lua path. Ex: '–lua-path C:\module\?.lua'

--project PROJECT

When no project is specified, no project is loaded. Refer to ak.wwise.console.project.open for information on how to open a project.
The path to the project file (.wproj).

--require MODULE1
--require MODULE1 MODULE2 ...
--require MODULE1 --require MODULE2 ...

Specify an array of Lua module to load at runtime using the require system. This option must be followed by a Lua module name. The module name must be found in the Lua path. Ex: '–require debug.lua'

--watchdog-timeout 30

Time in seconds to set as a watchdog threshold. The watchdog is signaled every time a WAAPI function call is made. By default, the value is 0 and the watchdog is disabled.
Range: [0,*]

Options Schema

Result

Result returned by the Lua script
A WwiseConsole.exe exit code of 0 means success, 1 means at least one error (and potentially warnings) occurred, and 2 means that only warnings occurred.

Result Schema

Refer to Using the Command Line for more information about Wwise Console.


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