🧾 Version Helper Macros

Short Description

Helper macros for conditional compilation based on the engine major/minor version.

Long Description

These macros encode the engine version into a single numeric value and provide convenient guards to include or exclude code for particular Unreal Engine releases (e.g. 5.1, 5.2). They also offer _SWITCH and _ONLY forms to select between implementations when the engine version matches or differs.

⚙️ How it works

  • GORGEOUS_ENGINE_VERSION computes (ENGINE_MAJOR_VERSION * 100 + ENGINE_MINOR_VERSION).
  • _HIGHER macros expand to their arguments only when the engine is at or above the respective version.
  • _LOWER macros expand when the engine is below the respective version.
  • _SWITCH(Before, AfterEqual) selects AfterEqual when the engine is >= target, otherwise Before.
  • _ONLY(...) expands only for the exact version range.

🚀 Common macros

  • GORGEOUS_ENGINE_VERSION
  • GORGEOUS_23_HIGHER, GORGEOUS_24_HIGHER, ..., GORGEOUS_56_HIGHER
  • GORGEOUS_51_LOWER, GORGEOUS_52_LOWER, ...
  • GORGEOUS_51_SWITCH(Before, AfterEqual), GORGEOUS_51_ONLY(...), etc.

📚 Usage Examples

// Include UE 5.2-only code
GORGEOUS_52_HIGHER(
    // code compiled when engine >= 5.2
)


// Choose between two implementations depending on the engine
GORGEOUS_53_SWITCH(
    // fallback for older engines
    LegacyImplementation();,
    // implementation used for 5.3 and newer
    ModernImplementation();
)
    ```

Notes

  • The macros are implemented in terms of engine-provided ENGINE_MAJOR_VERSION and ENGINE_MINOR_VERSION. They are intentionally conservative when supporting older engine branches.
  • Some type aliases (e.g. TObjectPtr) are also conditionally defined using these macros to normalize API differences across versions.

Where to find the header

src/content/gorgeous-core/RuntimeUtilities/Helpers/Headers/Macros/GorgeousVersionHelperMacros.h