From 5e5977bb8088489411cf862c9f69e25a1cb4a39d Mon Sep 17 00:00:00 2001 From: coah Date: Tue, 7 Jul 2026 14:42:39 -0500 Subject: [PATCH] =?UTF-8?q?fix:=20WHITE=20SCREEN=20=E2=80=94=20switch=20ru?= =?UTF-8?q?ntime=20to=20CrossOver=2026=20(wine=2011)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Root cause: the 2023 wine-crossover 8.0.1 + DXVK-macOS 1.10.3 stack renders correctly to the backbuffer (F2 captures were always right) but its Metal-layer PRESENT path composites white on macOS 27. Verified live-window capture: 97% white pixels on old stack, 0% on new. New default run-client.sh: CrossOver 26 bottle 'neolegacy' (wine-11.0 + CrossOver's current D3D->Metal translation on MoltenVK), launched via the wine wrapper with --cx-app Z:-path. Old launchers kept as run-client-wine8-legacy.sh / run-client-cx26.sh (raw loader attempt). Verified: live window shows the main menu with panorama + selection bar. --- run-client-cx26.sh | 43 ++++++++++++++++++++++++++++++++++++++ run-client-native.sh | 21 +++++++++++++++++++ run-client-wine8-legacy.sh | 36 +++++++++++++++++++++++++++++++ run-client.sh | 40 ++++++++++++----------------------- 4 files changed, 113 insertions(+), 27 deletions(-) create mode 100755 run-client-cx26.sh create mode 100755 run-client-native.sh create mode 100755 run-client-wine8-legacy.sh diff --git a/run-client-cx26.sh b/run-client-cx26.sh new file mode 100755 index 0000000..6e7d838 --- /dev/null +++ b/run-client-cx26.sh @@ -0,0 +1,43 @@ +#!/usr/bin/env bash +# Launch neoLegacy under CrossOver 26's wine (current, macOS-27-era) with its +# bundled DXVK (D3D11->Vulkan) on MoltenVK. Fixes the white-window present +# issue seen with the 2023-era wine-crossover 8.0.1 cask. +set -euo pipefail + +GAME_DIR="${GAME_DIR:-$HOME/neoLegacy/build/windows64-clang-mac/Minecraft.Client}" +CX="/Applications/CrossOver.app/Contents/SharedSupport/CrossOver" +export WINEPREFIX="${WINEPREFIX:-$HOME/.local/share/neolegacy-cx26}" +export WINEDEBUG="${WINEDEBUG:--all}" +export CX_ROOT="$CX" +# wineloader is the real wine binary (wine-11.0); the `wine` wrapper insists +# on CrossOver bottles, which we don't need. +WINE="$CX/bin/wineloader" +export PATH="$CX/bin:$PATH" +# raw wineloader needs CrossOver's dylib search paths (MoltenVK etc.) +export DYLD_FALLBACK_LIBRARY_PATH="$CX/lib64:$CX/lib:/usr/local/lib:/usr/lib" + +[[ -f "$GAME_DIR/Minecraft.Client.exe" ]] || { echo "client exe not found in $GAME_DIR" >&2; exit 1; } + +if [[ ! -f "$WINEPREFIX/.neolegacy-setup-done" ]]; then + mkdir -p "$WINEPREFIX" + "$WINE" wineboot -u || true + sys32="$WINEPREFIX/drive_c/windows/system32" + syswow="$WINEPREFIX/drive_c/windows/syswow64" + # CrossOver's own DXVK build + cp "$CX/lib/dxvk/x86_64-windows/d3d11.dll" "$CX/lib/dxvk/x86_64-windows/d3d10core.dll" "$sys32/" 2>/dev/null || true + cp "$CX/lib/dxvk/i386-windows/d3d11.dll" "$CX/lib/dxvk/i386-windows/d3d10core.dll" "$syswow/" 2>/dev/null || true + # native HLSL compiler chain (shim compiles its UI shaders at runtime) + cp "$HOME/neoLegacy-mac/ffx/d3dcompiler_47.dll" "$sys32/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/ffx32/d3dcompiler_47.dll" "$syswow/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x64/d3dcompiler_43.dll" "$sys32/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x86/D3DCompiler_43.dll" "$syswow/d3dcompiler_43.dll" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x64/d3dx9_43.dll" "$sys32/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x86/d3dx9_43.dll" "$syswow/" 2>/dev/null || true + for dll in d3d11 d3d10core d3dcompiler_47 d3dcompiler_43 d3dx9_43; do + "$WINE" reg add 'HKCU\Software\Wine\DllOverrides' /v "$dll" /d native /f >/dev/null 2>&1 || true + done + touch "$WINEPREFIX/.neolegacy-setup-done" +fi + +cd "$GAME_DIR" +exec "$WINE" Minecraft.Client.exe "$@" diff --git a/run-client-native.sh b/run-client-native.sh new file mode 100755 index 0000000..41b4c7e --- /dev/null +++ b/run-client-native.sh @@ -0,0 +1,21 @@ +#!/usr/bin/env bash +# Launch neoLegacy under CrossOver 26 (wine 11 + its modern D3D→Metal +# translation, DXMT/DXVK on MoltenVK). This fixes the white-window present +# bug from the 2023-era DXVK-macOS build. Named "-native" because it uses the +# current Apple-Silicon graphics stack, not the legacy one. +set -euo pipefail + +GAME_DIR="${GAME_DIR:-$HOME/neoLegacy/build/windows64-clang-mac/Minecraft.Client}" +CX="/Applications/CrossOver.app/Contents/SharedSupport/CrossOver" +BOTTLE="${CX_BOTTLE:-neolegacy}" +export CX_ROOT="$CX" + +[[ -f "$GAME_DIR/Minecraft.Client.exe" ]] || { echo "client exe not found in $GAME_DIR" >&2; exit 1; } + +# The CrossOver `wine` wrapper wires up MoltenVK, the Metal backend and the +# bottle env for us. --cx-app takes a full path (host or Z:\ form) and sets +# the working directory to the exe's folder, which the game requires for its +# relative asset paths. +cd "$GAME_DIR" +WINPATH="Z:$(echo "$GAME_DIR/Minecraft.Client.exe" | tr '/' '\\')" +exec "$CX/bin/wine" --bottle "$BOTTLE" --no-update --cx-app "$WINPATH" "$@" diff --git a/run-client-wine8-legacy.sh b/run-client-wine8-legacy.sh new file mode 100755 index 0000000..b8b933d --- /dev/null +++ b/run-client-wine8-legacy.sh @@ -0,0 +1,36 @@ +#!/usr/bin/env bash +# Launch the neoLegacy client on macOS: Wine + DXVK (D3D11->Vulkan) + MoltenVK (Vulkan->Metal). +set -euo pipefail + +GAME_DIR="${GAME_DIR:-$HOME/neoLegacy/build/windows64-clang-mac/Minecraft.Client}" +export WINEPREFIX="${WINEPREFIX:-$HOME/.local/share/neolegacy-wine}" +export WINEDEBUG="${WINEDEBUG:--all}" +DXVK_DIR="$HOME/neoLegacy-mac/dxvk/dxvk-macOS-async-v1.10.3-20230507-repack/x64" + +[[ -f "$GAME_DIR/Minecraft.Client.exe" ]] || { echo "client exe not found in $GAME_DIR" >&2; exit 1; } + +# One-time prefix setup: create prefix, install DXVK + shader-compiler natives. +if [[ ! -f "$WINEPREFIX/.neolegacy-setup-done" ]]; then + mkdir -p "$WINEPREFIX" + wineboot -u + sys32="$WINEPREFIX/drive_c/windows/system32" + syswow="$WINEPREFIX/drive_c/windows/syswow64" + cp "$DXVK_DIR/d3d11.dll" "$DXVK_DIR/d3d10core.dll" "$sys32/" + # Native HLSL compiler chain (only needed if anything compiles shaders at runtime) + cp "$HOME/neoLegacy-mac/ffx/d3dcompiler_47.dll" "$sys32/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/ffx32/d3dcompiler_47.dll" "$syswow/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x64/d3dx9_43.dll" "$sys32/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x86/d3dx9_43.dll" "$syswow/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x64/d3dcompiler_43.dll" "$sys32/" 2>/dev/null || true + cp "$HOME/neoLegacy-mac/dx/x86/D3DCompiler_43.dll" "$syswow/d3dcompiler_43.dll" 2>/dev/null || true + wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3d11 /d native /f + wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3d10core /d native /f + wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3dcompiler_47 /d native /f + wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3dcompiler_43 /d native /f + wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3dx9_43 /d native /f + touch "$WINEPREFIX/.neolegacy-setup-done" +fi + +cd "$GAME_DIR" +export DXVK_HUD="${DXVK_HUD:-fps,version}" +exec wine Minecraft.Client.exe "$@" diff --git a/run-client.sh b/run-client.sh index c9d06af..41b4c7e 100755 --- a/run-client.sh +++ b/run-client.sh @@ -1,35 +1,21 @@ #!/usr/bin/env bash -# Launch the neoLegacy client on macOS: Wine + DXVK (D3D11->Vulkan) + MoltenVK (Vulkan->Metal). +# Launch neoLegacy under CrossOver 26 (wine 11 + its modern D3D→Metal +# translation, DXMT/DXVK on MoltenVK). This fixes the white-window present +# bug from the 2023-era DXVK-macOS build. Named "-native" because it uses the +# current Apple-Silicon graphics stack, not the legacy one. set -euo pipefail GAME_DIR="${GAME_DIR:-$HOME/neoLegacy/build/windows64-clang-mac/Minecraft.Client}" -export WINEPREFIX="${WINEPREFIX:-$HOME/.local/share/neolegacy-wine}" -export WINEDEBUG="${WINEDEBUG:--all}" -DXVK_DIR="$HOME/neoLegacy-mac/dxvk/dxvk-macOS-async-v1.10.3-20230507-repack/x64" +CX="/Applications/CrossOver.app/Contents/SharedSupport/CrossOver" +BOTTLE="${CX_BOTTLE:-neolegacy}" +export CX_ROOT="$CX" [[ -f "$GAME_DIR/Minecraft.Client.exe" ]] || { echo "client exe not found in $GAME_DIR" >&2; exit 1; } -# One-time prefix setup: create prefix, install DXVK + shader-compiler natives. -if [[ ! -f "$WINEPREFIX/.neolegacy-setup-done" ]]; then - mkdir -p "$WINEPREFIX" - wineboot -u - sys32="$WINEPREFIX/drive_c/windows/system32" - syswow="$WINEPREFIX/drive_c/windows/syswow64" - cp "$DXVK_DIR/d3d11.dll" "$DXVK_DIR/d3d10core.dll" "$sys32/" - # Native HLSL compiler chain (only needed if anything compiles shaders at runtime) - cp "$HOME/neoLegacy-mac/ffx/d3dcompiler_47.dll" "$sys32/" 2>/dev/null || true - cp "$HOME/neoLegacy-mac/ffx32/d3dcompiler_47.dll" "$syswow/" 2>/dev/null || true - cp "$HOME/neoLegacy-mac/dx/x64/d3dx9_43.dll" "$sys32/" 2>/dev/null || true - cp "$HOME/neoLegacy-mac/dx/x86/d3dx9_43.dll" "$syswow/" 2>/dev/null || true - cp "$HOME/neoLegacy-mac/dx/x64/d3dcompiler_43.dll" "$sys32/" 2>/dev/null || true - cp "$HOME/neoLegacy-mac/dx/x86/D3DCompiler_43.dll" "$syswow/d3dcompiler_43.dll" 2>/dev/null || true - wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3d11 /d native /f - wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3d10core /d native /f - wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3dcompiler_47 /d native /f - wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3dcompiler_43 /d native /f - wine reg add 'HKCU\Software\Wine\DllOverrides' /v d3dx9_43 /d native /f - touch "$WINEPREFIX/.neolegacy-setup-done" -fi - +# The CrossOver `wine` wrapper wires up MoltenVK, the Metal backend and the +# bottle env for us. --cx-app takes a full path (host or Z:\ form) and sets +# the working directory to the exe's folder, which the game requires for its +# relative asset paths. cd "$GAME_DIR" -exec wine Minecraft.Client.exe "$@" +WINPATH="Z:$(echo "$GAME_DIR/Minecraft.Client.exe" | tr '/' '\\')" +exec "$CX/bin/wine" --bottle "$BOTTLE" --no-update --cx-app "$WINPATH" "$@"