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

What's New

🎮 Smooth 60 FPS & Beyond!

• Uncapped / 60 FPS Default: Both C&C Generals and Zero Hour now run at a smooth default of 60 FPS for rendering, resolving previous issues where the frame rate limiter was bypassed.
• Skirmish Frame Rates: In skirmish matches, you can now enjoy 60 FPS gameplay, or even uncap the frame rate entirely by adjusting the "Game Speed" slider.

🌐 Multiplatform LAN Support (Alpha)

• Cross-Play Success: Verified stable multiplatform LAN matches between macOS (Apple Silicon M1) and Linux (Ubuntu 26.04) for over 10 minutes of continuous play with zero disconnects or CRC mismatches!
• ⚠️ Important Limitation: Players currently do not auto-discover or appear automatically in the LAN lobby list. To connect and play, you must use the Direct Connect / IP Join feature by entering the host's IP address. (We are actively working on resolving lobby auto-discovery).

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

Changelog

• feat(framepacer): decouple logic from render fps and default to 60 fps by @fbraz3 in #172
• ci(github-actions): split replay tests into workflow_run to fix secrets access on external PRs by @fbraz3 in #173
• ci(github-actions): implement ccache, Vulkan SDK, and Flatpak runtime caching by @fbraz3 in #174
• ci(replay-tests): fallback to github if gitlab assets clone fails by @fbraz3 in #175
• fix(linux): Resolve black infantry textures and update build scripts by @fbraz3 in #178
• chore(sync): sync upstream TheSuperHackers/main by @fbraz3 in #179
• SagePatch: pin target to C++17 so macOS builds by @mohamedelabbas1996 in #180
• chore(network): disable retail compatibility, move legacy submodules, and update docs by @fbraz3 in #181

Full Changelog: GeneralsX-Beta-11...GeneralsX-Beta-12

❤️ Acknowledgements

A huge thank you to @x64-dev —his work on the GeneralsOnline project served as the inspiration for many of the networking enhancements and socket fixes integrated into this release.

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

What's New

• Generals base game is now fully playable - no more visual bugs or fps issues
• Audio changed from OpenAL to Miniaudio - thanks to @feliwir for providing the core library
• Fixed audio controls in options menu
• Fixed unit group binding - command + number on mac or ctrl + number on Linux.

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

Changelog

• feat(audio): add MiniAudio backend as alternative to OpenAL+FFmpeg by @fbraz3 and @feliwir in #159
• cleanup: remove GX-ISSUE144 diagnostic logging by @fbraz3 in #160
• chore: sync with thesuperhackers/main upstream by @fbraz3 in #162
• fix(input): resolve macOS group binding issue and SagePatch snap conflict by @fbraz3 in #164
• fix(shadows): fix fog of war, black infantry, and building shadows by @fbraz3 in #165
• bugfix(macos): Invert the SDL3 mouse wheel reported as SDL_MOUSEWHEEL_FLIPPED by @msmesoft in #168
• fix(graphics): correct skinned mesh rendering black on macOS by @fbraz3 in #169
• merge: sync thesuperhackers upstream (06-19-2026) by @fbraz3 in #170
• fix(audio): sound volume initialization & MiniAudio doc updates by @fbraz3 in #171

Full Changelog: GeneralsX-Beta-10...GeneralsX-Beta-11

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

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

What's Changed

• fix(ci-replay): restore replay result reports and stabilize Linux headless CI by @fbraz3 in #142
• fix(issue-144): macOS Cyrillic text fix by @fbraz3 in #153 - Thanks @w1semannn for reporting and tests
• [sync] TheSuperHackers upstream sync 06-05-2026 by @fbraz3 in #155
• feat(sagepatch): casual QoL patch for macOS + Linux + user-config-dir (Phase 1.5) by @ebellumat and @fbraz3 in #156
• Update correct app id for C&C Generals GETTING_THE_GAME_FILES.md by @iptelephony in #157
• merge: sync with TheSuperHackers upstream - 2026-06-08 by @fbraz3 in #158

Full Changelog: GeneralsX-Beta-9-patch-1...GeneralsX-Beta-10

Important: This release fixes the crash issue present in Beta 9 that occurred after the title screen on Linux and macOS. If you are currently using Beta 9, please upgrade to this release.

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

Project status and next steps

This release mainly ports stability fixes from TheSuperHackers.

Single-player is now in a very stable state, so my main focus will shift toward improving LAN multiplayer support. This will be a challenging task since I have limited hardware available for testing, so future releases may be less frequent than they have been over the past few months.

Stability improvements and bug fixes will continue to be addressed as they are discovered. If you encounter any issues, please open an issue on GitHub with as much detail as possible. Your feedback is essential to help improve the project.

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

What's Changed

• fix(ci-replay): restore replay result reports and stabilize Linux headless CI by @fbraz3 in #142
• CI: optimize to macOS + Flatpak only, Linux replay in Flatpak by @fbraz3 in #143
• chore(sync): merge thesuperhackers main 2026-05-21 by @fbraz3 in #146
• merge: sync TheSuperHackers main into GeneralsX (2026-05-28) by @fbraz3 in #148
• Fixing TheSuperHackers syncing issues by @fbraz3 in #152

Full Changelog: GeneralsX-Beta-8...GeneralsX-Beta-9-patch-1

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

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

What's Changed

• ci(workflows): upgrade actions for node24 by @fbraz3 in #130
• fix(audio-openal): advance Attack/Sound/Decay portions on sample completion by @fbraz3 in #134
• fix(dx8wrapper): restore macOS transparency in pillarbox path by @fbraz3 in #135
• fix(linux-filesystem): resolve asset-root case mismatches by @fbraz3 in #137
• docs(build): clarify linux proton install behavior by @fbraz3 in #138
• chore(generals-parity): complete wave 1-5 code parity baseline by @fbraz3 in #139
• merge(sync): import TheSuperHackers upstream into GeneralsX (2026-05-15) by @fbraz3 in #141

Full Changelog: GeneralsX-Beta-7...GeneralsX-Beta-8

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

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

What's Changed

• fix(macos-build): detect vcpkg root automatically by @fbraz3 in #122
• docs: add windows platform parameter to steamCMD by @rafikt1992 in #123
• fix(replay): headless replay compatibility by @fbraz3 in #124
• ci(replay-tests): add per-platform headless replay regression tests by @fbraz3 in #125
• Fix update checker release guard without GitTag by @fbraz3 in #126
• Sync upstream TheSuperHackers (2026-05-07) preserving GeneralsX cross-platform architecture by @fbraz3 in #127

Full Changelog: GeneralsX-Beta-6...GeneralsX-Beta-7

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

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions (copy from Windows, CrossOver trial, or SteamCMD).

What's Changed

• docs(instructions): revise generalsx guide for active release state by @fbraz3 in #105
• docs: add getting game files guide and rename install doc by @fbraz3 in #107
• docs(wiki): update devin wiki.json to reflect active release state by @fbraz3 in #108
• fix(audio-openal): restore narrator speech streams by @fbraz3 in #111
• fix(graphics): stabilize macOS fullscreen scaling pipeline by @fbraz3 in #112
• fix(network): correct LAN frame pacing unit mismatch on Linux by @fbraz3 in #113
• fix(map-cache): support custom map paths and names by @fbraz3 in #114
• chore(sync): merge TheSuperHackers upstream on 2026-04-28 by @fbraz3 in #115
• fix(graphics): harden macOS fullscreen focus lock by @fbraz3 in #116
• fix(sdl3-cursor): use SDL_CreateAnimatedCursor by @fbraz3 in #117

Full Changelog: GeneralsX-Beta-5...GeneralsX-Beta-6

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

Getting Started

Install the engine: Follow the Installation Guide to set up GeneralsX on your platform.

Don't have the game files? Steam does not offer a macOS or Linux download for this title. See Getting the Game Files for step-by-step instructions.

What's Changed

• fix: Cross-platform wide string formatting for replay/UI text truncation by @fbraz3 in #94
• fix(overlord-contain): restore Overlord upgrades on POSIX port (macOS/Linux) by @fbraz3 in #96
• feat(update-checker): add in-game update notification via GitHub Releases API by @fbraz3 in #98
• ci(workflows): consolidate build and release workflows by @fbraz3 in #99
• fix(audio-openal): restore briefing video audio by @fbraz3 in #100
• [sync] TheSuperHackers upstream sync 2026-04-23 by @fbraz3 in #101

Full Changelog: GeneralsX-Beta-4...GeneralsX-Beta-5

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

Install Instructions

https://github.com/fbraz3/GeneralsX/blob/main/docs/BUILD/INSTALL_INSTRUCTIONS.md

What's Changed

• bugfix(linux): Fix Wayland fullscreen by using SDL3 native fullscreen API by @xorza in #89
• build(cmake): Detect libpng portably across Linux distros by @xorza in #90
• fix(flatpak-linux): migrate release pipeline to flatpak by @fbraz3 in #91
• feature: Pillarbox for ultrawide monitors and resizable windows by @xorza in #92
• sync: merge TheSuperHackers main and fix macOS build regressions by @fbraz3 in #93

Full Changelog: GeneralsX-Beta-3...GeneralsX-Beta-4

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

Install Instructions

https://github.com/fbraz3/GeneralsX/blob/main/docs/BUILD/INSTALL_INSTRUCTIONS.md

What's Changed

• Moved OpenAL code into Core shared code folder. by @DMJC in #68
• feat(release): automated GitHub Actions release pipeline by @fbraz3 in #76
• chore(merge): sync TheSuperHackers upstream into GeneralsX by @fbraz3 in #77
• feat(release): automated release pipeline v2 with build orchestration and structured notes by @fbraz3 in #78
• chore(dxvk-macos): align docs with pinned fork flow by @fbraz3 in #79
• build(ci): default Linux pipeline to AppImage artifacts by @fbraz3 in #81
• Sync TheSuperHackers upstream (2026-04-10) - DX8/WW3D2 conflict resolution by @fbraz3 in #82
• fix: animated shadow rendering in Zero Hour (#15) by @fbraz3 in #83
• sync: merge TheSuperHackers main (04-11-2026) by @fbraz3 in #85

Full Changelog: GeneralsX-Beta-2...GeneralsX-Beta-3