EverythingWindows¶

Building, Configuring and Running the Ryzom Core for Windows(x86)

This guide is intended to give a step by step process for setting up and running the Ryzom Core for those that may not be as technically gifted as others, so I am trying to write this assuming that the reader isn't familiar with the tools and software used here.

The following is a list of everything you will need to download.

TortoiseHg - http://tortoisehg.bitbucket.org/download/index.html
DirectX SDK (February 2010) - http://www.microsoft.com/downloads/details.aspx?FamilyID=2c7da5fb-ffbb-4af6-8c66-651cbd28ca15&displaylang=en
Qt - http://qt.nokia.com/downloads/windows-cpp-vs2008
Apache - http://apache.mirrors.hoobly.com/httpd/binaries/win32/httpd-2.2.15-win32-x86-no_ssl.msi
MySQL - http://www.mysql.com/downloads/mysql/
Visual C++ 2008 (90 Day Trial) - http://download.microsoft.com/download/8/1/d/81d3f35e-fa03-485b-953b-ff952e402520/VS2008ProEdition90dayTrialENUX1435622.iso
Visual C++ 2008 SP1 - http://www.microsoft.com/downloads/thankyou.aspx?familyId=27673c47-b3b5-4c67-bd99-84e525b5ce61&displayLang=en
PHP - http://windows.php.net/downloads/releases/php-5.3.2-Win32-VC6-x86.zip
STLport - http://dev.ryzom.com/attachments/download/492/external_stlport_64.7z
Autoexp.dat - http://dev.ryzom.com/attachments/download/525/autoexp.dat

Getting the source code

Download and install TortoiseHg - http://tortoisehg.bitbucket.org/download/index.html

Create a folder on your computer and name it whatever you want (choose something easy to remember and easy to get to because you will be referring to this a lot).

Example: x:/ryzom

Navigate to this directory and right click on the folder that you just made.

Highlight TortoiseHg in the menu and select Clone from the list that appears to the side.

In the TortoiseHg Clone window, in the Source path: box put in
http://ryzom.hg.sourceforge.net:8000/hgroot/ryzom/ryzom

For destination path, you want the path to the folder you just right clicked on, which it should default to.

Leave everything else the default (unchecked) and hit Clone at the bottom.

Configuring Visual C++ 2008

First install the DirectX SDK (February 2010)- http://www.microsoft.com/downloads/details.aspx?FamilyID=2c7da5fb-ffbb-4af6- 8c66-651cbd28ca15&displaylang=en

Now create a new folder. This can go wherever you want and can be called anything you want. For organizational purposes, I made mine x:/external.

Download this file
http://dev.ryzom.com/attachments/download/492/external_stlport_64.7z

Extract the contents to the folder you just created.

Download this file
http://dev.ryzom.com/attachments/download/525/autoexp.dat

Copy that file into the following directory:
C:\Program Files\Microsoft Visual Studio 9.0\Common7\Packages\Debugger

Download and install this file
http://qt.nokia.com/downloads/windows-cpp-vs2008

On your desktop or in your start menu, right click on My Computer and go to Properties. On the left side go to Advanced System Settings and in that window click on Environment Variables… at the bottom.

Under the second box labeled System variables you want to hit the New… button. In the box that pops up type in QTLIB for the variable name and put in the directory where Qt installed and \lib after that. So it should look something like C:\QT\4.6.2\lib in the Variable value: field.

Note: You will need to restart your computer at this point.

Now navigate to the directory we created at the beginning where all the source code is.

Go into code\nel\ and double click on nel.sln. This should open up the project in Visual V++ 2008.

Once that opens, you want to go to the Tools drop down menu at the top and select Options at the bottom. On the left side of that window you want to expand Projects and Solutions and then select VC++ Directories.

On the right side where it says Show directories for: click on the drop down list there and select Include files. Below that click on the icon that looks like a yellow folder (when you hover over it, it says New Line. A new line pops up at the top of the list down below. You want to hit the … button to the right of that whitespace. Browse to the include directory where the DirectX SDK installed. By default, it installs to C:\Program Files\Microsoft DirectX SDK (February 2010)\Include.

Now you want to add a few more lines with the following directories:
(Note: Your drive letters and folder names may be different than mine)
x:\external\include\stlport
x:\external\include
x:\external\bin
x:\ryzom\code\nel\src
x:\ryzom\code\nel\include

Now go back to the drop down box under Show directories for: and select Library files.

Add the following lines:
(Once again your drive letters and the name of your directories may be different than mine)
C:\Program Files\Microsoft DirectX SDK (February 2010)\Lib\x86
x:\external\lib
x:\ryzom\code\nel\lib

Now you are done with that part. Go ahead and hit OK at the bottom.

Compiling NeL, Client/Server, and Tools.

If you don’t already have nel.sln open, navigate to code\nel\ directory in the source code we downloaded earlier and open it.

Along the top of your Visual C++ 2008 window below the Help drop down menu click on the arrow next to where it says Debug and select Release.

Now hit F7 and wait. You are now compiling, and this could take awhile…

When that’s done, hopefully you will get a message along the bottom saying that everything was successful.

Now let’s move on to the Client/Server.

Navigate to the directory you have the source code and go to code\ryzom\server. Double click on server.sln. Make sure to change Debug to Release like we did before in this project and then press F7 once again to compile. This will take even longer than when you compiled NeL.

When that’s done, go ahead and exit out and navigate once again to your source code directory and browse to code\ryzom\tools. Double click on all.sln. Once again change Debug to Release and hit F7. Once again wait and it should all compile successfully.

To be continued…