Newbie's little guide to compiling & running the client

[Newbie]

Let's start with things you will have to download:

Code::Blocks -- http://www.codeblocks.org/downloads/5 -- take the one with mingw in it
The Mana World DevPack --choose package for either old client (0.0.x) or new client (0.1.x) -- has all the needed libraries, headers and whatnot. (More info in here)
TortoiseSVN -- http://tortoisesvn.net/downloads


========== TortoiseSVN & source code ==========

Now install TortoiseSVN. Reboot if necessary.
With Tortoise you'll be able to downloaded the latest version of the client's source code.
After you have installed Tortoise open up My Computer and go to directory you where you want to download the source code.

Now right click the background and choose "SVN Checkout" from the list. Tortoise will pop up window and ask for url for repository.
Now you have got 2 options:

• 1. repository for 0.0.x version of client insert: https://themanaworld.svn.sourceforge.ne ... nches/0.0/

• 2. repository for 0.1.x version of client insert: https://themanaworld.svn.sourceforge.ne ... tmw/trunk/

Insert one of above urls and click "OK" and for files to download...
Click "OK" again and you're done downloading the source code.


========== DevPack ==========

Next thing you want to do is download the DevPack.
Again you have got two options. Choose the same version as you did when you downloaded source code.

• 1. DevPack for 0.0.x version of client http://themanaworld.org/files/tmw-svn-0.0.x.tar.bz2

• 2. DevPack for 0.1.x version of client http://themanaworld.org/files/tmw-svn.DevPak

Download the file and rename it's extension from ".DevPak" to ".tar.bz2" (if it is not already). Now you are able to extract it with Winrar.
OK, after it has been extracted let's leave it as it is for a while.


========== Configuring Code::Blocks ==========

Next you'll have to download Code::Blocks ( C++ IDE ). Go on, download and install it :p.
Now open up Code::Blocks and click File -> Open (or just click CTRL + O) from the menu.
Go to the directory where you downloaded the source code. Select file called as "tmw.cbp" and press Open.
Mmmkay..Now you have opened the project in Codeblocks and everything is fine so far.
Next thing you have to do is tweak Codeblocks search directories. Don't worry, there's not much to do :p

In Codeblocks top menu click Settings -> Compiler and debugger..
It pops up a window with lots of stuff in it. Click "Search directories" tab open.
Now you should see "Compiler" tab open. You're now going to show Codeblocks where to search for necessary header files.

Click "Add" and type path to extracted DevPack and add "\include" to the path so it will look
something like this: "C:\TMP\tmw-svn\include". Click "OK".
Then add another path: "<path to extracted DevPack>\include\SDL" (i.e "C:\TMP\tmw-svn\include\SDL")

Now you're done with the Compiler search directories, next you'll have to add one path to Linker's search directories.
Open "Linker" tab. Again add a new path: "<path to extracted DevPack>\lib" (i.e "C:\TMP\tmw-svn\lib")


========== Compiling ==========

Finally done with the settings. Not much left anymore. Click "OK" button to close the settings window.
Now we're going to _try_ to compile it and see if it works. Click Build -> Build (or press CTRL + F9) to start compiling.
ERROR!! AAARRRRRRRGGHHHHH!! CRAAWLING INN MY SKIIIIIINNN...erm..
Ok now, DON'T PANIC.
If the error message comes from file "key.hpp" we know the fix for it.
Open up Windows Explorer and go to the directory where you extracted DevPack, now continue to \tmw-svn\include\guichan directory.
Open file key.hpp in your favorite text / code editor and paste these three lines just after "#include..." statement:

Code: Select all

#ifdef DELETE
#undef DELETE
#endif

You should end up from this:

Code: Select all

#ifndef GCN_KEY_HPP
#define GCN_KEY_HPP

#include "guichan/platform.hpp"

namespace gcn

to this:

Code: Select all

#ifndef GCN_KEY_HPP
#define GCN_KEY_HPP

#include "guichan/platform.hpp"

#ifdef DELETE
#undef DELETE
#endif

namespace gcn

Save the key.hpp

Now try to compile (from menu click Build -> Build or press CTRL + F9) the project again, it should work now.
When compiling is done you should see tmw.exe in the same directory where you downloaded the source code.


========== Copying necessary files for running tmw.exe ==========

Now create a directory where you want to have the complete game "installed".
Copy the following files to that directory:

• - tmw.exe from source code directory

• - data-folder from source code directory

• - and all dll files from the DevPack's dll directory (i.e C:\TMP\tmw-svn\dll).

And now the time has come, run tmw.exe!

========== Useful links ==========

• Thread dedicated to DevPack: http://forums.themanaworld.org/viewtopic.php?f=6&t=431

• SVN url for data repository: https://themanaworld.svn.sourceforge.ne ... ata/trunk/

• Wiki, read it! http://wiki.themanaworld.org/index.php/Main_Page

Hope this will help someone.

Update 1: Added old client and tried to make a bit more readable

[Crush]

Thanks for writing the guide. There is just one thing I would suggest you to add: The SVN urls for the old client and the data repository.

[Newbie]

Thanks for writing the guide. There is just one thing I would suggest you to add: The SVN urls for the old client and the data repository.

I'll update it to include also the old client when I've got a bit more time.

[ElvenProgrammer]

Actually the latest dependencies package is: http://themanaworld.org/files/tmw-svn-0.0.x.tar.bz2

[raver2008]

it's not connecting but everything else worked^^

[ElvenProgrammer]

it's not connecting but everything else worked^^

Yep the server was offline for some time

[Newbie]

Actually the latest dependencies package is: http://themanaworld.org/files/tmw-svn-0.0.x.tar.bz2

So it is not only for 0.0.x branch?

New release of the dependancy package:

http://themanaworld.org/files/tmw-svn-0.0.x.tar.bz2

Since we're no more officially supporting Dev-Cpp, here it is a normal compressed package.

This package is specific to 0.0. branch.

I'll create a trunk/tmwserv package later.

Changelog:

[Crush]

No Enet (needed for 0.1.0 and server) or Pthread (needed for server) in there.

[leeor_net]

Nicely done. Two things though:

1) I would mention that this is pretty much Win32 specific.
2) Convert this into a Wiki article and post a link to that.

[Newbie]

Nicely done. Two things though:

1) I would mention that this is pretty much Win32 specific.
2) Convert this into a Wiki article and post a link to that.

1) Well this is "Windows support" area afterall.
2) Might do that when I've got some energy to do anything useful :p

[leeor_net]

1) Well this is "Windows support" area afterall.

True but I can't tell you how often people tend to forget that. (BTW, not necessarily on this forum but you really need to make things specific or you're going to get a lot of confused people asking a lot of 'dumb' questions).

[Habari]

thx for your help

[Landon]

I tried it the way the instructions was laid out and get 40 errors and 2 waRNINGS

[ElvenProgrammer]

I tried it the way the instructions was laid out and get 40 errors and 2 waRNINGS

Can you provide the compiler log so that we could maybe fix the situation?

[Landon]

never mind I figured it out, thanks.