Worms W.M.D - macOS Tahoe (26.x) Fix

Fix the black screen on macOS 26 (Tahoe) and later by restoring AGL compatibility and replacing the bundled Qt frameworks. The repo also includes tools for diagnostics, backups, and updates.

Quick start

Option 1: Double-click installer

1. Download Install Fix.command.
2. Double-click the file.
3. If macOS blocks it, right-click → Open → Open again.
4. If you see "Insufficient Privileges", run: chmod +x ~/Downloads/Install\ Fix.command
5. If it still won't run, see Troubleshooting.

Option 2: One-liner (Terminal)

curl -fsSL https://raw.githubusercontent.com/cboyd0319/WormsWMD-macOS-Fix/main/install.sh | bash

Requires git (install Xcode Command Line Tools if missing).

Option 3: Manual / advanced

See docs/INSTALL.md for manual install, dry-run, and restore steps.

Requirements

• Target: macOS 26 (Tahoe) or later (earlier macOS versions typically don't need the fix)
• Worms W.M.D installed via Steam or GOG
• Internet connection
• git (installed by Xcode Command Line Tools)

The script can prompt to install these if needed (you may see system prompts):

• Rosetta 2 (Apple Silicon)
• Xcode Command Line Tools
• Qt frameworks (downloaded from GitHub; Homebrew fallback)

What the fix does

• Adds an AGL stub framework so the game launches on macOS 26+.
• Replaces Qt 5.3.2 with Qt 5.15.
• Bundles required dependencies and fixes install names.
• Updates Info.plist (bundle ID, HiDPI support, minimum version).
• Fixes known HTTP URLs in DataOSX/CommonData config files.
• Comments out internal/staging URLs in DataOSX config files.
• Clears quarantine flags and applies ad-hoc signing.
• Resets incompatible Qt window geometry to fix small window issues.

Pre-flight check

Before launching, you can verify your system is ready:

./tools/preflight_check.sh

This checks:

• macOS version and architecture
• Rosetta 2 status (Apple Silicon)
• Game installation and fix status
• Runtime dependencies
• Network connectivity to Team17 and Steam endpoints

Use --quick to skip network checks, or --verbose for detailed output.

Documentation

• What this fix improves - All fixes and enhancements explained
• Installation - Manual install and restore options
• Troubleshooting - Solutions for common problems
• FAQ - Frequently asked questions
• Tools - Helper utilities reference
• Technical details - How the fix works
• Security - Security information
• Contributing - How to contribute
• Changelog - Version history
• Team17 Developer Report - Technical report for Team17

Support

• Issues: https://github.com/cboyd0319/WormsWMD-macOS-Fix/issues

Credits

• Steam community for reporting the issue
• Qt Project for Qt 5.15
• Fix developed with assistance from Claude

Links

• Worms W.M.D on Steam

Steam discussion threads about this issue:

• Can't open on macOS Tahoe M2
• Black screen on Mac Pro 2019 16
• Black screen on macOS