path: root/INSTALL

How to compile and run TMW on your GNU/Linux Box
================================================

Homepage:  http://themanaworld.org/
IRC:       irc.freenode.net / #themanaworld

1) Requirements
2) Compiling The Mana World
3) Notes


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

You are expected to have either checked out TMW from CVS or you have downloaded
a source release. To get The Mana World to compile, you need a compiler (GCC)
and some libraries. The required libraries are:

* SDL               http://www.libsdl.org/
* SDL_mixer         http://www.libsdl.org/projects/SDL_mixer/
* SDL_image         http://www.libsdl.org/projects/SDL_image/
* SDL_net           http://www.libsdl.org/projects/SDL_net/
* Guichan 0.8.x     http://guichan.sourceforge.net/
* libxml2           http://www.xmlsoft.org/
* physfs 1.0.x      http://icculus.org/physfs/
* zlib 1.2.x        http://www.gzip.org/zlib/
* libcurl           http://curl.haxx.se/libcurl/

If you checked TMW out from Subversion you will also need these tools to
compile:

* GNU automake 1.9  http://www.gnu.org/software/automake/
* GNU autoconf      http://www.gnu.org/software/autoconf/

Installing these dependencies is distributions-specific, and we'll leave it to
you to figure this out.


2. Compiling And Installing The Mana World
==========================================

1) Go to the directory you have extracted the source to.
2) If you checked out from SVN, run "./autogen.sh" to generate configure.
3) Run "./configure"
4) Run "make"
5) Run "make install" as root

It should have installed The Mana World on your system now, and you can run it
with "tmw". By default all files are installed to /usr/local, you can pass a
different prefix to configure as usual.


  NOTE: It is possible to compile TMW without support for OpenGL rendering.
  To do this perform step 3 as follows:

    ./configure --without-opengl

  Rebuild the executable from scratch using "make clean" and then "make".


3. Notes
========

If you have any problems, you are welcome to post your questions on our forums,
or talk about them in our IRC channel.

- The Mana World Dev Team