354ca1702bec9f64fc8ea6a87f36e94982385fef
- extract-ui-pngs.sh: batch-exports all 377 Windows64 SWFs via ffdec (50,077 PNGs: bitmaps, shapes, sprite frames, named by export symbol) - tools/DumpLayout.java: dumps per-SWF layout JSON (exports, imports, sprite display lists with matrices and instance names) - docs/UI-DESWF-ROADMAP.md: phased plan to replace Iggy with a PNG-based iggy-shim, scene by scene
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 with PNG-based UI (in progress)
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%