merge: sync TheSuperHackers main into GeneralsX (2026-05-28)

[fbraz3]

Summary

• Merge thesuperhackers/main into GeneralsX sync branch.
• Resolve merge conflict in Core/GameEngine/Include/GameClient/ParticleSys.h preserving:
  • upstream RETAIL_COMPATIBLE_CRC behavior
  • GeneralsX headless-safe no-op particle update behavior
• Keep upstream improvements for replay/audio/water paths while preserving cross-platform architecture.

Conflict Resolution Highlights

• ParticleSystemManagerDummy composed with both upstream and GeneralsX intents.
• Accepted upstream replay headless path simplification.
• Accepted upstream MilesAudio request ownership flow updates.
• Accepted upstream river/water shader/shroud fixes.

Validation

• macOS configure: ✅
• macOS build z_generals: ✅ (warnings only)
• macOS build g_generals: ✅ (warnings only)
• Linux configure/build: ⚠️ partially attempted (long-running Docker/vcpkg bootstrap), full run still pending
• Runtime smoke (GeneralsXZH/GeneralsX main-loop enter/exit): ⚠️ pending

Follow-up Checklist

• Complete Linux Docker configure/build for both products
• Run runtime smoke for GeneralsXZH and GeneralsX
• Verify main menu/skirmish/campaign/audio/video/input/mod-loading paths
• Focused review on replay-headless, MilesAudio ownership, and water rendering deltas