Skip to content

fix(pharaoh): bypass unskippable intro video hang and configure D3DMetal - #2

Closed
RayAnd wants to merge 1 commit into
mainfrom
fix/pharaoh-startup-hang
Closed

RayAnd wants to merge 1 commit into
mainfrom
fix/pharaoh-startup-hang

Conversation

@RayAnd

@RayAnd RayAnd commented Nov 11, 2026

Copy link
Copy Markdown
Owner

Summary

Resolves #1.

Fixes the startup black-screen hang in Pharaoh: A New Era (1351080):

  • Root Cause: Unity 2019 uses Windows Media Foundation (WindowsVideoMedia) for its mandatory first-time opening cinematic. Under DXMT on macOS, IDXGIResource::GetSharedHandle returns null, entering an infinite error loop (Got null handle from IDXGIResource::GetSharedHandle line 1830) that hangs indefinitely while audio plays.
  • Fix 1 (pharaoh-intro-bypass): Automatically injects IsIntroAlreadyViewed=dword:00000001 into HKEY_CURRENT_USER\Software\Triskell Interactive\Pharaoh inside the Wine prefix before launch, bypassing the unskippable broken video playback cleanly into the Main Menu.
  • Fix 2 (D3DMetal): Configures Apple D3DMetal (GPTK) on Rosetta 2 with WINEMSYNC=1, d3dcompiler_47=n,b, and vcruntime140=n,b, delivering locked 60 FPS gameplay and native shared DXGI texture support.
  • Preset Catalog: Added a curated preset for 1351080 to GameProfileStore.swift and forceRosettaIDs.

Verification

  • make all && make test passes (all 3 C test suites and 13/13 Swift tests passed).
  • sh -n steam-bridge/engine/feats/compat_run.sh syntax verified.
  • Tested directly with game installation on external Game Drive: game skips broken video and boots immediately into the main menu at stable 60 FPS.

@RayAnd

RayAnd commented Nov 11, 2026

Copy link
Copy Markdown
Owner Author

Merged into main for v2.2.0 release

@RayAnd RayAnd closed this Nov 11, 2026
@RayAnd
RayAnd deleted the fix/pharaoh-startup-hang branch November 11, 2026 22:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Pharaoh: A New Era (1351080) hangs on startup with black screen (Unity IDXGIResource::GetSharedHandle)

1 participant