Skip to content

v0.17.0

Choose a tag to compare

@github-actions github-actions released this 12 May 03:15
· 2292 commits to main since this release

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_functions struct export — allows DXMT to call Wine macdrv via dlsym(RTLD_DEFAULT, ...)
    • Patch G: RTLD_GLOBAL unix lib loading — makes macdrv symbols visible to dynamically loaded libraries
  • client_cocoa_view struct compatibility for DXMT swapchain creation
  • All CX_ references renamed to MS_ — 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 with dxgi,d3d11,d3d10core=n,b
  • Engine::Wined3d32 — 32-bit games use WineD3D OpenGL (no 32-bit Metal API on macOS)

Steam CEF Fixes

  • -cef-single-process flag prevents CEF rendering crashes
  • MS_FWD_COMPAT_GL_CTX=1 enables GL context creation for Steam web helper
  • deploy_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:

  1. winebuild --builtin — DXMT PE DLLs registered as Wine builtins, loaded without override mechanism
  2. macdrv_functions export — Wine macdrv function pointers exported via dlsym-visible struct
  3. RTLD_GLOBAL in ntdll loader — Wine's dlopen_dll() uses RTLD_NOW | RTLD_GLOBAL so unix libs can see each other's symbols
  4. client_cocoa_view struct — 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_call abort 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