Repository navigation
v0.45.5
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 -uon 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 thestart_protected_game.exewrapper. -
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 aSystem.Nativestub for Mono 6.12 x86 compatibility and a dedicatedceleste-x86-mono.configdllmap. -
Half-Life 2 M9 routing rule
Added explicit M9 routing that prefers the root-levelhl2.exeinstead ofbin/tool executables. -
Auto-detect newly installed Steam games
MetalSharp now watches the Wine Steamsteamappsdirectory 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 inlibraryfolders.vdfautomatically. -
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=1on 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 automaticsteam_interfaces.txtgeneration.
Fixes
Migration & Prefix Health
- Migration now runs
wineboot -uon 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
.crashmarkers 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.configterraria-mono.configstardew-mono.configgeneric-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_CONFIGfiles that break dllmap resolution. - Corrected SDL3 references to SDL2 across installer, setup, and tests.
Audio & Input
- Rewrote
CoreAudioBackendwith a lock-free ring buffer to eliminate audio crackling and buffer underruns. - Fixed
formatFrozeninitialization and usage in the audio path. - Reworked
GameControllerBridgewith PlayStation controller support and improved button/axis mapping. - Fixed
shell32dllmap 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