C&C Generals: Zero Hour нативно на Linux (Vulkan / SDL3) на основе CnCGeneralsZH-Reforged: сборка, замеры X11 vs Wayland, заметки по рендеру. Игровые файлы — свои.
Документация » · Сообщить об ошибке · Предложить улучшение · English
📑 Содержание
- 📖 О проекте
- 🗺️ Ландшафт открытых проектов
- 📦 Модель распространения (как у OpenRA)
- 🔬 Инженерные заметки: замеры и оптимизации
- 🧱 Технологии (Built With)
- 🚀 Как запустить игру на Linux
- 🤝 Взаимодействие с апстримом (Upstream Collaboration)
- 🙏 Основано на / благодарности
- 🗺️ Дорожная карта
- 🤝 Участие в разработке
- 📄 Лицензия
- 📬 Контакты
Нативный запуск легендарной RTS на Linux без Wine и Proton: ландшафт открытых проектов, модель распространения OpenRA (Bring-Your-Own-Assets) и инженерные заметки по оптимизации рендера.
Проверено на тестовой системе: Ubuntu 24.04 LTS, x86_64, NVIDIA GeForce RTX 3090 24 GB, X11 / Wayland.
После того как 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, fheroes2, GZDoom, DXX-Rebirth) действует строгое разделение между кодом и ассетами:
- Исходный код движка открыт под лицензией GPL v3. Его можно свободно собирать, модифицировать и распространять.
- Игровые ресурсы (
.big-архивы, текстуры, 3D-модели, звуки, музыка, карты и ролики) защищены авторским правом Electronic Arts. Репозиторий не содержит проприетарных файлов игры. - Модель «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) были изолированы ключевые факторы производительности:
При запуске клиента в сессии 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.
В цикле отрисовки рельефа тайлы карты перебирались целиком на каждом шейдерном проходе без предварительной проверки видимости камерой:
| Параметр | Без отсечения | С отсечением 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() в базовом цикле и в дополнительных проходах. Экспериментальный патч отсечения тайлов рельефа по камере (описан ниже в предложениях для апстрима).
Оригинальный интерфейс сбрасывал двумерный рендер при каждой смене объекта изображения:
- Оптимизация
same2DTexture(): батч остаётся открытым для разных объектовImage, если они используют один и тот же файл текстуры (одинаковую страницу атласа). - Охват
winRepaint(): проход отрисовки всех окон держится в едином батче, исключая холостые переключения состояний между кнопками и глифами шрифтов. - Сокращение вызовов: с 1380 до 885 вызовов на кадр в тестовой сцене.
- Симптом: Рельеф в игре заливался прямоугольной цветной дымкой (красной у Китая, синей у США, фиолетовой у GLA).
- Причина: Функция
W3DScene::renderStenciledPlayerColor()рисует полноэкранный квад в цвете локального игрока и маскирует его трафаретным буфером (stencil) поверх перекрытых объектов. В Vulkan-пайплайне трафаретный тест не был сконфигурирован, в результате чего квад рисовался без маски на весь тактический вид. - Решение: Вызов
DX8Wrapper::Has_Stencil()на Linux возвращаетfalse, что направляет движок по штатному нетрафаретному путиflushOccludedObjects().
- Симптом: Чёрная миникарта у США при старте матча.
- Причина: Выбор формата текстуры радара предпочитал 24-битный
R8G8B8(3 байта на пиксель), тогда как функцияSurfaceClass::Draw_Pixel()обрабатывала только 1, 2 и 4 байта (запись пикселей рельефа была пустым действием). - Решение: Добавление 3-байтового регистратора BGR в
Draw_Pixel()и приоритизация 32-битного форматаX8R8G8B8в списке форматов радара.
- Установите оригинальную игру в Steam (Command & Conquer: The Ultimate Collection).
- Скачайте свежий релиз из репозитория Reforged (доступны AppImage, Flatpak,
.deb,.rpm, Arch). - При запуске укажите путь к каталогу с файлами игры (или позвольте движку найти библиотеку Steam автоматически).
- Рекомендация по сессии: выбирайте сессию «GNOME on Xorg» / X11 на экране входа для минимальной задержки презентации.
# Клонирование канонического апстрима с Vulkan/SDL3 бэкендом
git clone https://github.com/olcayseygan/CnCGeneralsZH-Reforged.git
cd CnCGeneralsZH-Reforged
# Сборка на Linux
./build-linux.sh Release generalsНаблюдения и оптимизации передаются в канонический репозиторий Reforged:
- Terrain tile frustum culling: отсечение невидимых тайлов рельефа в
HeightMap.cppпо пирамиде видимости камеры (Cull_Box) - UI texture batching (
same2DTexture) - Stenciled player color guard (
Has_Stencil() = falsefallback) - 24-bit BGR
Draw_Pixelsupport
- 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:
- Сделайте форк репозитория
- Создайте ветку (
git checkout -b feature/my-idea) - Сделайте коммит (
git commit -m 'feat: my idea') - Отправьте ветку (
git push origin feature/my-idea) - Откройте 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
(наверх)