Build the client with MSVC 2010 Express

This article is part of the URU Documentation Project

Introduction

This document provides steps to build the CWE client with MSVC 2010 SP1 Express.

Before you begin

• If you have a version of Visual Studio later than 2010 installed, you may need to uninstall it.
• If you have Microsoft Visual C++ 2010 Redistributable installed (x86 and/or x64), you will need to uninstall it before installing DirectX SDK. While installing Visual Studio, the Redistributable package(s) will be reinstalled for you automatically.

Items needed to compile

See Build preparation steps for installation instructions!

• git (recommended but not required)
• The CWE OpenUru source code
• DirectX 9.0c SDK (June 2010)
• Microsoft Visual Studio 2010 SP1 Express - This will be in two downloads, you'll need to search for and download both "Visual Studio 2010 VC Express" and "Visual Studio 2010 Service Pack 1".
• OpenAL v1.1 SDK
• Ageia PhysX 2.6.4 Core SDK
• libogg-1.3.2
• libvorbis-1.3.6
• OpenSSL 1.0.2t
• zlib 1.2.7
• libpng 1.5.12

Newer versions of these libraries may work, but no guarantees are offered; these are what have been tested. See the next section for restrictions on using newer versions.

Notes

• This guide assumes you are going to use the 7.0A SDK installed with Visual Studio 2010, and are using a 64 bit Windows install.
• You can upgrade to a newer version of Speex if you like, but you will need to fix the Speex VS2010 projects first (by removing the architectures we do not have from the Speex project files).
• Libogg 1.3.2 was used because xiph removed the VS2010 projects from 1.3.3 and above.
• The client has physics bugs (cannot step off the Kadish elevator, and such) when compiled with PhysX 2.6.4 (the only available version). If you can obtain it, PhysX 2.6.0 is the version Cyan used, and clients compiled with it do not seem to have these physics bugs.
• You must use a 2.6.x version of PhysX for CWE, because the cooked mesh format was changed in PhysX 2.7.x and later.
• All libraries are compiled with "Whole Program Optimization" turned off.
• Release version libraries are compiled as "Multi-threaded DLL (/MD)"
• Debug version libraries are compiled as "Multi-threaded Debug DLL (/MDd)"
• Crypto keys are located in "CWE\MOULOpenSourceClientPlugin\Plasma20\Sources\Plasma\NucleusLib\pnNetBase". Edit the *.hpp files with a text editor to replace Cyan's keys with your own server's keys. Always clean your solution and rebuild when you change crypto keys, to make sure they are updated.
• Server hostnames, IP addresses, and ports are located in the following files:

The status URL:

"CWE\MOULOpenSourceClientPlugin/Plasma20/Sources/Plasma/Apps/plClient/winmain.cpp"

"CWE\MOULOpenSourceClientPlugin/Plasma20/Sources/Plasma/Apps/plUruLauncher/Main.cpp"

The auth/gatekeeper address

"CWE\MOULOpenSourceClientPlugin/Plasma20/Sources/Plasma/NucleusLib/pnNetBase/Private/pnNbSrvs.cpp"

The default client port

"CWE\MOULOpenSourceClientPlugin/Plasma20/Sources/Plasma/NucleusLib/pnNetBase/pnNbConstant.h"

Build preparation steps

git (Optional)

If you plan to make changes to the source code and contribute to the community, install git (accepting the default options).

CWE-ou

Obtain CWE-OU source by one of these methods:

• Use git clone with the repository link found on the webpage referenced above
• Click "tree" in the top menu of the webpage reference above, then click "zip" to download a ZIP archive

DirectX

Install the DirectX 9.0c SDK and copy it to "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\DX9.0c".

Install the DirectX SDK before you install VS2010 Express, or the DirectX SDK install will throw error S1023, due to a newer version of the C++ 2010 redistributables being installed.

Directory structure in the CWE tree will look like this:

  StaticSDKs
    Win32
      DX9.0c
        include
        Lib

Visual Studio 2010 Express

• Install Visual Studio 2010 Express
• Install Service Pack 1 (SP1) for Visual Studio 2010, plus security updates (run Windows Update a few times)
• Copy the include and lib directories from the SDK installed with VS2010 SP1 Express to "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\PlatformSDK". The directory where the SDK resides will most likely be "Program Files (x86)\Microsoft SDKs\Windows\v7.0A". As the SDK is in our path, this step is probably not necessary but we will do it for consistency.

Directory structure in the CWE tree will look like this:

StaticSDKs
  Win32
    PlatformSDK
      include
      lib

OpenAL SDK

• Install the OpenAL SDK and copy the include and lib directories to "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\OpenAL 1.1 with EFX SDK"

Directory structure in the CWE tree will look like this:

  StaticSDKs
    win32
      OpenAL 1.1 with EFX SDK
        include
        libs

PhysX SDK

• Install PhysX SDK, and copy PhysX subdirectories from "Program Files (x86)\AGEIA Technologies\AGEIA PhysX SDK\v2.6.4\SDKs" and "Program Files (x86)\AGEIA Technologies\AGEIA PhysX SDK\v2.6.4\Bin" to "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\PhysX"

Directory structure in the CWE tree will look like this:

  StaticSDKs
    Win32
      PhysX
        Bin
        Cooking
        Docs
        Foundation
        Framework
        lib
        ...

libogg and libvorbis

Build Ogg and Vorbis

1. Create a directory and extract Ogg and Vorbis archives to it.

   oggvorbis
     libogg-1.3.2
     libvorbis-1.3.6

2. Change directory to "libvorbis-1.3.6\win32\vs2010" and edit the libogg.props file. Make sure the "LIBOGG_VERSION" value matches your version of Ogg (1.3.2 in this document).
3. Open "libogg-1.3.2\win32\VS2010\libogg_static.sln" in the Visual Studio IDE.
4. On the IDE toolbar, click on configuration drop down at the upper left (it defaults to "Debug") and change it to "Release"
5. Right click on the project ("libogg_static") in the Solution Explorer at upper left, and select Properties.
6. In the "libogg_static Properties Pages" panel that opens, set (or verify) the following items as follows:

   Left Pane	Right pane parameter	Right pane value (drop down)
   Configuration Properties -> General	Whole Program Optimization	No Whole Program Optimization
   C/C++ -> Optimization	Whole Program Optimization	No
   C/C++ Code Generation	Runtime Library	Multi-threaded DLL (/MD)

7. Click on "Apply"
8. Click on configuration drop down at the upper left of the "libogg_static Properties Pages" panel and select "Debug". Set (or verify) the following items as follows, noting that the 3rd item is not the same as in the previous list.

Left Pane	Right pane parameter	Right pane value (drop down)
Configuration Properties -> General	Whole Program Optimization	No Whole Program Optimization
C/C++ -> Optimization	Whole Program Optimization	No
C/C++ Code Generation	Runtime Library	Multi-threaded Debug DLL (/MDd)

9. Click "Apply" and then "OK".
10. On the IDE toolbar, verify the configuration drop down is still set to "Release". Then right click on the project in the solution explorer and select "Build".
11. On the IDE toolbar, select "Debug" from the drop down. Then right click on the project in the solution explorer and select "Build".
12. Open "libvorbis-1.3.6\win32\VS2010\vorbis_static.sln" in the Visual Studio IDE, and repeat all of the preceding steps beginning at step "d" for both projects libvorbis_static and libvorbisfile.

Copy Ogg and Vorbis files to CWE

1. Copy the ogg and vorbis include directories into "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\xiph\include". It is okay to let it overwrite.
2. Copy the "libogg-1.3.2\win32\VS2010\Win32\Release" and "Debug" directories into "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\xiph\lib"
3. Copy the "libvorbis-1.3.6\win32\VS2010\Win32\Release" and "Debug" directories to "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\xiph\lib"

Directory structure in the CWE tree will look like this:

  StaticSDKs
    win32
      xiph
        include
          ogg
          vorbis
        lib
          Debug
          Release

Speex

Rebuild the Speex 1.0.1 included in the CWE tree.

1. Open CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\speex-1.0.1\win32\libspeex\libspeex.sln in the Visual Studio 2010 IDE, and convert.
2. Click on configuration drop-down on the upper left and select "Release"
3. Right click on project in the solution explorer and select properties.
4. In the panel that opens, set (or verify) the following items as follows:

   Left Pane	Right pane parameter	Right pane value (drop down)
   Configuration Properties -> General	Whole Program Optimization	No Whole Program Optimization
   C/C++ -> Optimization	Whole Program Optimization	No
   C/C++ Code Generation	Runtime Library	Multi-threaded DLL (/MD)

5. Click on "Apply".
6. Click on configuration drop-down on the upper left of the properties page and select "Debug". Set (or verify) the following items as follows, noting that the 3rd item is not the same as in the previous list.

Left Pane	Right pane parameter	Right pane value (drop down)
Configuration Properties -> General	Whole Program Optimization	No Whole Program Optimization
C/C++ -> Optimization	Whole Program Optimization	No
C/C++ Code Generation	Runtime Library	Multi-threaded Debug DLL (/MDd)

7. Click "Apply" and then "OK".
8. On the IDE toolbar, select "Release" from the drop down. then right click on the project in the solution explorer and select "Build".
9. On the IDE toolbar, select "Debug" from the drop down. then right click on the project in the solution explorer and select "Build".
10. Copy the headers (.h files) from CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\speex-1.0.1\libspeex to CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\xiph\include\speex
11. Copy CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\speex-1.0.1\win32\libspeex\Release\libspeex.lib to CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\xiph\lib\Release
12. Copy CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\speex-1.0.1\win32\libspeex\Debug\libspeex.lib to CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\xiph\lib\Debug

OpenSSL

Compile and install OpenSSL (see Build OpenSSL with MS Visual C++), or obtain precompiled binaries (32-bit, not 64-bit).

As this is security software, it is best (in my opinion) to compile it yourself from source. You can choose either static or dynamic linking. Note: If you link it dynamically, it will cause the Uru client to require the OpenSSL DLLs to be present in the client directory or in the system path.

Copy the installed OpenSSL files to "CWE\MOULOpenSourceClientPlugin\StaticSDKs\Win32\OpenSSL".

Directory structure in the CWE tree will look like this:

  StaticSDKs
     Win32
       OpenSSL
         bin
         include
           openssl
         lib

JPEG

Build in-tree JPEG library

1. Open "Visual Studio Command Prompt (2010)" and change to the "CWE-ou\MOULOpenSourceClientPlugin\StaticSDKs\XPlatform\jpeg-8c-rgba directory."
2. Copy makefile.vc to makefile.nmake
3. Copy jconfig.vc to jconfig.h
4. Run nmake nodebug=1 -f makefile.nmake. This will build the library in non-debug mode. If you use a debug library, the linker will complain when we link the client executable.

zlib and libpng

Build zlib and libpng

1. Extract the files in the zlib archive to MOULOpenSourceClientPlugin/StaticSDKs/XPlatform/zlib.
2. Extract the files in the libpng archive to MOULOpenSourceClientPlugin/StaticSDKs/XPlatform/png.
3. Open png/projects/vstudio/vstudio.sln in the Visual Studio 2010 IDE.
4. The VS2010 zlib project file distributed in the png archive is set to build for embedded environments. We need to reconfigure it.
1. Right click on the zlib project tree in the solution explorer.
2. Select Add -> Existing item
3. Browse to the zlib source directory (CWE\MOULOpenSourceClientPlugin\StaticSDKs\XPlatform\zlib) and select the gzlib.c, gzclose.c, gzread.c, and gzwrite.c files (hold Ctrl while clicking to select multiple files).
4. Click "Add".
5. Right click on the zlib project and select Properties.
6. Open 'Configuration Properties > C/C++ > Preprocessor
7. Remove the Z_SOLO directive from Preprocessor Directives - Do this for both the LIB Release and LIB Debug configurations.
5. Right-click on the “libpng” project in the Solution Explorer and choose Properties.
6. Select configuration “LIB Debug” in the popup menu at the top.
7. Select Configuration Properties > C/C++ and set Treat Warnings As Errors to No
8. Select Configuration Properties > C/C++ > Code Generation on the left.
9. Change the Runtime Library line to “Multi-threaded Debug DLL (/MDd)”.
10. Select "C/C++ -> Optimization" in the left pane, and set "Whole Program Optimization" in the right pane to "No".
11. Choose the “LIB Release” configuration and set Runtime Library to “Multi-threaded DLL (/MD)”.
12. Repeat the above 7 steps for the other two projects “pngtest” and “zlib”.
13. Select “LIB Debug” from the Solution Configurations popup menu in the toolbar, then Build > Build Solution.
14. Select the “LIB Release” configuration and build the solution.
15. Rename png/projects/vstudio/Debug Library/libpn16.lib to libpngd.lib and copy it to CWE\MOULOpenSourceClientPlugin\StaticSDKs\XPlatform\png\lib
16. Rename png/projects/vstudio/Release Library/libpn16.lib to libpng.lib and copy it to CWE\MOULOpenSourceClientPlugin\StaticSDKs\XPlatform\png\lib
17. Rename png/projects/vstudio/Debug Library/zlib.lib to zlibd.lib and copy it to CWE\MOULOpenSourceClientPlugin\StaticSDKs\XPlatform\zlib\lib
18. Copy png/projects/vstudio/Release Library/zlib.lib to CWE\MOULOpenSourceClientPlugin\StaticSDKs\XPlatform\zlib\lib

Required source code changes for newer version of DirectX SDK

Since we are using a newer version of the DirectX SDK (which supports Visual Studio 2010 Express), we will need to change the source code slightly. We are not changing this in the source tree, since OpenUru is still using the original libraries and VS2003.

• In file "CWE\MOULOpenSourceClientPlugin\Plasma20\Sources\Plasma\PubUtilLib\plPipeline\plDXPipeline.cpp":
  Change "#include <dxerr9.h>" to "#include <dxerr.h>"
  Change "DXGetErrorString9" to "DXGetErrorString"
  


• In file "CWE\MOULOpenSourceClientPlugin\Plasma20\Sources\Plasma\PubUtilLib\plAudio\plWavFile.cpp":
  Change "#include <dxerr9.h>" to "#include <dxerr.h>"


• In file "CWE\MOULOpenSourceClientPlugin\Plasma20\Sources\Plasma\PubUtilLib\plAudio\plEAXEffects.cpp":
  Remove the "#include <dmusici.h>" line
  Change "#include <dxerr9.h>" to "#include <dxerr.h>"

Required source changes for Visual Studio 2010 Express

• We do not have MFC with VS2010 SP1 Express, so we need to replace the first reference to afxres.h. The client portion of CWE does not use MFC (I believe the MAX plugin does), so we can make this replacement.

Note: If you are compiling with VS2010 Professional or greater, you do *not* need to make these edits. Only the Express edition excludes MFC.


• Edit plClient.rc file located in "CWE\MOULOpenSourceClientPlugin\Plasma20\Sources\Plasma\Apps\plClient\res\"
  Before
  

  // Microsoft Visual C++ generated resource script.
  //
  #include "resource.h"
  
  #define APSTUDIO_READONLY_SYMBOLS
  /////////////////////////////////////////////////////////////////////////////
  //
  // Generated from the TEXTINCLUDE 2 resource.
  //
  #include "afxres.h"
  

  After
  

  // Microsoft Visual C++ generated resource script.
  //
  #include "resource.h"
  
  #define APSTUDIO_READONLY_SYMBOLS
  /////////////////////////////////////////////////////////////////////////////
  //
  // Generated from the TEXTINCLUDE 2 resource.
  //
  //#include "afxres.h"
  
  #include <windows.h>
  #define IDC_STATIC (-1)
  

• edit plUruLauncher.rc file located in "CWE\MOULOpenSourceClientPlugin\Plasma20\Apps\plUruLauncher.rc"
  This is the same change we just made in the previous file.
  Before
  

  // Microsoft Visual C++ generated resource script.
  //
  #include "resource.h"
  
  #define APSTUDIO_READONLY_SYMBOLS
  /////////////////////////////////////////////////////////////////////////////
  //
  // Generated from the TEXTINCLUDE 2 resource.
  //
  #include "afxres.h"
  

  After
  

  // Microsoft Visual C++ generated resource script.
  //
  #include "resource.h"
  
  #define APSTUDIO_READONLY_SYMBOLS
  /////////////////////////////////////////////////////////////////////////////
  //
  // Generated from the TEXTINCLUDE 2 resource.
  //
  //#include "afxres.h"
  
  #include <windows.h>
  #define IDC_STATIC (-1)
  

Build the client

Now that the prep is done, you can actually build the client.

1. Open the "CWE\MOULOpenSourceClientPlugin\Plasma20\MSVC10Projects\Plasma\Apps\AllClient\AllClient.sln" in the VS2010 IDE.
2. Select the type of build you want from the dropdown on the IDE toolbar.
   • Release
   • Release_Internal
   • Debug
   • Debug_Internal
3. Right click on the "AllClient" project and select "Build".

Completed builds are copied into the "CWE\MOULOpenSourceClientPlugin\Plasma20\test" directory.
Note: You *must* make sure your client is using the same versions of the PhysX DLLs that you built with. They are not compatible from version to version.

If, after building the client, you require the server prep tools (plFileSecure, plFileEncrypt, plPythonPak), right click on those specific projects and click "Build".
The compiled files will be copied into the "CWE\MOULOpenSourceClientPlugin\Plasma20\tools" directory.