Skip to content
 
 

Latest commit

 

History

2,821 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GeneralsX Logo

GeneralsX

Play Command & Conquer: Generals & Zero Hour on macOS, Linux, and Windows — with native cross-platform online multiplayer.

GitHub Release Project Wiki GeneralsX CI Ask DeepWiki


GeneralsX lets you run Command & Conquer: Generals and Zero Hour natively on macOS, Linux, and Windows. Built on a modern open-source engine stack, it brings back smooth gameplay, seamless cross-platform online multiplayer, and full compatibility with original campaigns, mods, and replays on modern computers.

✨ Highlights

  • 🌐 Cross-Play Online Multiplayer: Native online matchmaking and lobbies powered by GeneralsOnline (NGMP). Play seamlessly across macOS, Linux, and Windows without GameSpy, Hamachi, or VLAN tools.
  • 💻 Native Modern Performance: Runs natively on macOS (Apple Silicon), Linux (x86_64), and Windows. No legacy 32-bit baggage.
  • 🌋 Modern Graphics: Replaces the ancient DirectX 8 backend with Vulkan translation via DXVK for smooth performance on modern monitors and GPUs.
  • 🔊 Updated Audio & Video: Crystal-clear cross-platform audio powered by MiniAudio and full video cinematics support via FFmpeg.
  • 🎯 100% Retail Compatibility: Full support for original singleplayer campaigns, Skirmish vs AI, replays, and community mods.
  • 📦 Generals & Zero Hour: Play both the base game and the expansion from a unified, modern codebase.

🚀 Getting Started

Download & Play

Ready-to-run releases are available for macOS, Linux, and Windows:

Note: GeneralsX is an engine recreation and requires original game data files from a legitimate copy of Command & Conquer: Generals / Zero Hour (The First Decade, EA App, Steam, or retail CDs).

🌐 Cross-Platform Multiplayer

GeneralsX includes integrated multiplayer powered by GeneralsOnline. Players on macOS, Linux, and Windows can host, join lobbies, and battle against each other online with zero network configuration hurdles.

📂 Asset Paths & Launcher Workspaces

GeneralsX automatically resolves game assets from multiple sources, preferring complete local workspaces (e.g., GenHub profiles or portable setups) over the system registry. You can also specify asset paths explicitly:

  • Command-line: Pass -assetPath "<path>" (and -generalsAssetPath "<path>" for base Generals data in Zero Hour).
  • Environment variables: Set CNC_GENERALS_ZH_PATH and CNC_GENERALS_PATH.
  • Options.ini override: Add [Paths] with AssetPath = .\ and GeneralsAssetPath = .\ZH_Generals\.

See the Running from a Launcher or Portable Workspace Guide for complete details.


📱 Ecosystem & Community Ports

The flexibility and modern foundation of GeneralsX have enabled several community-driven ports across mobile and web platforms:


🛠️ Building from Source

GeneralsX uses CMake with predefined presets for supported platforms:

# macOS (Apple Silicon)
cmake --preset macos-vulkan
cmake --build build/macos-vulkan --target z_generals

# Linux (x86_64)
cmake --preset linux64-deploy
cmake --build build/linux64-deploy --target z_generals

For complete prerequisites, Docker workflows, and packaging guides, check the Wiki:


📜 Project Lineage & Credits

GeneralsX stands on the shoulders of the RTS community and open-source pioneers:

  • Westwood Studios & EA for creating the Command & Conquer: Generals universe.
  • TheSuperHackers for foundational code modernization, stability fixes, and upstream preservation.
  • Fighter19 & feliwir for early reference work pioneering SDL3, DXVK, and OpenAL in Zero Hour.

💖 Support & Contributing

  • Sponsor on GitHub – Help fund test hardware, server infrastructure, CI/CD pipelines, and active development.
  • Contributing Guide – Contributions are welcome! Check our issues and pull request guidelines before opening a PR.

🌟 Star History

Star History Chart

📄 License

See the LICENSE file for details.
EA has not endorsed and does not support this product. Command & Conquer is a trademark of Electronic Arts Inc.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages