6514e994bdecf9bd5faeae8566b72641830782d5
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:
- Build:
build-macos.shcross-compiles the client on macOS withclang-cl+lld-link(LLVM release toolchain) against the Windows SDK fetched by xwin. HLSL shaders are compiled by the repo'sfxc.exerunning under Wine with natived3dcompiler_43/47+d3dx9_43DLLs. - Run:
run-client.shlaunches 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— seeLLVM_DIRinbuild-macos.sh cargo install xwin- DXVK-macOS extracted into
dxvk/(seerun-client.sh) - Native
d3dcompiler_47.dll(32+64-bit),d3dcompiler_43.dll,d3dx9_43.dllin the Wine prefix (fetched from Firefox installers / DirectX Jun2010 redist; see notes inrun-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 commit47e5cba3's parent (b5707e88) committed literal git conflict markers, which clang rejects. Resolved to a singleskinHDWin.swffallback under theplatformskinHD.swfimport 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: the closed
iggy_w64.dllis swapped for the openiggy-shim(iggy-shim/), which loads UI from extracted PNGs + JSON layout manifests — no Flash runtime, no.swfparsing. The full game flow works through it: title → main menu → Play → EULA → Load/Create/ Join → Create New World → world options → generate → in-game with HUD. All UI subsystems function: PNG sprite rendering, bitmap-font text (the game's own Mojangles glyphs), focus highlight, keyboard navigation, button press, scene transitions, dynamicFJ_Listmenus, checkboxes, tab switching, scroll-gated accept. A standard UI library, RmlUi (+ FreeType), is cross-compiled and wired as a second render path, gatedIGGY_SHIM_RML=1pending a Wine init fix. See docs/UI-DESWF-ROADMAP.md. Remaining polish: button/panel 9-slice skin art (buttons are currently text-only), list-item font scaling, and the RmlUi runtime crash.
Description
macOS port of neoLegacy: clang-cl cross-build, Wine+DXVK+MoltenVK runtime, tools, SWF-to-PNG UI work
Languages
C
82.8%
C++
11%
Python
5.5%
SourcePawn
0.2%
CMake
0.2%
Other
0.2%