Build on Windows

Setup

1. Download and Install Git for Windows.

https://github.com/git-for-windows/git/releases/download/v2.51.0.windows.1/Git-2.51.0-64-bit.exe

2. Create an empty directory for the project.

This guide uses C:\nara\dev\reone as an example. You can use any directory, but make sure to adjust instructions accordingly.

3. Open the directory and Git Bash.

Open the directory, right-click for a context menu, and click on Open Git Bash here Enter the following command and press Enter. You can copy commands from this guide, and insert them to Git Bash using Shift-Insert keyboard shortcut.

4. Download repository reone.

Copy the following command and press Enter:

git clone https://github.com/modawan/reone

5. Download repository vcpkg.

Enter another command and press Enter:

git clone https://github.com/microsoft/vcpkg

6. Download CMake.

Enter 3 more commands:

curl -OL https://github.com/Kitware/CMake/releases/download/v4.1.0/cmake-4.1.0-windows-x86_64.zip

unzip cmake-4.1.0-windows-x86_64.zip

After unzip is done, you can delete the zip file.

mv cmake-4.1.0-windows-x86_64 cmake

7. Setup VCPkg.

Enter the following commands:

export VCPKG_ROOT="$PWD/vcpkg"

export PATH="$VCPKG_ROOT:$PATH"

bootstrap-vcpkg.sh

8. Install all build dependencies.

Use the following command. It is one long line. Insert it and press Enter:

vcpkg/vcpkg install --triplet x64-windows boost-algorithm boost-endian boost-format boost-functional boost-program-options glm sdl2 glew openal-soft libmad ffmpeg wxwidgets gtest

9. Run CMake.

cmake/bin/cmake -B reone/build -S reone -DCMAKE_TOOLCHAIN_FILE="$PWD/vcpkg/scripts/buildsystems/vcpkg.cmake"

---

Build

10. Go to build folder in reone folder and launch reone.sln.

Example: C:\nara\dev\reone\reone\build

11. Right-click ALL_BUILD -> Build.

Wait for the build process to complete.

12. Run launcher.exe

Then go to the project directory, then build\debug\bin, and run launcher.exe. For example, C:\nara\dev\reone\reone\build\debug\bin:

13. Choose the KOTOR game directory.

Here we use a Steam version of the game

14. Click Save configuration.

Launcher should generate a reone.cfg configuration file.

15. After that, go back to Visual Studio and right-click on engine -> Properties

16. In the window click on Debugging.

Change Working Directory from $(ProjectDir) to $(TargetDir) and press OK.

---

Run

17. Right-click on engine -> Debug -> Start New instance

18. Done

---