Skip to content

Releases: fbraz3/GeneralsX

GeneralsX POC - Release 1

11 Mar 03:33
@fbraz3 fbraz3
poc-release-1
98ab633

Choose a tag to compare

View all tags
GeneralsX POC - Release 1 Latest
Latest

This is a POC (Proof of Concept) release of Command & Conquer Generals: Zero Hour running on POSIX systems — Linux and macOS.

How to Run

  1. Install the game on Windows (or using Wine / CrossOver, etc) from Steam. The game may run with other retail installations, but this is not guaranteed.
  2. Copy the game contents (usually located at C:\Program Files (x86)\Steam\steamapps\common\Command & Conquer Generals - Zero Hour) to a local folder on your Linux/macOS system. In my environment, I use the path $HOME/GeneralsX/GeneralsMD.
  3. Download the release for your operating system and extract all files from the archive into your Zero Hour directory. Replace any existing files if prompted.
  4. Some dependencies, such as DXVK, require environment variables to be set. The easiest way to run the game is by executing the run.sh script from your terminal.

Requirements

GeneralsX was tested on the following development environments:

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

Other Linux distributions or macOS versions may also work, but additional dependencies might need to be installed manually. In some cases, certain libraries may need to be compiled from source depending on your system configuration.

Tested Platforms

Current development and testing environments:

Platform Architecture Status
Ubuntu 24.04 LTS x86_64 Working
macOS Tahoe ARM64 (Apple Silicon) Partially working

Support for other platforms is possible but not officially tested.

Known Issues

Linux

  • Skirmish games result in an instant win, so this mode is not playable yet.
  • Campaign and Generals Challenge are working.
  • Building and unit shadows are not rendering correctly, but this does not affect gameplay.
  • Stealth units appear as regular units, and the same happens with GLA stealth buildings.
  • The sound system works, but there are issues with long voice lines and some sound effects.
  • There may be additional issues that have not yet been identified.

macOS

Everything from the Linux section applies, plus:

  • Because the application is not code-signed, macOS Gatekeeper will block its execution. You will need to allow it manually under Settings → Privacy & Security for the GeneralsXZH executable and its libraries (approval may be required multiple times).
  • Terrain textures are not loading, which makes the game basically unplayable.

Reporting Bugs

If you encounter issues while running the game, please open an issue on the GitHub repository and include as much information 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 helps a lot when diagnosing problems.

Contributing

Contributions are welcome.

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

Even small contributions like testing, documentation improvements, or reporting bugs are greatly appreciated.

Roadmap

Planned improvements include:

  • Fix Skirmish mode
  • Improve shadow rendering
  • Fix stealth unit visibility
  • Improve sound system stability
  • Improve macOS compatibility
  • Initial Windows x64 build

Credits

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

Special thanks to everyone helping with testing, debugging, and development.

Assets 4
Loading