Urho3D Wiki

Building Urho 1.5 (Windows 10, MinGW/GCC)

69pages on
this wiki
Add New Page
Comments0 Share

Welcome to the Urho3D beginner build guide!

This Guide describes how to create and build Urho3D from source.

This guide is based on the official build guide ( but provides a more complete guide (with dependencies) and is a step by step guide with images, which should be easier for beginners. This guide uses Windows and CodeBlocks as an IDE with the MinGW compiler suite (GCC), but other systems and combinations are quite similar.

There are also older guides for Urho 1.4 and Urho 1.32, the later one uses Makefiles.

This guide uses the following programs (links below):

  • Urho3D (1.5)
  • CMake (3.4.1, this is the build system used by Urho)
  • MinGW64 (5.2.0 64bit)
  • CodeBlocks (15.12 RC1, the IDE this guide uses, you could also use something else)
  • Windows 7 / 8 / 10 (64bit)
  • Windows SDK (optional, sometimes needed for DirectX)
  • DirectX End-User Runtime (June 2010) (required to run DirectX 9 or 11 programs, may be already installed)

Other program versions should work too and other programs (like Visual Studio instead of MinGW) are similiar.

1. Download and InstallationEdit

When installing MinGW, you may want to pick "x86_64" as the architecture if you want to build 64bit software:

Mingw setup

(i686 is 32bit) The rest should be left on default. When installing CMake, select one of the two options to add it to the system PATH:

Cmake setup

All other programs can be installed with default settings. Unpack Urho somewhere.

2. Setup Codeblocks Edit

For me Codeblocks couldn't automatically find the compiler so I had to specify it manually:

Codeblocks setup
  1. Go to "Settings" (in menu bar) -> "Compiler"
  2. "Global compiler settings" -> "Toolchain executable"
  3. Select the path of MinGW's /bin and change the program names to match the one there.

3. Set up MinGW for CMake Edit

You have to modify your system path so that Urho's CMake scripts can find your MinGW:

Mingw path
  1. Open an explorer window and right click on "This PC".
  2. -> Properties
  3. -> Advanced System Settings
  4. -> Environment Variables
  5. Select "Path"
  6. -> Edit
  7. Copy the path to where you installed MinGW. You need the /bin subdirectory. (you can click in and copy from the marked address bar)
  8. Enter a ; and paste the path. (Entries in this list are seperated by semicolons.)
  9. Click Ok everywhere.

4. Run CMake to create the project files for Urho Edit

Cmake urho
  1. Go to where you have unpacked Urho
  2. Click "File"->"Open command prompt" or press Shift+Rightclick somewhere in the folder or Shift+F10 to open a menu with the "Open command window here" option. This opens a terminal.
  3. Start the "cmake_codeblocks.bat" script with a folder name as a parameter (doesn't have to exist) where you want to create the project files. This folder can also be outside of the Urho folder.

You can also set build options for Urho when executing the script, for example:

cmake_codeblocks.bat Build -DURHO3D_OPENGL=0 -DURHO3D_WIN32_CONSOLE=1

This builds Urho with DirectX9 instead of OpenGL (default) and with the console option (displays logging in a terminal when using the samples). See for all options.

5. Building Urho Edit

  1. Open the project that that the script just created in the build folder (here "Build/Urho3D.cbp").
  2. Use Ctrl+F9 or the gear-wheel symbol to build Urho. This takes a while and prints a lot to the build log:
Build urho
and you are done with building Urho3D!

If you also build the samples you can find them in your Build/bin:

Urho sample

You may want to continue with the first project tutorial.

Ad blocker interference detected!

Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.