fix: WHITE SCREEN — switch runtime to CrossOver 26 (wine 11)

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.
This commit is contained in:
2026-07-07 14:42:39 -05:00
parent 0bb7722800
commit 5e5977bb80
4 changed files with 113 additions and 27 deletions

43
run-client-cx26.sh Executable file
View File

@@ -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 "$@"

21
run-client-native.sh Executable file
View File

@@ -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" "$@"

36
run-client-wine8-legacy.sh Executable file
View File

@@ -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 "$@"

View File

@@ -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" "$@"