MSVC Install
From Peragro Tempus Wiki
Introduction
If you are just wanting to play the game, please look here
for the windows binary install: [1]
If you are wanting to build Peragro Tempus from scratch so you can play with the code,
then this guide is for you! :)
Directory Structure
Create the following directory structure:
C:\peragro C:\peragro\cs C:\peragro\cel C:\peragro\peragro C:\peragro\boost
Setting the Environmental Variables
In Windows XP:
Open the Start Menu->Control Panel->System->Advanced Tab->Environment Variables Button
Click the New button under User Variables and add the variables listed below.
In Windows Vista:
Open the Start Menu->Control Panel (in Classic View)->System
Click Advanced System Settings Link on the left->Advanced Tab->Environment Variables Button
Click the New button under User Variables and add the variables listed below.
The variables and their values are:
CRYSTAL = C:\peragro\cs
CEL = C:\peragro\cel
BOOST = C:\peragro\boost
Download and Install Microsoft Visual Studio C++ 2008
The free edition (Express Edition) can be downloaded from http://www.microsoft.com/express/download/.
Download and Install the Microsoft Windows SDK
The links available for the latest Microsoft Windows SDK's can be found here: [2]
If you are using Windows 2000, you will need the Windows Platform SDK. Choose either the ISO download or the full download as needed:
Windows® Server 2003 R2 Platform SDK ISO Download: [3]
Windows® Server 2003 R2 Platform SDK Full Download: [4]
Download and install TortoiseSVN
Goto http://tortoisesvn.tigris.org/ then download and install the latest version of tortoisesvn.
In order to checkout files, open your file explorer and right click on the directory where you want to checkout the revision to.
Select "SVN Checkout..." from the menu.
Make sure to specify the revision and the URL.
The checkout directory should be filled in already.
Download CS
Checkout the head revision to C:\peragro\cs
URL of Repository: https://crystal.svn.sourceforge.net/svnroot/crystal/CS/trunk
Download CEL
Checkout the head revision to C:\peragro\cel
URL of Repository: https://crystal.svn.sourceforge.net/svnroot/cel/cel/trunk/
Download Peragro
Checkout the head revision to C:\peragro\peragro
URL of Repository: https://cyanox.nl/peragro/
Download Boost
Goto http://sourceforge.net/project/showfiles.php?group_id=7586 and download the latest version of Boost in .zip format.
Unzip it into the "C:\peragro\boost" directory.
For your convenience, Boost's homepage is at [5], but is not required for the guide.
Download and install cswinlibs via binary
Goto http://www.crystalspace3d.org/downloads/cs-win32libs and download the latest exe file.
Run the executable you downloaded and use the defaults. Make sure you have VC support selected.
Build Boost
Download bjam (https://sourceforge.net/project/downloading.php?group_id=7586&use_mirror=surfnet&filename=boost-jam-3.1.16-1-ntx86.zip&97085531)
and extract 'bjam.exe' from the archive in C:\peragro\boost
Do start -> run -> cmd to open a command line and do 'cd C:\peragro\boost'
Then do 'bjam --toolset=msvc link=static stage'
If you're building in debug also do 'bjam --toolset=msvc link=static debug stage'
If you have a dual, quad or more core cpu and want to take advantage of that then add -j #numberOfCores to the command line (e.g. -j4)
Setup the MSVC settings
Open Microsoft Visual Studio C++ 2008 here or in the next step and perform the following:
In the program menu, select Tools->Options...->Projects and Solutions->VC++ Directories
Select the dropdown box titled: Show Directories for:
Change the dropdown box to: Include files
Add the following lines:
$(BOOST)
$(CRYSTAL)\win32libs\include
Select the dropdown box titled: Show Directories for:
Change the dropdown box to: Library files
Add the following lines:
$(BOOST)\stage\lib
$(CRYSTAL)\win32libs\lib
$(CRYSTAL)\out\debug9\libs\Win32
Make sure to change "debug9" above, to your version number.
For MSVC 2003, use debug71.
For MSVC 2005, use debug8.
For MSVC 2008, use debug9.
Click OK.
Build CS
Open C:\peragro\cs\mk\msvc9\wkstypical.sln with Microsoft Visual Studio C++ 20008
Goto Build->Build Solution
Build CEL
Open C:\peragro\cel\msvc\9\wkscel.sln with Microsoft Visual Studio C++ 20008
Goto Build->Build Solution
Build Peragro
Open C:\peragro\trunk\msvc\9\wksall.sln
Goto Build->Build Solution
Copy the DLLs
Copy the following files into the c:\peragro\peragro\trunk directory:
C:\peragro\cs\crystalspace-1.9-vc9_d.dll
C:\peragro\cs\libCEGUIBase-csvc9_d.dll
C:\peragro\cs\libfreetype2-cs.dll
C:\peragro\cs\libz-cs.dll
C:\peragro\cel\celtool-1.9-vc9_d.dll
These need to be copied because if they are not there, it will generate an error when running such as:
client.exe - Unable to Locate Component: This application has failed to start because libz-cs.dll was not found.
If there are any other errors like this, copy those dlls as well.
Appendix A: Running a Local Server (Optional)
Make sure to run a local server (appserver) if you are using the latest version of svn for your client (appclient).
The PT server may not always be compatible with the latest version of the svn.
If you want to see which svn version to use that is compatible with the PT server, too bad! That information isn't published yet. :)
When you first run your own local server, complete the following (in this order):
Register your username on the client.
Click the login button.
Click the setup server button.
Click the Upload Server Data button.
Click Done.
Create your character.
Select your character.
Click the OK button. (This will begin the login process to the local server).
Appendix B: Other Information
The database is located at c:\peragro\peragro\msvc\9\test_db.sqlite
The database can be safely deleted if you need to reset all the player data (such as usernames and locations).
The client log is located at c:\peragro\peragro\msvc\9\peragro.log
The client cegui log is located at c:\peragro\peragro\msvc\9\CEGUI.log
There is no server log currently.
