Repository navigation
v0.17.0
MetalSharp Beta 3 (v0.17.0)
DXMT Metal-native D3D11 rendering. Wine 11.5 built from source with 7 custom patches. Single all-in-one runtime bundle. No GPTK dependency for 64-bit games.
What's New
DXMT Metal-Native D3D11
- DXMT D3D11/D3D12/DXGI registered as Wine builtins — games render through Metal directly
- No GPTK, no Vulkan, no CrossOver needed for 64-bit D3D11 titles
- Rain World confirmed running at Feature Level 11_1 on Apple M4
MetalSharp Wine 11.5 (From Source)
- Built from upstream Wine 11.5 with 7 custom patches:
- Patch A: mscompatdb rules engine loader
- Patch B: Apple GPTK bridge compatibility
- Patch C: Graphics backend routing
- Patch D: CEF GL context creation (
MS_FWD_COMPAT_GL_CTX) - Patch E: Runtime root configuration
- Patch F:
macdrv_functionsstruct export — allows DXMT to call Wine macdrv viadlsym(RTLD_DEFAULT, ...) - Patch G:
RTLD_GLOBALunix lib loading — makes macdrv symbols visible to dynamically loaded libraries
client_cocoa_viewstruct compatibility for DXMT swapchain creation- All
CX_references renamed toMS_— zero CrossOver code
Single All-in-One Runtime Bundle
metalsharp_bundle.tar.zst(899MB) contains everything: Wine 11.5 runtime, DXVK 1.10.3, Mono x86 + arm64, SteamSetup.exe- Replaces the old 5-file bundle set (wine, dxvk, mono-x86, mono-arm64, SteamSetup.exe)
- One-step extraction during install
New Launch Pipelines
Engine::DxmtMetal— 64-bit games route to DXMT Metal withdxgi,d3d11,d3d10core=n,bEngine::Wined3d32— 32-bit games use WineD3D OpenGL (no 32-bit Metal API on macOS)
Steam CEF Fixes
-cef-single-processflag prevents CEF rendering crashesMS_FWD_COMPAT_GL_CTX=1enables GL context creation for Steam web helperdeploy_steamwebhelper_wrapper()prevents GPU-related CEF crashes
Confirmed Working Games
| Game | Pipeline | Notes |
|---|---|---|
| Rain World | DXMT Metal | 64-bit, Feature Level 11_1, Apple M4 — no GPTK |
| Nidhogg 2 | WineD3D OpenGL | 32-bit D3D11 via WineD3D |
| Steam Client | MetalSharp Wine | CEF rendering working with patches |
| Undertale | MetalSharp Wine | wined3d |
| Among Us | Steam DRM + D3DMetal | Via Steam launch |
| Resident Evil 4 | Steam DRM + D3DMetal | Via Steam launch |
How the GPTK Dependency Was Eliminated
Four changes removed the need for Apple's Game Porting Toolkit for 64-bit games:
winebuild --builtin— DXMT PE DLLs registered as Wine builtins, loaded without override mechanismmacdrv_functionsexport — Wine macdrv function pointers exported viadlsym-visible structRTLD_GLOBALin ntdll loader — Wine'sdlopen_dll()usesRTLD_NOW | RTLD_GLOBALso unix libs can see each other's symbolsclient_cocoa_viewstruct — Wine window data includes the NSView pointer DXMT needs for Metal layer creation
System Requirements
- macOS 14+ (Apple Silicon recommended)
- Rosetta 2 (auto-installed)
- ~1.5 GB free disk space for runtime extraction
Installation
Download the DMG, drag MetalSharp to Applications, launch. The setup wizard handles dependency installation and Steam setup.
Known Issues
- DXVK 32-bit: All D3D feature levels return 0 through Wine's Vulkan WoW64 thunks — 32-bit games needing DXVK won't work yet
- Steam auto-updates overwrite the steamwebhelper wrapper — re-deploy after updates
__wine_unix_callabort appears in Steam log — non-fatal, Steam renders fine
Full Changelog: v0.16.0...v0.17.0
Full Changelog: v0.16.0...v0.17.0
Full Changelog: v0.16.0...v0.17.0