Skip to content

TeamIDE/SurrounDead-on-macOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SurrounDead-on-macOS

Run SurrounDead (Windows-only UE5/DX12, Steam App ID 1645820) on Apple Silicon Mac using only free tools. Confirmed working on M4 MacBook Air, macOS 15 Sequoia.

Quick Start

# 1. Mount "Evaluation environment for Windows games 3.0" DMG from developer.apple.com/games
# 2. Run:
./setup.sh your_steam_username

That's it. The script handles Rosetta, Wine, D3DMetal 3.0, game download, and Engine.ini.

To launch with PS4 controller:

./launch-mac.sh -ps4

What's in This Repo

File Purpose
setup.sh One-command automated setup
launch-mac.sh Game launch script (generated by setup.sh with correct paths)
Engine.ini UE5 render overrides — disables Nanite, Lumen, ray tracing
controller.py PS4/DS4 controller → keyboard/mouse mapper
SETUP.md Full manual setup guide with explanations

How It Works

UE5 DX12 games go black on macOS because the CombineLUTs shader uses geometry shaders that D3DMetal 2.x can't handle. The fix is D3DMetal 3.0 from Apple's GPTK 3.0 Evaluation Environment, layered on top of a Wine build from the GCenX Homebrew cask. Everything is free.

PS4 Controller

Wine doesn't pass controller input to the game. controller.py reads the DS4 directly via Bluetooth HID and maps inputs to keyboard/mouse events at the OS level.

DYLD_LIBRARY_PATH=/opt/homebrew/lib python3 ~/SurrounDead/controller.py &

Grant Accessibility and Bluetooth permissions to Terminal/Python when macOS prompts.

See SETUP.md for the full button layout and manual setup instructions.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors