files:
- wuwaclient:
filename: WutheringWaves_overseas _setup_2.1.4.0.exe
url: https://mirrors-package-mc.aki-game.net/client/download/20250711102628_8Rjx2xhDLpSPAMVhd7/WutheringWaves_overseas_setup_2.1.4.0.exe
game:
arch: win64
exe: $GAMEDIR/drive_c/Program Files/Wuthering Waves/launcher.exe
prefix: $GAMEDIR
installer:
- task:
description: Creating Wine Bottle, please wait...
install_gecko: false
install_mono: 'false'
name: create_prefix
prefix: $GAMEDIR
- task:
app: corefonts
description: 'Winetricks: Installing "corefonts"'
name: winetricks
silent: true
- task:
app: vcrun2015
description: 'Winetricks: Installing "vcrun2015"'
name: winetricks
silent: true
- task:
app: win10
description: 'Winetricks: Re-enable "win10"'
name: winetricks
silent: true
- task:
description: Installing 'Wuthering Waves Launcher'. Don't start the game after
installation, just exit.
executable: wuwaclient
name: wineexec
- write_file:
content: "#!/usr/bin/env bash\n\n# Base directory where version directories reside\n\
base_dir=./drive_c/Program\\ Files/Wuthering\\ Waves\n\n# Check if bbe is installed\n\
if ! command -v bbe &> /dev/null; then\n echo \"Error: bbe is not installed.\
\ Please install bbe and try again.\"\n exit 1\nfi\n\n# Auto-detect the latest\
\ version directory (assumes version directories match the pattern X.Y.Z.W)\n\
version_dir=$(find \"$base_dir\" -maxdepth 1 -type d -name \"[0-9]*.[0-9]*.[0-9]*.[0-9]*\"\
\ | sort -V | tail -n1)\n\nif [ -z \"$version_dir\" ]; then\n echo \"No version\
\ directory found in '$base_dir'.\"\n exit 1\nfi\n\necho \"Using version\
\ directory: $version_dir\"\ncd \"$version_dir\" || { echo \"Failed to change\
\ directory to $version_dir\"; exit 1; }\n\n# Check if the DLL still contains\
\ the original pattern\nif ! grep -a -q $'\\x12AllowsTransparency' launcher_main.dll;\
\ then\n echo \"launcher_main.dll is already patched or does not contain\
\ the expected pattern.\"\n exit 0\nfi\n\n# Backup the original file and\
\ apply the patch using bbe\nmv launcher_main.dll launcher_main.dll.bak\nbbe\
\ -e \"s/\\x12AllowsTransparency/\\x09IsEnabled\\x1bA\\x00\\x03AAAAA/\" launcher_main.dll.bak\
\ > launcher_main.dll\n\necho \"Patch applied successfully.\"\n"
file: $GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh
- execute:
args: +x "$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh"
descritpion: 'Workaround: backup ''launcher_main.dll'''
file: chmod
- task:
description: 'Winetricks: Enable compatibility mode win7 for "msedgewebview2.exe"'
key: Version
name: set_regedit
path: HKEY_CURRENT_USER\Software\Wine\AppDefaults\msedgewebview2.exe
prefix: $GAMEDIR
value: win7
require-binaries: bbe
system:
env:
STEAMDECK: '1'
prelaunch_command: '''$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh'''
prelaunch_wait: true
description: Installs the Official Launcher for Wuthering Waves
game_slug: wuthering-waves
gogslug: ''
humblestoreid: ''
installer_slug: wuthering-waves-official-launcher-21
name: Wuthering Waves
notes: "The recent launcher is based on WebView2 (Microsoft Edge something) and as\
\ described on \"https://codeberg.org/mkrsym1/jadeite/issues/69\" the launcher window\
\ is invisible after a regular installation. So this installer script runs workaround\
\ to fix this problem. \r\nPlease notice:\r\n- The mentioned workaround needs to\
\ be reapplied after a launcher update. To automate this Lutris run a prelaunch\
\ script before the game launcher is initialized. \r\n- If the launcher window does\
\ not open after an automatic update, completely exit the game and restart it with\
\ Lutris to trigger the fix.\r\n- The script requires \"bbe\" to be installed on\
\ the system."
runner: wine
script:
files:
- wuwaclient:
filename: WutheringWaves_overseas _setup_2.1.4.0.exe
url: https://mirrors-package-mc.aki-game.net/client/download/20250711102628_8Rjx2xhDLpSPAMVhd7/WutheringWaves_overseas_setup_2.1.4.0.exe
game:
arch: win64
exe: $GAMEDIR/drive_c/Program Files/Wuthering Waves/launcher.exe
prefix: $GAMEDIR
installer:
- task:
description: Creating Wine Bottle, please wait...
install_gecko: false
install_mono: 'false'
name: create_prefix
prefix: $GAMEDIR
- task:
app: corefonts
description: 'Winetricks: Installing "corefonts"'
name: winetricks
silent: true
- task:
app: vcrun2015
description: 'Winetricks: Installing "vcrun2015"'
name: winetricks
silent: true
- task:
app: win10
description: 'Winetricks: Re-enable "win10"'
name: winetricks
silent: true
- task:
description: Installing 'Wuthering Waves Launcher'. Don't start the game after
installation, just exit.
executable: wuwaclient
name: wineexec
- write_file:
content: "#!/usr/bin/env bash\n\n# Base directory where version directories\
\ reside\nbase_dir=./drive_c/Program\\ Files/Wuthering\\ Waves\n\n# Check\
\ if bbe is installed\nif ! command -v bbe &> /dev/null; then\n echo \"\
Error: bbe is not installed. Please install bbe and try again.\"\n exit\
\ 1\nfi\n\n# Auto-detect the latest version directory (assumes version directories\
\ match the pattern X.Y.Z.W)\nversion_dir=$(find \"$base_dir\" -maxdepth 1\
\ -type d -name \"[0-9]*.[0-9]*.[0-9]*.[0-9]*\" | sort -V | tail -n1)\n\n\
if [ -z \"$version_dir\" ]; then\n echo \"No version directory found in\
\ '$base_dir'.\"\n exit 1\nfi\n\necho \"Using version directory: $version_dir\"\
\ncd \"$version_dir\" || { echo \"Failed to change directory to $version_dir\"\
; exit 1; }\n\n# Check if the DLL still contains the original pattern\nif\
\ ! grep -a -q $'\\x12AllowsTransparency' launcher_main.dll; then\n echo\
\ \"launcher_main.dll is already patched or does not contain the expected\
\ pattern.\"\n exit 0\nfi\n\n# Backup the original file and apply the patch\
\ using bbe\nmv launcher_main.dll launcher_main.dll.bak\nbbe -e \"s/\\x12AllowsTransparency/\\\
x09IsEnabled\\x1bA\\x00\\x03AAAAA/\" launcher_main.dll.bak > launcher_main.dll\n\
\necho \"Patch applied successfully.\"\n"
file: $GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh
- execute:
args: +x "$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh"
descritpion: 'Workaround: backup ''launcher_main.dll'''
file: chmod
- task:
description: 'Winetricks: Enable compatibility mode win7 for "msedgewebview2.exe"'
key: Version
name: set_regedit
path: HKEY_CURRENT_USER\Software\Wine\AppDefaults\msedgewebview2.exe
prefix: $GAMEDIR
value: win7
require-binaries: bbe
system:
env:
STEAMDECK: '1'
prelaunch_command: '''$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh'''
prelaunch_wait: true
slug: wuthering-waves-official-launcher-21
steamid: 3513350
version: Official Launcher 2.1.4.0
year: 2024
{
"game_slug": "wuthering-waves",
"version": "Official Launcher 2.1.4.0",
"description": "Installs the Official Launcher for Wuthering Waves",
"notes": "The recent launcher is based on WebView2 (Microsoft Edge something) and as described on \"https://codeberg.org/mkrsym1/jadeite/issues/69\" the launcher window is invisible after a regular installation. So this installer script runs workaround to fix this problem. \r\nPlease notice:\r\n- The mentioned workaround needs to be reapplied after a launcher update. To automate this Lutris run a prelaunch script before the game launcher is initialized. \r\n- If the launcher window does not open after an automatic update, completely exit the game and restart it with Lutris to trigger the fix.\r\n- The script requires \"bbe\" to be installed on the system.",
"name": "Wuthering Waves",
"year": 2024,
"steamid": 3513350,
"gogslug": "",
"humblestoreid": "",
"runner": "wine",
"slug": "wuthering-waves-official-launcher-21",
"installer_slug": "wuthering-waves-official-launcher-21",
"script": {
"files": [
{
"wuwaclient": {
"filename": "WutheringWaves_overseas _setup_2.1.4.0.exe",
"url": "https://mirrors-package-mc.aki-game.net/client/download/20250711102628_8Rjx2xhDLpSPAMVhd7/WutheringWaves_overseas_setup_2.1.4.0.exe"
}
}
],
"game": {
"arch": "win64",
"exe": "$GAMEDIR/drive_c/Program Files/Wuthering Waves/launcher.exe",
"prefix": "$GAMEDIR"
},
"installer": [
{
"task": {
"description": "Creating Wine Bottle, please wait...",
"install_gecko": false,
"install_mono": "false",
"name": "create_prefix",
"prefix": "$GAMEDIR"
}
},
{
"task": {
"app": "corefonts",
"description": "Winetricks: Installing \"corefonts\"",
"name": "winetricks",
"silent": true
}
},
{
"task": {
"app": "vcrun2015",
"description": "Winetricks: Installing \"vcrun2015\"",
"name": "winetricks",
"silent": true
}
},
{
"task": {
"app": "win10",
"description": "Winetricks: Re-enable \"win10\"",
"name": "winetricks",
"silent": true
}
},
{
"task": {
"description": "Installing 'Wuthering Waves Launcher'. Don't start the game after installation, just exit.",
"executable": "wuwaclient",
"name": "wineexec"
}
},
{
"write_file": {
"content": "#!/usr/bin/env bash\n\n# Base directory where version directories reside\nbase_dir=./drive_c/Program\\ Files/Wuthering\\ Waves\n\n# Check if bbe is installed\nif ! command -v bbe &> /dev/null; then\n echo \"Error: bbe is not installed. Please install bbe and try again.\"\n exit 1\nfi\n\n# Auto-detect the latest version directory (assumes version directories match the pattern X.Y.Z.W)\nversion_dir=$(find \"$base_dir\" -maxdepth 1 -type d -name \"[0-9]*.[0-9]*.[0-9]*.[0-9]*\" | sort -V | tail -n1)\n\nif [ -z \"$version_dir\" ]; then\n echo \"No version directory found in '$base_dir'.\"\n exit 1\nfi\n\necho \"Using version directory: $version_dir\"\ncd \"$version_dir\" || { echo \"Failed to change directory to $version_dir\"; exit 1; }\n\n# Check if the DLL still contains the original pattern\nif ! grep -a -q $'\\x12AllowsTransparency' launcher_main.dll; then\n echo \"launcher_main.dll is already patched or does not contain the expected pattern.\"\n exit 0\nfi\n\n# Backup the original file and apply the patch using bbe\nmv launcher_main.dll launcher_main.dll.bak\nbbe -e \"s/\\x12AllowsTransparency/\\x09IsEnabled\\x1bA\\x00\\x03AAAAA/\" launcher_main.dll.bak > launcher_main.dll\n\necho \"Patch applied successfully.\"\n",
"file": "$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh"
}
},
{
"execute": {
"args": "+x \"$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh\"",
"descritpion": "Workaround: backup 'launcher_main.dll'",
"file": "chmod"
}
},
{
"task": {
"description": "Winetricks: Enable compatibility mode win7 for \"msedgewebview2.exe\"",
"key": "Version",
"name": "set_regedit",
"path": "HKEY_CURRENT_USER\\Software\\Wine\\AppDefaults\\msedgewebview2.exe",
"prefix": "$GAMEDIR",
"value": "win7"
}
}
],
"require-binaries": "bbe",
"system": {
"env": {
"STEAMDECK": "1"
},
"prelaunch_command": "'$GAMEDIR/drive_c/Program Files/Wuthering Waves/webview2-workaround.sh'",
"prelaunch_wait": true
}
}
}
