Skip to content

v0.45.5

Choose a tag to compare

@github-actions github-actions released this 11 Jun 00:55
· 1371 commits to main since this release
8d6fbb0

MetalSharp v0.45.5

This release focuses on game launch reliability, Steam prefix repair, external library support, FNA/Mono compatibility, audio/input stability, and major runtime packaging fixes.

Highlights

  • Team Fortress 2 now launches through the M9/D3D9 DXMT route with proper Steam identity deployment.
  • Celeste now runs through native Mono with SDL2, FNA3D, and FMOD audio shims.
  • External Steam libraries on USB SSDs and other mounted drives are discovered automatically during migration.
  • Migration now runs wineboot -u on the Steam prefix, fixing stale DLL/runtime/registry state that could prevent games from launching.
  • M13 has been upgraded to Game Porting Toolkit 4.0 integration.

Features

  • TF2 secure launch via M9 pipeline
    Team Fortress 2 now launches through the M9/D3D9 DXMT route with proper Steam identity deployment, bypassing the start_protected_game.exe wrapper.

  • SDL2-native Celeste with FMOD audio
    Celeste now runs through native Mono with SDL2, FNA3D, and FMOD audio shims.

  • Mono/FNA compatibility for Celeste
    Added a System.Native stub for Mono 6.12 x86 compatibility and a dedicated celeste-x86-mono.config dllmap.

  • Half-Life 2 M9 routing rule
    Added explicit M9 routing that prefers the root-level hl2.exe instead of bin/ tool executables.

  • Auto-detect newly installed Steam games
    MetalSharp now watches the Wine Steam steamapps directory and refreshes the library when new games are installed.

  • FNA sub-components in bottle UI
    Bottle cards now show FNA-specific runtime components, including FAudio, FNA, FNA3D, Mono-arm64, SDL2, and XNA.

  • External Steam library support
    Games installed on external drives are auto-discovered during migration. Wine dosdevice drive letters are created and registered in libraryfolders.vdf automatically.

  • D3DMetal pipeline via GPTK 4.0
    The M13 route now uses Game Porting Toolkit 4.0 with async prefix seeding, VC++ redistributable install, and full bottle integration.

  • WINEMSYNC=1 on all Wine launch paths
    Mach semaphore synchronization is now enabled across Wine launch paths for improved performance and stability.

  • Goldberg Steam Emulator redeployment
    Goldberg Steam Emulator support has been redeployed for Source game compatibility, including automatic steam_interfaces.txt generation.

Fixes

Migration & Prefix Health

  • Migration now runs wineboot -u on the Steam prefix. Previous updates skipped this step, leaving DLLs, DXMT runtime files, and registry entries stale.
  • Wine and Steam processes are now cleaned up after prefix updates so stale windows do not carry into the app.
  • Steam .crash markers are cleared during migration to prevent silent launch failures.
  • Migration handoff is hardened with port-release waiting and version-aware restart behavior.
  • DMG mount targets are filtered from dosdevice symlink preservation so transient install media does not pollute the Wine prefix.

FNA / Mono

  • Mono dllmap configs now ship inside the app bundle:
    • celeste-x86-mono.config
    • terraria-mono.config
    • stardew-mono.config
    • generic-fna-mono.config
  • Fixed FNA/XNA crashes caused by Mono being unable to resolve System.Native, FNA3D, SDL2, or FMOD.
  • Added a guard so missing Mono config templates no longer produce blank MONO_CONFIG files that break dllmap resolution.
  • Corrected SDL3 references to SDL2 across installer, setup, and tests.

Audio & Input

  • Rewrote CoreAudioBackend with a lock-free ring buffer to eliminate audio crackling and buffer underruns.
  • Fixed formatFrozen initialization and usage in the audio path.
  • Reworked GameControllerBridge with PlayStation controller support and improved button/axis mapping.
  • Fixed shell32 dllmap behavior for Mono audio path resolution.

Runtime

  • Split VC++ 2015-2022 runtime handling into independent x64 and x86 components using direct Microsoft downloads.
  • Fixed GPTK Homebrew shell path resolution.
  • Improved GPTK prefix display names in the UI.
  • Depth-limited crash scanning to avoid triggering macOS TCC permission prompts.

UI

  • Updated setup wizard welcome text to accurately describe the runtime pipeline.
  • Fixed changelog modal close button layering by rendering it above the overlay.
  • Fixed grid cards stretching when neighboring cards expand.
  • Improved component labels used in repair actions.

CI

  • Updated CI to Node 22 for Electron 42 engine requirements.
  • Updated bundle verification for SDL2 paths.

Full Changelog

28 commits since v0.44.1.

Compare: v0.44.1...v0.45.5