Building Ryzom Core including NeL with CMake under Windows¶

• Building Ryzom Core including NeL with CMake under Windows
• Downloading prerequisites
• Installing prerequisites
  • • From GUI
  • From command line
    • Open a Visual Studio command line
    • Getting the sources
    • Installing external
    • Installing Jom (optional)
• Compiling
  • With GUI
  • With command line using nmake (installed by Visual C++)
  • With command line using jom (not installed by Visual C++)
  • Additional Step Necessary for Server Startup

Downloading prerequisites¶

First, you need to download all these files:

1. Microsoft Visual C++ 2008 Express
2. Microsoft DirectX SDK
3. Tortoise Hg
4. CMake
5. 7-Zip
6. External_stlport.7z

Installing prerequisites¶

Install Microsoft Visual C++ 2008 Express, Microsoft DirectX SDK, CMake, Tortoise Hg and 7-Zip in your desired locations. If you don't use the default path, you'll have to put your specific path in the following commands.

If you have problems installing the .net framework you may have other installations of the .net framework installed
which are preventing you.Use the .net cleanup tool at the bottom of this page if this is the case.

If you plan to use CMake from command line check this option:

From GUI¶

Get the sources

Decompress downloaded external_stlport.7z inside C:\ryzom\.

After that, you can delete external_stlport.7z.

You should have this structure :

C:\
|
+-- Ryzom
    |
    +-- code
    |   |
    |   +-- nel
    |   |
    |   +-- ryzom
    |   |
    |   +-- ...
    |
    +-- external_stlport
        |
        +-- bin
        |
        +-- bin64
        |
        +-- include
        |
        +-- lib
        |
        +-- lib64

From command line¶

Open a Visual Studio command line¶

In Start Menu -> All Programs -> Microsoft Visual C++ 2008 Express Edition -> Visual Studio Tools, launch Visual Studio 2008 Command Prompt

Getting the sources¶

In the command line, type:

c:
cd \
md ryzom
cd ryzom
hg clone http://ryzom.hg.sourceforge.net:8000/hgroot/ryzom/ryzom .

Installing external¶

Put the downloaded external_stlport.7z inside C:\ryzom\ and in the command line, type:

"c:\Program Files\7-Zip\7z.exe" x external_stlport.7z -oexternal_stlport
del external_stlport.7z

Installing Jom (optional)¶

Download Jom from Nokia FTP.

Put the downloaded jom.zip inside C:\ryzom\ and in the command line, type:

"c:\Program Files\7-Zip\7z.exe" x jom.zip -oexternal_stlport\bin
del jom.zip
set PATH=%PATH%;C:\ryzom\external_stlport\bin

Compiling¶

You'll need to disable patching in the client or you'll receive an error during patch download when you try and run it.

Edit \ryzom\code\ryzom\client\src\client_cfg.cpp and go to line 417. Change PatchWanted to false where it says "only force patching under Windows by default."

Alternatively, you can set FINAL_VERSION to off to build the client and add PatchWanted = 0; in client.cfg.

With GUI¶

You should launch CMake (cmake-gui) which is located in your Start menu in CMake sub-menu.

Fill in required fields:

• Where is the source code: C:/ryzom/code
• Where to build the binaries: C:/ryzom/code/build

Now click on Configure, it will ask you to choose a generator, select Visual Studio 9 2008 and click on Finish.

Other generators could work too such as: Visual Studio 9 2008 Win64 (if you installed Windows SDK 64 bits compilers) or other versions of Visual Studio.

If there is any error (text in red in the text area), check it in the text area at the bottom and try to fix it, if there is no error, click again on Configure, the Generate button should be enabled now, finally click on Generate.

If you want to enable or disable options, you will need to click again on Configure and Generate.

The solution C:\ryzom\code\build\RyzomCore.sln has been generated, you can double-click to open it in Visual C++ and press F7 to compile all projects.

With command line using nmake (installed by Visual C++)¶

In the command line, type:

cd code
md build
cd build
cmake ..
nmake

With command line using jom (not installed by Visual C++)¶

In the command line, type:

cd code
md build
cd build
cmake .. -G "NMake Makefiles JOM" 
jom

Additional Step Necessary for Server Startup¶

For connecting to a running game-server you have to install apache and mysql, as in http://dev.ryzom.com/wiki/7/EverythingWindows#Setting-up-ApachePHP and thereafter.
Please note that the first part of that page about compiling etc. is outdated, ignore it, until the wiki is corrected.

Please continue on to: http://dev.ryzom.com/wiki/ryzom/FixingWindowsBatch

CMake Options:
http://dev.ryzom.com/wiki/ryzom/CMakeOptions