Skip to content

About

C&C Generals: Zero Hour on native Linux (Vulkan, SDL3, C++). Based on CnCGeneralsZH-Reforged; X11/Wayland measurements. GPL-3.0, bring your own game data.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

C&C Generals: Zero Hour на Linux (Vulkan / SDL3)

C&C Generals: Zero Hour нативно на Linux (Vulkan / SDL3) на основе CnCGeneralsZH-Reforged: сборка, замеры X11 vs Wayland, заметки по рендеру. Игровые файлы — свои.

Документация » · Сообщить об ошибке · Предложить улучшение · English

License Stars Last commit Issues

📑 Содержание

📖 О проекте

Нативный запуск легендарной RTS на Linux без Wine и Proton: ландшафт открытых проектов, модель распространения OpenRA (Bring-Your-Own-Assets) и инженерные заметки по оптимизации рендера.

Проверено на тестовой системе: Ubuntu 24.04 LTS, x86_64, NVIDIA GeForce RTX 3090 24 GB, X11 / Wayland.

Platform Renderer Model Hardware License: GPL-3.0

English Version


🗺️ Ландшафт открытых проектов

После того как Electronic Arts в 2025 году открыла исходный код Command & Conquer: Generals и дополнения Zero Hour под лицензией GPL v3 (с дополнительными условиями EA), сообщество развивает два ключевых проекта:

Проект Назначение Рендерер и платформы Ссылка
Zero Hour Reforged Канонический осовремененный движок: 64-бит, Direct3D 11 / Vulkan / Metal, умный AI, встроенный сетевой клиент, пакеты под Linux и macOS. Windows (D3D11), macOS (Metal + SDL3), Linux / Steam Deck (Vulkan + SDL3) olcayseygan/CnCGeneralsZH-Reforged
Generals Game Code Общественный проект модернизации и очистки кодовой базы C++20, поддержка Visual Studio 2022 и кроссплатформенной сборки (Docker). Windows, Linux (сборка/инструменты) TheSuperHackers/GeneralsGameCode
Этот репозиторий Инженерный навигатор по нативному запуску на Linux: профилирование узких мест, замеры в сессиях X11 и Wayland, анализ производительности и предложения в апстрим. Рабочее дерево Linux-порта на основе Reforged (код и история апстрима) + замеры и заметки Bezooom/CnCGeneralsZH-Linux

📦 Модель распространения (как у OpenRA)

В играх с открытым движком (OpenRA, fheroes2, GZDoom, DXX-Rebirth) действует строгое разделение между кодом и ассетами:

  1. Исходный код движка открыт под лицензией GPL v3. Его можно свободно собирать, модифицировать и распространять.
  2. Игровые ресурсы (.big-архивы, текстуры, 3D-модели, звуки, музыка, карты и ролики) защищены авторским правом Electronic Arts. Репозиторий не содержит проприетарных файлов игры.
  3. Модель «Bring Your Own Game» (BYOG):
    • Игрок легально приобретает копию игры (например, Command & Conquer: The Ultimate Collection в Steam или EA App, либо использует оригинальные диски).
    • Пакет игры (Flatpak/Flathub, AppImage, .deb) устанавливает только скомпилированный бинарный файл движка.
    • При первом запуске движок находит папку с игрой автоматически через библиотеки Steam (~/.local/share/Steam/steamapps/common/...) либо предлагает выбрать каталог с Zero Hour вручную.
    • Оригинальные .big-файлы монтируются исключительно для чтения.

🔬 Инженерные заметки: замеры и оптимизации

В ходе локального профилирования рендера Command & Conquer Generals Zero Hour на тестовом стенде (Ubuntu 24.04, NVIDIA GeForce RTX 3090 24 GB) были изолированы ключевые факторы производительности:

1. Задержка презентации: Wayland и X11

При запуске клиента в сессии Wayland через прослойку XWayland зафиксирована существенная задержка передачи кадров:

Метрика Сессия Wayland (XWayland) Чистая сессия X11 Разница
Время кадра (total) ~78–135 мс 11.1 мс Ускорение в 7–12 раз
Задержка vkQueuePresentKHR 40–62 мс 0.05 мс (47–52 мкс) Снижение задержки в 800 раз
CPU draw-путь 13–52 мс 8.6 мс Быстрее в 2–6 раз
Частота кадров в HUD 7–13 FPS 20 FPS (время кадра 11.1 мс) Плавный отклик

Вывод: в сессии Wayland замеренная задержка презентации стабильно составляла 40–62 мс, тогда как в X11 падала до 0.05 мс (наиболее вероятная причина – накладные расходы очередей XWayland-композитора). Для максимальной производительности на текущем этапе рекомендуется запуск в сессии X11.


2. Отсечение тайлов рельефа по пирамиде видимости (Frustum Culling)

В цикле отрисовки рельефа тайлы карты перебирались целиком на каждом шейдерном проходе без предварительной проверки видимости камерой:

Параметр Без отсечения С отсечением AABB по Cull_Box Эффект
Вызовов отрисовки на кадр 1380 → 771 432 Минус 948 вызовов
Вызовов рельефа (catTerrain) 624 → 508 172 Сокращение на 72%
Время CPU на draw 52 мс 14.6 мс Экономия 37 мс на кадр
Время кадра 134 мс 81 мс (Wayland) / 11 мс (X11) Чистая прибавка производительности

Решение: проверка ограничивающего параллелепипеда тайла рельефа (с полным диапазоном высот карты) через CameraClass::Cull_Box() в базовом цикле и в дополнительных проходах. Экспериментальный патч отсечения тайлов рельефа по камере (описан ниже в предложениях для апстрима).


3. Батчинг двумерного интерфейса по страницам текстурных атласов

Оригинальный интерфейс сбрасывал двумерный рендер при каждой смене объекта изображения:

  • Оптимизация same2DTexture(): батч остаётся открытым для разных объектов Image, если они используют один и тот же файл текстуры (одинаковую страницу атласа).
  • Охват winRepaint(): проход отрисовки всех окон держится в едином батче, исключая холостые переключения состояний между кнопками и глифами шрифтов.
  • Сокращение вызовов: с 1380 до 885 вызовов на кадр в тестовой сцене.

4. Исправление заливки цветом игрока («цветофильтр» на карте)

  • Симптом: Рельеф в игре заливался прямоугольной цветной дымкой (красной у Китая, синей у США, фиолетовой у GLA).
  • Причина: Функция W3DScene::renderStenciledPlayerColor() рисует полноэкранный квад в цвете локального игрока и маскирует его трафаретным буфером (stencil) поверх перекрытых объектов. В Vulkan-пайплайне трафаретный тест не был сконфигурирован, в результате чего квад рисовался без маски на весь тактический вид.
  • Решение: Вызов DX8Wrapper::Has_Stencil() на Linux возвращает false, что направляет движок по штатному нетрафаретному пути flushOccludedObjects().

5. Полноцветная миникарта и 24-битные поверхности

  • Симптом: Чёрная миникарта у США при старте матча.
  • Причина: Выбор формата текстуры радара предпочитал 24-битный R8G8B8 (3 байта на пиксель), тогда как функция SurfaceClass::Draw_Pixel() обрабатывала только 1, 2 и 4 байта (запись пикселей рельефа была пустым действием).
  • Решение: Добавление 3-байтового регистратора BGR в Draw_Pixel() и приоритизация 32-битного формата X8R8G8B8 в списке форматов радара.

🧱 Технологии (Built With)

C++ Vulkan SDL CMake Linux

🚀 Как запустить игру на Linux

Вариант 1. Готовые пакеты из апстрима Reforged (рекомендуется)

  1. Установите оригинальную игру в Steam (Command & Conquer: The Ultimate Collection).
  2. Скачайте свежий релиз из репозитория Reforged (доступны AppImage, Flatpak, .deb, .rpm, Arch).
  3. При запуске укажите путь к каталогу с файлами игры (или позвольте движку найти библиотеку Steam автоматически).
  4. Рекомендация по сессии: выбирайте сессию «GNOME on Xorg» / X11 на экране входа для минимальной задержки презентации.

Вариант 2. Сборка из исходников

# Клонирование канонического апстрима с Vulkan/SDL3 бэкендом
git clone https://github.com/olcayseygan/CnCGeneralsZH-Reforged.git
cd CnCGeneralsZH-Reforged

# Сборка на Linux
./build-linux.sh Release generals

🤝 Взаимодействие с апстримом (Upstream Collaboration)

Наблюдения и оптимизации передаются в канонический репозиторий Reforged:

  • Terrain tile frustum culling: отсечение невидимых тайлов рельефа в HeightMap.cpp по пирамиде видимости камеры (Cull_Box)
  • UI texture batching (same2DTexture)
  • Stenciled player color guard (Has_Stencil() = false fallback)
  • 24-bit BGR Draw_Pixel support

🙏 Основано на / благодарности

  • Electronic Arts — исходный код Command & Conquer: Generals и Zero Hour, открытый в 2025 году под GPL v3 с дополнительными условиями EA: electronicarts/CnC_Generals_Zero_Hour.
  • Olcay Seygan — проект CnCGeneralsZH-Reforged (64-бит, Vulkan / Metal / D3D11, SDL3). Этот репозиторий основан на его дереве и сохраняет его историю коммитов; большая часть кода движка — его работа и работа сообщества.
  • TheSuperHackers — GeneralsGameCode, модернизация кодовой базы.
  • Мой вклад (Bezooom): Linux-сборка и проверка на Ubuntu 24.04, замеры X11 / Wayland, заметки по рендеру, документация и предложения в апстрим (список выше).

🗺️ Дорожная карта

  • Отправить предложения из раздела «Взаимодействие с апстримом» в CnCGeneralsZH-Reforged
  • Автопроверка сборки на Linux в GitHub Actions

Полный список задач и идей — в issues.

🤝 Участие в разработке

Вклад в проект приветствуется. Если есть идея, как сделать лучше, откройте issue или pull request:

  1. Сделайте форк репозитория
  2. Создайте ветку (git checkout -b feature/my-idea)
  3. Сделайте коммит (git commit -m 'feat: my idea')
  4. Отправьте ветку (git push origin feature/my-idea)
  5. Откройте pull request

Подробные правила: CONTRIBUTING.md.

📄 Лицензия

  • Весь код в репозитории распространяется под GPL v3 с дополнительными условиями EA — см. LICENSE.md. Это касается и моих изменений.
  • Игровые ресурсы (.big-архивы, текстуры, звуки, карты) не входят в репозиторий и принадлежат Electronic Arts.
  • Проект носит исследовательский характер и не аффилирован с Electronic Arts. Товарные знаки Command & Conquer и Generals принадлежат Electronic Arts Inc.

📬 Контакты

Павел Наумов (Bezooom) — naumovai.ru · X @Bezooooom · naumov122@gmail.com

Проект: https://github.com/Bezooom/CnCGeneralsZH-Linux

(наверх)

About

C&C Generals: Zero Hour on native Linux (Vulkan, SDL3, C++). Based on CnCGeneralsZH-Reforged; X11/Wayland measurements. GPL-3.0, bring your own game data.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages