mirrors/OpenRCT2
1
0
Fork 0
mirror of https://github.com/OpenRCT2/OpenRCT2 synced 2025-12-10 01:22:25 +01:00
Code Issues Releases Wiki Activity
Page: Building OpenRCT2 on Windows
Pages
Android Audio specifics Benchmarking & stress testing OpenRCT2 Building OpenRCT2 on Linux Building OpenRCT2 on MSYS2 MinGW Building OpenRCT2 on Windows Subsystem for Linux Building OpenRCT2 on Windows Building OpenRCT2 on macOS using CMake Building OpenRCT2 on macOS using Xcode CSS1.DAT Changes to original game Changes to the SV6 file format Cheats Coding Style Commit Messages Converting Game Commands to Game Actions Custom Music and Ride Music Objects Debugging OpenRCT2 on macOS Decompiling Tips IDA Decompiling Tips OllyDbg Dithering Images using Photoshop Dithering Images Easter Eggs External influences FAQ & Common Issues Features to implement Found bugs and limitations in RCT2 G1 Elements Layout Game Actions Game Commands Getting packaged versions Home How To Contribute Increasing of game limits Installation on Linux and macOS Known Issues from the RCT2 Readme Language support Legacy console Loading RCT1 scenarios and data Map Generation Maps Master Server Minimum install Multiplayer issues Multiplayer permissions Multiplayer Music Cleanup NTDF design New save format status Newly Identified Fields Objects Official extended scenery set OpenGL renderengine issues OpenGL renderer Original Graphics Overall program structure Peep AI Peep Sprite Type Performance RCT1 Features not in RCT2 RCT1 ride and vehicle types and their RCT2 equivalents RCT12_MAX_SOMETHING versus MAX_SOMETHING Rebase and Sync fork with OpenRCT2 Release Checklist Replay System Ride rating calculation Roadmap STEX support removal SV6 Ride Structure Sandbox Mode Settings in config.ini Sizes and angles in the game world Sprite List csg1.dat Sprite List g1.dat Sprite compiler Strings used in RCT1 Strings used in the game Submitted feature requests TD6 format Terminology Testing Track Data Track Element Lengths Track designs Track drawers, RTDs and vehicle types Track types Tutorials Using Track Block Get Previous Using minidumps from crash reports Vehicle Sprite Layout Widget colours game.cfg structure
Clone
28
Building OpenRCT2 on Windows
Matt edited this page 2025-04-24 15:06:33 +03:00
Table of Contents

Requirements

  • Windows 7, 8, 10 or 11
  • Visual Studio 2022 (Enterprise, Professional, or Community (Free))
  • Latest Visual Studio updates installed
  • At least 5 GB free disk space

Checking Out the Code

  1. Create a directory on a drive with at least 5 GB free space (e.g., cd C:\GitHub\OpenRCT2).
  2. Navigate to the new directory.
  3. Clone the repository using GitHub Desktop or other tools.

Building with Visual Studio

  1. Navigate to the directory where the code was cloned (e.g., cd C:\GitHub\OpenRCT2).
  2. Open openrct2.sln in Visual Studio.
  3. In Visual Studio, select Build > Build Solution from the top menu. The first build will fetch all required dependencies.
  4. Run the game: bin\openrct2.

Building with MSBuild

  1. Navigate to the directory where the code was cloned (e.g., cd C:\GitHub\OpenRCT2).
  2. Open a Developer Command Prompt for VS 2022 and navigate to the repository (e.g., cd C:\GitHub\OpenRCT2).
  3. Run one of the following:
    • For 64-bit: msbuild openrct2.proj /t:Build /p:Platform=x64 /p:Configuration=Release
    • For 32-bit: msbuild openrct2.proj /t:Build /p:Platform=Win32 /p:Configuration=Release
    • Both choices will work but it is recommended to select the platform that you are using.
  4. Run the game: bin\openrct2.

After running MSBuild once, you can continue development in Visual Studio by opening openrct2.sln.

Additional examples

set platform=x64
msbuild openrct2.proj /t:Clean
msbuild openrct2.proj /t:Rebuild /p:Configuration=Release
msbuild openrct2.proj /t:BuildG2

Configurations and Platform

Choose a Platform matching your system (e.g., x64 for 64-bit systems). Available configurations:

  1. Debug
    • All optimizations are disabled for easier debugging. Fast build times but poor runtime performance.
  2. Release
    • Recommended for development. Most optimizations enabled, supports fast incremental builds, and balances build time and runtime performance. Debugging may be limited.
  3. ReleaseLTCG
    • This configuration uses Link Time Code Generation also known as Whole Program Optimization, this enables additional optimizations but will result in longer build times. This configuration is used for all our releases as it will provide the best possible performance but is not ideal for development.

Notes

  • If you encounter build errors or graphical glitches, rebuild the project to update dependencies.
  • For Visual Studio debugging:
    1. Open openrct2.sln.
    2. In Solution Explorer, right-click openrct2-win and select Set as Startup Project.