Guide to Compiling CVS Source with VS .NET 2003

[ajb20]

Hey all. I realized there hasn't been an updated guide to compiling in a while so I decided it was time to write one up. So here we go from the top.

First off, You will need a CVS Client. I prefer Tortoise CVS which you can get here (http://prdownloads.sourceforge.net/tortoisecvs/TortoiseCVS-1.8.1.exe).

After installing, right click on the folder you want to download the CVS files to and than click on CVS Checkout.

http://www.hypershadow.net/legends/images/tutorial/1.JPG

The screen that follows requires the following information:
Protocol: Password server [:pserver:]
Protocol Parameters: Leave blank
Server: cvs.sourceforge.net
Port: Leave blank
Repository Folder: /cvsroot/eqemulator
User Name: anonymous
Module: EqEmuCVS

http://www.hypershadow.net/legends/images/tutorial/2.JPG

Once this is all entered, click OK and go find something to do for a bit if you are on a slow connection as it will download all the pre-compiled version, sql files, and source files for the latest update.

Ok so CVS checkout is complete. Now go searching for that nice little folder you did the checkout to (I usually checkout to desktop for simplicity) and you should see a folder named EQEmuCVS. That's that one you want :)

http://www.hypershadow.net/legends/images/tutorial/3.JPG

Inside the folder you will want to open the folder named "Source" and than open Server.dsw.

http://www.hypershadow.net/legends/images/tutorial/4.JPG

When it opens, click "Yes to all" to convert the project.

You should now have something similar to below up:

http://www.hypershadow.net/legends/images/tutorial/5.JPG

(OPTIONAL)Now if you want to install Perl (optional) you will need to do the next steps, otherwise you can skip ahead passed the optional steps.

click the + next to zone to expand the listing of files.

http://www.hypershadow.net/legends/images/tutorial/6.JPG

(OPTIONAL)Now right click on Source Files and go to "Add>" "Add Existing Item".

http://www.hypershadow.net/legends/images/tutorial/7.JPG

(OPTIONAL)You should by default be browing the "zone" folder at this point. You need to search for and add these 3 files:
embperl.cpp
embparser.cpp
embxs.cpp

http://www.hypershadow.net/legends/images/tutorial/8.JPG

(OPTIONAL)After you have completed this, do the same process over again using header files this time.

http://www.hypershadow.net/legends/images/tutorial/9.JPG

(OPTIONAL)The 3 files you need to add this time are:
embperl.h
embparser.h
embxs.h

http://www.hypershadow.net/legends/images/tutorial/10.JPG

(OPTIONAL)Now you need to right click on zone iteself and select "Properties".

http://www.hypershadow.net/legends/images/tutorial/11.JPG

(OPTIONAL)Select the C++ folder and the Preprocessor Options from the window that pops up.

http://www.hypershadow.net/legends/images/tutorial/12.JPG

(OPTIONAL)Change the configuration to "Release" and ensure that the platform is either Win32 or Active(Win32).

http://www.hypershadow.net/legends/images/tutorial/13.JPG

(OPTIONAL)Now highlight "Preprocessor Definitions" and click on the button that appears to the right. A window with the definitions should pop up.

http://www.hypershadow.net/legends/images/tutorial/14.JPG

(OPTIONAL)Scroll to the bottom of the list and add the following:
EMBPERL
EMBPERL_PLUGIN

http://www.hypershadow.net/legends/images/tutorial/15.JPG

(OPTIONAL)Click OK to close the current window, and than click Apply and OK to save the settings and close the Zone Properties window.
----------------------------------------------------END PERL CONFIGURATION

Now one last step and you are ready to compile. The rest holds true regardless if you are compiling a Perl enabled source or not.

Click the "Solution Configurations" drop-down menu and select Release.

http://www.hypershadow.net/legends/images/tutorial/16.JPG

Now Select the Build menu and select "Build Solution".

http://www.hypershadow.net/legends/images/tutorial/17.JPG

At this point sit back and read a good book cause it will take a few minutes :)


Hopefully if everything worked, you will see this message:
---------------------- Done ----------------------

Build: 3 succeeded, 0 failed, 0 skipped

At this point you can close VS .NET.

Now browse back to the EqEmuCVS folder that we started in. In the "Source" folder there should be a new folder named "Build" present now. It will most likely have a ?/folder icon if you are using Tortoise CVS.

http://www.hypershadow.net/legends/images/tutorial/18.JPG

Inside this folder you will find:
zone.exe
world.exe
EMuShareMem.dll

These are the 3 files you need to copy and paste into your EqEmu directory.

http://www.hypershadow.net/legends/images/tutorial/19.jpg

At this point you are all set to go if you already have your .ini files configured. There are plenty of tutorials about that can walk you through setting up the server from this point :)

Hopefully I didn't leave anything out but I am sure this will be edited a couple times in the near future.

[sgaske24]

You left a few important parts out :(.

The most important are the include files needed to build EQemu - Zlib is needed as well as include files for mysql. If you are going to build with perl you also need to have perl installed properly before you attempt to build.

Admittedly I'm too lazy to search around for the links, but you can find the links to what you need through the "How to compile with VS.NET Trial" tutorial in the tutorial/howto forum, its stickied so anyone who looks should find it easily.

Other than those important points this is a nice tutorial, it's nice to see something that is up to date for a change!

EDIT: Almost forgot - if you look at the tutorial for compiling via the VS.NET Trial in the Tutorial/Howto forum, it explains what to do with the mysql include files and Zlib.

-GM Thrax

[ajb20]

Ya I was thinking about that earlier this morning that I didn't have any include libraries and how to do them. I will add that to the tutorial when I get a chance :)

[hypershadow66]

it is compiling fine and i did every step yet when i run boot5zones it loads fine except theres no message saying it loaded perl..