Installer project-ebonhold-wine-webview2

description: ''
game_slug: project-ebonhold
gogslug: ''
humblestoreid: ''
installer_slug: project-ebonhold-wine-webview2
name: Project Ebonhold
notes: "The launcher is a Tauri app, so it needs the Microsoft Edge WebView2 runtime\
  \ rather than Electron. This installer downloads and installs it into the prefix\
  \ automatically.\r\n\r\nThe important part: WebView2 only takes the DirectComposition\
  \ rendering path on Windows 8.1 and newer, and Wine's DCompositionCreateDevice3\
  \ is still a stub returning E_NOTIMPL. On a default win10 prefix the launcher window\
  \ is therefore completely black, even though it is running correctly and all its\
  \ msedgewebview2.exe processes are alive. The installer sets a per-application Windows\
  \ version override of win8 for msedgewebview2.exe; the prefix itself stays on win10.\
  \ See WineHQ bug 58921. Setting win7 also avoids DirectComposition but crashes the\
  \ launcher in ole32, so win8 is the value to use.\r\n\r\nTested on Wine 11.16. A\
  \ recent Wine is recommended; older builds have not been tested and may not render\
  \ the launcher. No Wine version is pinned here because the build this was tested\
  \ against is not one of the versions Lutris offers.\r\n\r\nThe launcher setup EXE\
  \ is served from an expiring pre-signed URL, so it cannot be linked directly. Download\
  \ it from https://project-ebonhold.com/support/installation-guide and select it\
  \ when the installer asks.\r\n\r\nAfter installing, run the launcher, register or\
  \ log in, and let it download the 3.3.5a client. In the client's video options set\
  \ Windowed + Maximized: WoW 3.3.5a cannot recover its D3D9 device when an exclusive-fullscreen\
  \ window loses focus and will die with ERROR #132 on alt-tab."
runner: wine
script:
  files:
  - webview2:
      filename: MicrosoftEdgeWebView2RuntimeInstallerX64.exe
      url: https://go.microsoft.com/fwlink/?linkid=2124701
  - launcher: N/A:Select the Ebonhold launcher setup (ebonhold_<version>_x64-setup.exe)
      downloaded from https://project-ebonhold.com/support/installation-guide
  game:
    arch: win64
    exe: $GAMEDIR/drive_c/Ebonhold/ebonhold.exe
    prefix: $GAMEDIR
    working_dir: $GAMEDIR/drive_c/Ebonhold
  installer:
  - task:
      arch: win64
      name: create_prefix
      prefix: $GAMEDIR
  - task:
      app: win10
      name: winetricks
      prefix: $GAMEDIR
  - task:
      args: /silent /install
      executable: webview2
      name: wineexec
      prefix: $GAMEDIR
  - task:
      key: Version
      name: set_regedit
      path: HKEY_CURRENT_USER\Software\Wine\AppDefaults\msedgewebview2.exe
      prefix: $GAMEDIR
      value: win8
  - task:
      args: /S /NCRC /D=C:\Ebonhold
      executable: launcher
      name: wineexec
      prefix: $GAMEDIR
  system:
    include_processes: ebonhold.exe msedgewebview2.exe Wow.exe
slug: project-ebonhold-wine-webview2
steamid: null
version: Wine + WebView2
year: 2026

{
  "game_slug": "project-ebonhold",
  "version": "Wine + WebView2",
  "description": "",
  "notes": "The launcher is a Tauri app, so it needs the Microsoft Edge WebView2 runtime rather than Electron. This installer downloads and installs it into the prefix automatically.\r\n\r\nThe important part: WebView2 only takes the DirectComposition rendering path on Windows 8.1 and newer, and Wine's DCompositionCreateDevice3 is still a stub returning E_NOTIMPL. On a default win10 prefix the launcher window is therefore completely black, even though it is running correctly and all its msedgewebview2.exe processes are alive. The installer sets a per-application Windows version override of win8 for msedgewebview2.exe; the prefix itself stays on win10. See WineHQ bug 58921. Setting win7 also avoids DirectComposition but crashes the launcher in ole32, so win8 is the value to use.\r\n\r\nTested on Wine 11.16. A recent Wine is recommended; older builds have not been tested and may not render the launcher. No Wine version is pinned here because the build this was tested against is not one of the versions Lutris offers.\r\n\r\nThe launcher setup EXE is served from an expiring pre-signed URL, so it cannot be linked directly. Download it from https://project-ebonhold.com/support/installation-guide and select it when the installer asks.\r\n\r\nAfter installing, run the launcher, register or log in, and let it download the 3.3.5a client. In the client's video options set Windowed + Maximized: WoW 3.3.5a cannot recover its D3D9 device when an exclusive-fullscreen window loses focus and will die with ERROR #132 on alt-tab.",
  "name": "Project Ebonhold",
  "year": 2026,
  "steamid": null,
  "gogslug": "",
  "humblestoreid": "",
  "runner": "wine",
  "slug": "project-ebonhold-wine-webview2",
  "installer_slug": "project-ebonhold-wine-webview2",
  "script": {
    "files": [
      {
        "webview2": {
          "filename": "MicrosoftEdgeWebView2RuntimeInstallerX64.exe",
          "url": "https://go.microsoft.com/fwlink/?linkid=2124701"
        }
      },
      {
        "launcher": "N/A:Select the Ebonhold launcher setup (ebonhold_<version>_x64-setup.exe) downloaded from https://project-ebonhold.com/support/installation-guide"
      }
    ],
    "game": {
      "arch": "win64",
      "exe": "$GAMEDIR/drive_c/Ebonhold/ebonhold.exe",
      "prefix": "$GAMEDIR",
      "working_dir": "$GAMEDIR/drive_c/Ebonhold"
    },
    "installer": [
      {
        "task": {
          "arch": "win64",
          "name": "create_prefix",
          "prefix": "$GAMEDIR"
        }
      },
      {
        "task": {
          "app": "win10",
          "name": "winetricks",
          "prefix": "$GAMEDIR"
        }
      },
      {
        "task": {
          "args": "/silent /install",
          "executable": "webview2",
          "name": "wineexec",
          "prefix": "$GAMEDIR"
        }
      },
      {
        "task": {
          "key": "Version",
          "name": "set_regedit",
          "path": "HKEY_CURRENT_USER\\Software\\Wine\\AppDefaults\\msedgewebview2.exe",
          "prefix": "$GAMEDIR",
          "value": "win8"
        }
      },
      {
        "task": {
          "args": "/S /NCRC /D=C:\\Ebonhold",
          "executable": "launcher",
          "name": "wineexec",
          "prefix": "$GAMEDIR"
        }
      }
    ],
    "system": {
      "include_processes": "ebonhold.exe msedgewebview2.exe Wow.exe"
    }
  }
}