Release notes

What’s new #

Content Development #

Blending With Game Content

Gameface now supports blending of DOM elements with the 3D scene texture behind the UI. DOM elements can utilize the mix-blend-mode property and their colors can be properly blended with the game content behind them.

For more details, see the documentation for Blending With Game Content

Player CLI enhanced options

The Player now supports the --remote-debugging-port command line argument and passing URLs without using the --url CLA, for example Player.exe coui://uiresources/MyUI.html. This change aims to improve the compatibility between the Player and third-party tools that have integration with Chrome or the Inspector protocol, for example when using Visual Studio Code debugging.

Migration guide #

Changes to ScriptCompiler

In this release, we have removed the possibility to pass ST_Unknown to ScriptCompiler::Compile(). The user is responsible to pass the correct script type ST_Classic or ST_Module to ScriptCompiler::Compile(). That’s important because the produced optimizedData is different and it will be rejected by V8 if it is not correct. If you are not sure of which type is the script, you can try passing ST_Classic first and if the return value is nullptr, try with ST_Module. However, this is not recommended because modules that don’t contain specific keywords like import/export might be successfully compiled as normal scripts.

Gameface will issue a warning if the optimizedData is pre-compiled as module and used as script or vice-versa:

Based on the supplied isCompiledAsModule in IAsyncResourceResponse::ReceiveOptimizedData(), Gameface will issue a warning if the optimizedData is used in the wrong place: "Trying to initialize module <name> with optimizedData precompiled as a script instead of a module." / "Trying to initialize normal script <name> with optimizedData precompiled as a module.".

Changelog #

Version 1.68.0 #