IX-Ray is fork of X-Ray 1.6 engine that aims to improve gaming experience and simplify development of modifications

Common purposes of the project is improving developer and gaming experience, fixing a lot of bugs of the original engine and extending support for new features

Latest release of the engine can be downloaded on the releases page

• Architectures support: x64
• Visual Studio 2019-2026 is supported
• CMake build system
• Supported renderers: DirectX 9.0c, DirectX 11
• Improved performance and better FPS
• Extended opportunities for modmakers
• Fixed original bugs
• Increased level loading speed by 3-4 times
• Debugging tools support: ASAN, RenderDoc and LuaPanda
• Supported DLTX and XMLOverride
• Supported in-game debugging tools
• Supported TTF font system
• Extended rendering features
• Supported BC7 compression format
• Supported NVIDIA DLSS and AMD FidelityFX Super Resolution 2 (FSR2) Technologies
• Extended gameplay features
• Extended UI features
• Extended Lua features

• OS: Windows 7 SP1 with installed Platform Update or newer
• CPU: Supports SSE2 and newer instructions
• RAM: 4 GB
• GPU: Support for Shader Model 3.0 or newer
• GPU VRAM: 512 MB
• DirectX: 9.0с or newer

For launching:

• OpenAL Driver
• Visual C++ Redistributable
• DirectX End-User Runtime
• Install original game
• Delete in main folder of the game: bin, gamedata (if exists)
• Unpack archive to main folder of the game

For building:

• Visual Studio 2022 (or 2026) Community Edition
  • Windows SDK 10.025+
• Git
• CMake

For development:

• Visual Studio 2022 (or 2026) Community Edition
• Git
• CMake with CMake GUI

The project can be built in various ways. Choose the most convenient one and follow the steps

Download the repository firstly:

# From GitHub
git clone https://github.com/ixray-team/ixray-1.6-stcop.git

To generate a solution with default settings from the console, follow the steps below:

cmake -B build

To build the project after generating solution:

• Open generated solution in Visual Sudio
• Select necessary build config
• Build solution

To generate build folder and solution:

• Open CMake GUI
• Press Browse Source... button and open folder with the project
• Select required options in IXRAY category
• Press Configure button and then Generate button

To build the project after generating solution:

• Open generated solution in Visual Sudio
• Select necessary build config
• Build solution

To build from the console follow steps below

• Select one of preset from the list and configure project:

  • Engine-x86-Windows
  • Engine-x64-Windows
  • Engine-x86-NonUnity
  • Engine-x64-NonUnity
  • Server-x86-Windows
  • Server-x64-Windows
  • Editors-x64-Windows
  • Utilities-x86-Windows
  • Utilities-x64-Windows
  • Plugins-x64-Windows
  • Compressor-x86-Windows
  • Compressor-x64-Windows
  • Compressor-x64-Linux

  cmake --preset <preset-name>
  # For example:
  # cmake --preset Engine-x64

• Select build configuration from the list and build project:

  • Debug
  • RelWithDebInfo
  • Release

  cmake --build --preset <preset-name-configuration>
  # For example:
  # cmake --build --preset Engine-x64-Debug

• Run script to get modified files and packed assets:

  .\util\generate-patch.bat build\x64\Compressor-Windows\bin\Release\xrCompress.exe

All significant changes to this repository are documented in this file

Contents of this repository licensed under terms of the custom MIT-like non-commercial license unless otherwise specified. See this file for details

Project is being developed with the support of these tools

PVS-Studio - static analyzer for C, C++, C#, and Java code