coah 354ca1702b feat: SWF-to-PNG extraction pipeline + de-SWF roadmap
- 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
2026-07-07 03:15:35 -05:00

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)
Description
macOS port of neoLegacy: clang-cl cross-build, Wine+DXVK+MoltenVK runtime, tools, SWF-to-PNG UI work
Readme 31 MiB
Languages
C 82.8%
C++ 11%
Python 5.5%
SourcePawn 0.2%
CMake 0.2%
Other 0.2%