Как собрать и настроить OpenXRay на Windows

Еще раз подумайте, для чего Вам нужно собирать OpenXRay из исходников?

Ведь самые новые сборки можно скачать на GitHub Actions (для скачивания необходимо залогиниться в GitHub) или на AppVeyor (иногда сборки недоступны из-за нехватки места).

Сборка:

На текущий момент, поддерживается только компилятор MSVC.

Для сборки OpenXRay достаточно наличия Visual Studio 2022 Community (или Visual Studio 2019 Community). Если вы её ещё не установили, вы можете скачать её и установить – она абсолютно бесплатна.

Вам понадобятся следующие пакеты, которые вы можете установить через Visual Studio Installer:

• Рабочая нагрузка C++
• Универсальная среда выполнения C для Windows
• Windows 10.0 SDK (любой)
• Диспетчер пакетов NuGet
• MSVC версии 143 — средства сборки C++ для VS 2022 для x64 или x86
  • Или MSVC версии 142 — средства сборки C++ для VS 2019 для x64 или x86

Вам потребуется специальное расширение для того, чтобы Visual Studio автоматически сохраняла файлы в кодировке UTF-8. (без BOM)

Библиотеки:

Все необходимые библиотеки уже находятся в репозитории в папке sdk, либо в качестве подмодулей в папке Externals.

Подготовка:

• Установите S.T.A.L.K.E.R.: Зов Припяти
• Установите патч 1.6.02 (если он ещё не установлен):
• Склонируйте репозиторий
  • Если вы предпочитаете терминал, вот команда:
    • git clone https://github.com/OpenXRay/xray-16.git --recursive
  • Если вы предпочитаете Github Desktop:
    • Просто нажмите Open in Desktop.
  • Движок не соберётся если скачать его ZIP-архивом, либо если в пути будут русские буквы.
• Сделайте резервную копию папок bin, gamedata и файла fsgame.ltx из каталога с игрой, затем удалите их, а на их место скопируйте папку gamedata и файл fsgame.ltx из каталога с репозиторием xray-16\res.
• Теперь можно собрать движок. Для этого откройте проект xray-16\src\engine.sln и выполните его сборку через меню Сборка - Собрать решение (или Build - Build solution).
• Проверьте результат сборки. Должно быть сообщение вида (самая важная, часть с ошибками: 0)
  • ========== Сборка: успешно: 61, с ошибками: 0, без изменений: 0, пропущено: 5 ==========

Запуск и отладка через Visual Studio:

1. Выберите решение engine и откройте его свойства
   • Выберите:
     • Запускаемый проект
       • Один загружаемый проект
         • xr_3da
2. Выберите проект xr_3da и откройте его свойства
   • Выберите:
     • Отладка:
       • Рабочий каталог
         • C:\Путь\До\СталкерЗовПрипяти\ (папка, где находится fsgame.ltx)

Важно

Не используйте конфигурацию Debug, если вы не ищите утечки, порчи памяти и другие труднонаходимые проблемы; производительность этой конфигурации очень низкая. Для разработки модов используйте Release или Mixed, для финальных тестов – Release Master Gold.