Updated: 2026-07-08
Use this page as the repo map before changing launch/runtime code.
- How to Use MetalSharp - install, launch, diagnose, and update flow.
- Install from Source - build MetalSharp from source without the DMG.
- How to Build MetalSharp Wine - Wine 11.17 source prerequisites, tools, dependencies, and WoW64 build commands.
- GPTK (D3DMetal) Guide - Homebrew GPTK setup, D3DMetal bottle actions, prefix seeding, and troubleshooting.
- Supported Games - current working/blocked game evidence and recommended public routes.
- Proof Targets - local evidence targets and runtime proof notes.
- Runtime Bundles and Steam Routing - bundle provenance, wrapper deployment, and the correct Wine Steam route.
- Mono Runtime Lanes - Mono/FNA/XNA route boundaries and native Mono lane details.
- Wine Architecture - Wine prefix/runtime layout and wrapper behavior.
- Launcher Runtime - Sharp Library launcher and CEF/WebView runtime handling.
- Compatdata Architecture - Steam game compatdata ownership.
- Host Runtime ABI - host shim ABI boundaries.
- Redistributable Runtime - redistributable source and repair policy.
- Steam Compatibility Tool Surface - Steam-facing compatibility contract.
- Vendor Trust Kit - vendor runtime evidence and trust boundaries.
- Host Shim Inventory - current host/runtime shim inventory.
- Darwin Sync Map - macOS runtime sync notes.
- Launch Architecture - pipeline selection and launch ownership.
- D3D12 Pipeline Map - current M12 D3D12/DXMT path.
- D3D10 Pipeline Map - current M10 D3D10/DXMT path.
- D3D9 Pipeline Map - current M9 D3D9 route.
- DXMT and Vulkan Architecture - DXMT/M9-M12 boundaries and Vulkan fallback boundaries.
- D3D12 Developer Runtime Package - self-contained developer SDK tarball layout and publish flow.
These files are planning history and should not be treated as the current implementation contract without checking the code and runtime manifests first. Archived roadmaps have moved to docs/archive/roadmaps/.
- DXMT Proton-Parity Roadmap
- Installer Runtime Roadmap
- Anti-Cheat Hard Route Roadmap
- D3D12 Offline ABI Surface Matrix
- D3D12 Offline Cache Preflight
- D3D12 Offline Gate Results
See archive README for the full list. Do not cite archived roadmaps as current contracts.
- Release assets live on the
bundlesGitHub release. - Manifest-tracked hashes live in tools/bundles/asset-manifest.tsv.
- GPTK/D3DMetal is not a MetalSharp bundle asset. D3DMetal uses Homebrew GPTK at
/Applications/Game Porting Toolkit.appand seeds matched route DLLs into~/.metalsharp/prefix-gptkwhen a D3DMetal bottle is prepared. - Verify local and remote bundle state with:
tools/bundles/verify-bundles.sh --release
tools/bundles/verify-bundles.sh --require mac