Files
neoLegacy-mac/README.md
coah f9b5e53d30 feat: macOS port tooling — clang-cl cross-build + Wine/DXVK/MoltenVK runtime
- build-macos.sh: cross-compiles the Windows x64 client on Apple Silicon
  (LLVM clang-cl/lld-link + xwin Windows SDK, fxc via Wine with native
  d3dcompiler DLLs)
- run-client.sh: dedicated Wine prefix with DXVK-macOS (D3D11->Vulkan) on
  MoltenVK (Vulkan->Metal)
- tools/: in-Wine input injectors for automated verification
2026-07-07 03:09:00 -05:00

2.8 KiB

neoLegacy-mac

Runs the neoLegacy Minecraft Legacy Console Edition client on macOS (Apple Silicon), rendering through D3D11 → DXVK (Vulkan) → MoltenVK → Metal.

The upstream repo stays untouched — this repo holds the build/run tooling and the patches that make the port work.

How it works

The game is Windows-native and depends on closed middleware (Iggy flash UI), so the binary itself stays a Windows x64 PE:

  1. Build: build-macos.sh cross-compiles the client on macOS with clang-cl + lld-link (LLVM release toolchain) against the Windows SDK fetched by xwin. HLSL shaders are compiled by the repo's fxc.exe running under Wine with native d3dcompiler_43/47 + d3dx9_43 DLLs.
  2. Run: run-client.sh launches the exe under Wine (Gcenx wine-crossover build) with DXVK-macOS translating D3D11 to Vulkan and MoltenVK translating Vulkan to Metal.

Prerequisites

  • Apple Silicon Mac with Rosetta 2 (softwareupdate --install-rosetta)
  • Wine Crossover (brew install --cask wine-crossover)
  • cmake + ninja + rsync
  • LLVM release tarball (with lld-link) at ~/.local/llvm22 — see LLVM_DIR in build-macos.sh
  • cargo install xwin
  • DXVK-macOS extracted into dxvk/ (see run-client.sh)
  • Native d3dcompiler_47.dll (32+64-bit), d3dcompiler_43.dll, d3dx9_43.dll in the Wine prefix (fetched from Firefox installers / DirectX Jun2010 redist; see notes in run-client.sh)

Usage

git clone https://git.neolegacy.dev/coah80/neoLegacy.git ~/neoLegacy
cd ~/neoLegacy && git submodule update --init --recursive
./build-macos.sh              # cross-compile Release client
./run-client.sh               # launch under Wine + DXVK + MoltenVK

Tools

  • tools/send_f2.c / tools/send_key.c — tiny Windows helpers, compiled with the same clang-cl toolchain, that focus the game window inside Wine and inject keys (F2 = the game's built-in screenshot). Used for automated testing without macOS accessibility permissions.

Upstream patches carried locally

  • Minecraft.Client/Common/UI/UIController.cpp:671 — upstream commit 47e5cba3's parent (b5707e88) committed literal git conflict markers, which clang rejects. Resolved to a single skinHDWin.swf fallback under the platformskinHD.swf import name.

Status

  • Client builds on macOS (clang-cl cross-compile, ~1456 build steps)
  • Runs and is playable: menus, worldgen, HUD, chat, death/respawn verified
  • Audio is pure OGG on this platform (miniaudio + stb_vorbis; Bink Audio only ever existed for the console targets, which aren't built)
  • SWF/Iggy UI replaced with PNG-based UI (in progress)