summaryrefslogtreecommitdiff
path: root/docs/INSTALL/win32.txt
blob: 64e8a2390dfc4b501271aca8034b444c4756ad7e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
How setup Dev-C++ to compile TMW on a Win32 Box
===============================================

The Mana World project
======================
Homepage: themanaworld.sourceforge.net
IRC:      irc.freenode.net / #manaworld


0. Index
========
1. Requirements
2. Installing Dev-C++
3. Installing the required libraries
4. Compiling The Mana World


1. Requirements
===============

In this tutorial we will use DevC++ because of the fact that it's a very good
free IDE for Win32 built around GCC. Remember, Win32 was not meant for GCC and
stuff so you will probably run into trouble unless you really know what you're
doing, so best stick with Dev-C++.

Besides a C++ compiler, TMW depends on the following libraries:

1) Allegro 4.1.x
2) Alfont  1.91
3) JGmod 0.99
4) Guichan 0.1.0-CVS


2. Installing Dev-C++
=====================

I recommend that you get the latest beta version, which is 4.9.9.1 at the time
of writing. Though this tutorial is written for and tested with that, it may
also apply to the latest stable version. Get Dev-C++ here:

  http://www.bloodshed.net/
  
After you fetched it simply run and install.


3. Installing the required libraries
====================================

Lucky for us, all the libs have DevPaks that are very easy drop-ins for
Dev-C++, without any complex actions on your side. We'll download them from
http://devpaks.org/.

Because Guichan can work with SDL as well as Allegro, and because we plan to
switch to SDL anyway, we'll install SDL and SDL_image too, even though TMW
doesn't require them at this time.

Get the following list of DevPaks:

- Allegro       (http://devpaks.org/show.php?devpak=2)
- AllegroFont   (http://devpaks.org/show.php?devpak=88)
- JGMOD         (http://devpaks.org/show.php?devpak=121)
- SDL           (http://devpaks.org/show.php?devpak=57)
- SDL_image     (http://devpaks.org/show.php?devpak=25)
- Guichan       (http://guichan.darkbits.org/downloads/guichan.DevPak)

Install them all through the Dev-C++ package manager.

NOTE: At the time of writing there is a problem with the SDL_image package.
You need to solve this by downloading the file SDL_image-devel-1.2.3-VC6.zip
from the link below and extracting from it the SDL_image.lib file and put that
in your Dev-C++ lib directory.

  http://www.libsdl.org/projects/SDL_image/

You should now be fully equipped for compiling the latest TMW CVS code!


4. Compiling The Mana World
===========================

Check out The Mana World from CVS using either the command line cvs tool or
TortoiseCVS, pick what you like to use most and install that. Next, check out
the tmw module from our repository. The CVSROOT is:

  :pserver:anoncvs@sull.homelinux.net:/var/home/cvs/repository

Open "The Mana World.dev" in Dev-C++. From there on you should be able to
start compilition with Excute -> Compile. A file called tmw.exe should appear
in the same directory as where you opened the .dev from.

Before you can actually run the executable you may need to move a few DLLs over
from your Dev-Cpp/dll directory to the directory containing tmw.exe. The
currently required DLLs are alleg41.dll, guichan.dll and guichan_allegro.dll.

Have fun hacking The Mana World!