Building Ryzom Core on Windows¶

• Building Ryzom Core on Windows
  • Introduction
  • Paths
  • Visual C++
  • Direct X SDK
  • 64 bits support
  • Third-party libraries
  • Visual Studio Configuration
  • Compiling NeL, Ryzom Core Client and Server
  • Compiling Ryzom Core Tools

Introduction¶

On Windows, the supported compiler is Visual Studio 2008 SP1. It also work fine with Visual C++ Express 2008 SP1 that is free (as free beer).

In our explanation, we'll use C:\ryzom as root directory where you put everything related to this project. You can use the root directory you want, just adapt the paths.

So first, create an empty directory C:\ryzom.

For easier management, we do a subst that point R:\ into C:\ryzom.

subst r: c:\ryzom

Paths¶

NeL write his DLL inside r:\code\nel\lib so if you want the executable automatically take the latest dll, you have to add r:\code\nel\lib (or r:\code\nel\lib64) in our PATH environment variable.

Visual C++¶

You can choose one of the following methods:

- Download and install the latest version of Visual C++ Express (2008 SP1)

or

- If you prefer, Download and install the Visual Studio pro trial 90 days
- and then the Download and install the Service Pack 1 (SP1)

Direct X SDK¶

Download and install the latest DirectX SDK (February 2010).

64 bits support¶

Do this only if you want to compiled in 64 bits. If you compile in 32 bits, just skip this part.

• Visual Studio 2008 SP1 (full version)* provides 64 bits compiler but it's not the case of express version, so you need to download a recent Windows platform SDK (one of the following) if you are using the express edition.

• Download and install the latest Windows SDK (Windows 2000, XP, Vista and 7)

Because to a bug in Platform SDK installer, you need to download http://dev.ryzom.com/attachments/498/VCE64BIT_WIN7SDK.zip which will fix the bug. Then launch setup_x86.bat (if you are on a 32 bit Windows) or setup_x64.bat (if you are on a 64 bit Windows).

Now in Tools => Options => Projects and Solutions => VC++ Directories you can choose x64 for Platform. Don't forget to follow the next instructions to configure all path.

Third-party libraries¶

To simplify the installation, we created an archive with all third-party libraries. It can be downloaded from the Files tab of this website here

Extract and rename the archive in r:\ so you should have r:\code and r:\external

Visual Studio Configuration¶

Now, you have to configure Visual Studio paths.

Go in menu Tools->Options...->Projects and Solutions->VC++ Directories

First you need to check if there's a Direct X entry "Include files" and "Library files" sections If not, you have to add it manually

Setup external and Nel paths :

For 32 bits platform

Section "Include"

r:\external\include\stlport (at the first position)

r:\code\nel\include

r:\code\nel\src

r:\external\include

Section "Executable files"

r:\external\bin

Section "Library"

r:\external\lib

r:\code\nel\lib

For 64 bits platform

Section "Include"

r:\external\include\stlport (at the first position)

r:\code\nel\include

r:\code\nel\src

r:\external\include

Section "Executable files"

r:\external\bin64

Section "Library"

r:\external\lib64

r:\code\nel\lib

Your include directories should look like (the include order is very important):

Make sure that the plugin 'dxcore' is NOT installed (which is part of http://www.devexpress.com/Downloads/Visual_Studio_Add-in/) before opening the project containing the client code. Else, Visual Studio might crash while loading files including luabind.hpp.

Compiling NeL, Ryzom Core Client and Server¶

• Go in r:\code\ryzom\server
• Double-click on server.sln (it'll launch Visual Studio)
• Select "Release" configuration
• Press F7 to build

Compiling Ryzom Core Tools¶

Warning: Ryzom Core Tools need MFC to compile, since Visual Express doesn't have MFC, you need a full version of Visual Studio.

• Go in r:\code\ryzom\tools
• Double-click on all.sln (it'll launch Visual Studio)
• Select "Release" configuration
• Press F7 to build