Newbie's little guide to compiling & running the client

Ask for help regarding any technical issue or report any bug or OS independent issues.
Newbie
Peon
Peon
Posts: 12
Joined: 16 Mar 2008, 18:59

Newbie's little guide to compiling & running the client

Post by Newbie » 17 Mar 2008, 14:20

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: 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. 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 ==========

Hope this will help someone.

Update 1: Added old client and tried to make a bit more readable
Last edited by Newbie on 17 Mar 2008, 18:29, edited 1 time in total.
User avatar
Crush
TMW Adviser
TMW Adviser
Posts: 8046
Joined: 25 Aug 2005, 17:08
Location: Germany

Re: Newbie's little guide to compiling & running the new client

Post by Crush » 17 Mar 2008, 14:25

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.
  • former Manasource Programmer
  • former TMW Pixel artist
  • NOT a game master

Please do not send me any inquiries regarding player accounts on TMW.


You might have heard a certain rumor about me. This rumor is completely false. You might also have heard the other rumor about me. This rumor is 100% accurate.
Newbie
Peon
Peon
Posts: 12
Joined: 16 Mar 2008, 18:59

Re: Newbie's little guide to compiling & running the new client

Post by Newbie » 17 Mar 2008, 15:13

Crush wrote: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.
raver2008
Peon
Peon
Posts: 4
Joined: 17 Mar 2008, 16:53

Re: Newbie's little guide to compiling & running the new client

Post by raver2008 » 17 Mar 2008, 17:33

it's not connecting but everything else worked^^
User avatar
ElvenProgrammer
TMW Adviser
TMW Adviser
Posts: 2526
Joined: 13 Apr 2004, 20:11
Location: Italy
Contact:

Re: Newbie's little guide to compiling & running the new client

Post by ElvenProgrammer » 17 Mar 2008, 17:52

raver2008 wrote:it's not connecting but everything else worked^^
Yep the server was offline for some time
Newbie
Peon
Peon
Posts: 12
Joined: 16 Mar 2008, 18:59

Re: Newbie's little guide to compiling & running the new client

Post by Newbie » 17 Mar 2008, 18:32

ElvenProgrammer wrote: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?
ElvenProgrammer wrote: 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:
User avatar
Crush
TMW Adviser
TMW Adviser
Posts: 8046
Joined: 25 Aug 2005, 17:08
Location: Germany

Re: Newbie's little guide to compiling & running the client

Post by Crush » 17 Mar 2008, 18:47

No Enet (needed for 0.1.0 and server) or Pthread (needed for server) in there.
  • former Manasource Programmer
  • former TMW Pixel artist
  • NOT a game master

Please do not send me any inquiries regarding player accounts on TMW.


You might have heard a certain rumor about me. This rumor is completely false. You might also have heard the other rumor about me. This rumor is 100% accurate.
User avatar
leeor_net
Novice
Novice
Posts: 180
Joined: 03 Feb 2008, 10:17
Location: Ohio, USA
Contact:

Re: Newbie's little guide to compiling & running the client

Post by leeor_net » 17 Mar 2008, 22:53

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.
- Leeor

"Oh, no thanks. I ate a boulder on the way in." - Shrek
Newbie
Peon
Peon
Posts: 12
Joined: 16 Mar 2008, 18:59

Re: Newbie's little guide to compiling & running the client

Post by Newbie » 17 Mar 2008, 23:04

leeor_net wrote: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
User avatar
leeor_net
Novice
Novice
Posts: 180
Joined: 03 Feb 2008, 10:17
Location: Ohio, USA
Contact:

Re: Newbie's little guide to compiling & running the client

Post by leeor_net » 17 Mar 2008, 23:22

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).
- Leeor

"Oh, no thanks. I ate a boulder on the way in." - Shrek
Habari
Novice
Novice
Posts: 249
Joined: 25 Nov 2007, 17:04

Re: Newbie's little guide to compiling & running the client

Post by Habari » 26 Mar 2008, 20:37

thx for your help
User avatar
Landon
Novice
Novice
Posts: 136
Joined: 16 Jan 2008, 22:09

Re: Newbie's little guide to compiling & running the client

Post by Landon » 30 Mar 2008, 17:30

I tried it the way the instructions was laid out and get 40 errors and 2 waRNINGS
Landon
"Life is like one big screwed up Merry-Go-Round, I get thrown off but I get right back on"
User avatar
ElvenProgrammer
TMW Adviser
TMW Adviser
Posts: 2526
Joined: 13 Apr 2004, 20:11
Location: Italy
Contact:

Re: Newbie's little guide to compiling & running the client

Post by ElvenProgrammer » 30 Mar 2008, 19:56

Landon wrote: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?
User avatar
Landon
Novice
Novice
Posts: 136
Joined: 16 Jan 2008, 22:09

Re: Newbie's little guide to compiling & running the client

Post by Landon » 30 Mar 2008, 21:58

never mind I figured it out, thanks.
Landon
"Life is like one big screwed up Merry-Go-Round, I get thrown off but I get right back on"
Post Reply