Skip to content

GeneralsX - Beta 1

Choose a tag to compare

View all tags
@fbraz3 fbraz3 released this 28 Mar 00:49
· 165 commits to main since this release
GeneralsX-Beta-1
73daf98
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

This is a beta release. Some bugs are still expected. If you run into any problems, please open an issue so we can investigate.

Changelog

  • 🎯 Synced with the latest updates from TheSuperHackers repository.
  • 🎯 Improved camera height for widescreen resolutions.
  • 🐧 Fixed skirmish mode on Linux.
  • 🍎 Added a macOS app bundle.

How to Run

Prerequisites

  1. You must own a legitimate copy of the game. We build and test against the Steam version. Other retail releases may work, but are not officially supported.
  2. Copy the game data from your existing installation (for example, from C:\Program Files (x86)\Steam\steamapps\common\Command & Conquer Generals - Zero Hour) to a local folder on your Linux or macOS system. A recommended layout is:
    • $HOME/GeneralsX/Generals for Command & Conquer: Generals
    • $HOME/GeneralsX/GeneralsMD for Command & Conquer: Generals – Zero Hour

Linux

  1. Download the Linux archive from this release.
  2. Extract all files into your Zero Hour directory (for example, $HOME/GeneralsX/GeneralsMD). Overwrite existing files if prompted.
  3. Some dependencies (such as DXVK) require specific environment variables. The easiest way to launch the game is to run the provided run.sh script from a terminal.

macOS

  1. Download the macOS .zip file from this release.
  2. Extract the .zip and copy the app bundle into your Applications folder.
  3. Make sure your game assets are placed in the following locations:
    • $HOME/GeneralsX/Generals for Generals
    • $HOME/GeneralsX/GeneralsMD for Zero Hour
  4. Because the app is not code-signed, macOS Gatekeeper will initially block it. After the first launch attempt, go to System Settings → Privacy & Security and allow the application to run.

Requirements

GeneralsX has been developed and tested primarily on the following environments:

  • Ubuntu 24.04 LTS (x86_64)
  • macOS 15 "Tahoe" on Apple Silicon (M1 / ARM64)

Other Linux distributions or macOS versions may work, but you may need to install additional dependencies manually. On some systems, certain libraries might need to be built from source.

Tested Platforms

Current development and test matrix:

Platform Architecture Status
Ubuntu 24.04 LTS x86_64 Working
macOS 15 "Tahoe" ARM64 (Apple Silicon) Working

Support for other platforms and configurations is possible but not yet officially tested.

Known Issues

Multiplayer

  • LAN play has not been tested and is likely broken.
  • Online features are not implemented and are only planned for the distant future.

Linux

  • Skirmish games currently result in an instant win as soon as the match starts, so this mode is not yet playable.
    • Campaign and Generals Challenge modes are working.
  • [Zero Hour] Building and unit shadows do not render correctly. This is a visual issue only and does not affect gameplay logic.
  • Stealth units and GLA stealth buildings are visible as normal units/buildings instead of being hidden.
  • The sound system is mostly functional, but there are issues with long voice lines and some sound effects cutting out or not playing correctly.
  • There may be additional issues that have not yet been identified.

macOS

All items listed in the Linux section apply, except:

  • All single-player modes, including Skirmish, Campaign, and Generals Challenge, are currently working on macOS.

Reporting Bugs

If you encounter problems while running the game, please open an issue and include as much detail as possible, such as:

  • Operating system and version
  • CPU architecture (x86_64 / ARM64)
  • Steps to reproduce the issue
  • Logs or terminal output (if available)

This information greatly helps us reproduce and fix issues.

Contributing

Contributions of all sizes are welcome.

If you are interested in helping with development, bug fixes, testing on additional platforms, or improving compatibility, feel free to open a pull request or start a discussion in the repository.

Even small contributions—such as testing, documentation improvements, or well-documented bug reports—are very valuable.

Credits

This project exists thanks to the Command & Conquer community and the many tools created around the game over the years.

Special thanks to everyone who has contributed time to testing, debugging, and development.

Assets 6
Loading