[EN] How to build and setup on Windows

How to build and setup OpenXRay on Windows

Build:

Currently, the only compiler supported is MSVC of Visual Studio. (that means, you should use Visual Studio .sln solution to build for Windows. We have CMake, but it is only configured for Linux)

If you don't have Visual Studio yet, you can download and install Visual Studio 2022 (or 2019) Community Edition - it's absolutely free for open source projects.

You will definitely need to install the following items that are available for installation in Visual Studio installer:

• C++ workload
• Windows Universal CRT
• Windows 10.0 SDK (any)
• NuGet package manager
• MSVC v143 – build tools for VS 2022 for x64 and x86
  • or MSVC v142 – build tools for VS 2019 for x64 and x86

You will need following extension to save files in Visual Studio with encoding UTF-8 without BOM.

Libraries:

All required libraries are already in repository as plain files or as submodules.

Setup:

• Install S.T.A.L.K.E.R.: Call of Pripyat
• Install patch 1.6.02 (only for russian locale, worldwide release should have it included):
• Clone the repository (you should not download it as an archive)
  • If you are using Git console, here's the command:
    • git clone https://github.com/OpenXRay/xray-16.git --recursive
  • If you are using Git client:
    • You can just push Open in Desktop if you are using Github Desktop.
    • Then type this command in the Git console git submodule update --init --recursive
    • If this command fails for any reason, use git submodule sync and then retry the above command.
• Now you can build the engine!
  • Just open src/engine.sln in Visual Studio.
  • Then press Build -> Build Solution, or build only xr_3da project if you don't need utils. (level compilers, etc.)

Debug/Run from Visual Studio:

1. Select engine solution and open its properties
   • Select:
     • Startup Project
       • Single startup project
         • xr_3da
2. Select xr_3da project and open its properties
   • Select:
     • Debugging
       • Working Directory
         • C:\PATH\TO\StalkerCallOfPripyat\ (folder which contains fsgame.ltx)

Tips

Debug configuration is used for full debug and it's not playable. It's recommended to use Mixed.