This is a short guide for compiling The Mana World on Ubuntu. This guide is based on a similar guide by Platyna, that was on the TMW forums.

Note: The contributors to, and the creators of this guide disclaim all warranties and liabilities, and are not responsible for any damages/problems related to following the instructions in this guide.

Ubuntu 8.04 (Hardy Heron)

Hardy Heron currently has guichan 0.7.1, which is incompatible with the current build of The Mana World, so you need to do a little bit extra, including a local install, to get these compiled.

Open a terminal and follow the following directions:

To grab the dependencies required for compiling and installing, run this command:

 sudo apt-get install build-essential libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-net1.2-dev libsdl1.2-dev

Then run this to get the rest of the dependencies (except for guichan):

 sudo apt-get install libphysfs-dev zlib1g-dev libxml2-dev libcurl4-gnutls-dev libsdl-ttf2.0-0 libsdl-ttf2.0-dev

Now run this to get the source code for guichan 0.8.1:

 wget http://guichan.googlecode.com/files/guichan-0.8.1.tar.gz

Then run this to get the source code out of the tarball:

 tar -vzxf guichan-0.8.1.tar.gz

After that, you will need to make the directories we need for the local install. To do this, run this command:

 cd ~ && mkdir .programs && mkdir .programs/tmw && mkdir .programs/tmw/.src

For the sake of keeping organized, let's move the source code and its tarball to the .src folder that you just made:

 mv guichan.0.8.1.tar.gz .programs/tmw/.src && mv guichan.0.8.1 .programs/tmw/.src

Now it's time to enter the folder containing guichan, by using this command:

 cd .programs/tmw/.src/guichan-0.8.1

Then get the source code ready to be compiled on your system by using this command:

 ./configure --prefix=$HOME/.programs/tmw

The above command will also tell the source code to be installed to directory stated after --prefix=

Now run this to compile guichan:

 make

After that is done, run this to install it:

 make install

Now that Guichan is installed, it's time to compile The Mana World.

Go back to your home directory by using this command:

 cd ~

Use this command to get the source code for The Mana World:

 wget http://downloads.sourceforge.net/themanaworld/tmw-0.0.29.1.tar.gz

Now, it's time to get the source code from the tarball you downloaded, run this command:

 tar -vzxf tmw-0.0.29.1.tar.gz

Now let's move them into where we are storing the source code by using these commands:

 mv tmw-0.0.29.1.tar.gz .programs/tmw/.src && mv tmw-0.0.29.1 .programs/tmw/.src

After that, you will need to enter the directory where you just moved the source code, by using this command:

 cd .programs/tmw/.src/tmw-0.0.29.1

Then run this to tell The Mana World where guichan is located, so that it compiles properly:

 export LDFLAGS="$LDFLAGS -L$HOME/.programs/tmw/lib"

Then run:

 export CPPFLAGS="$CPPFLAGS -I$HOME/.programs/tmw/include"

The above command also tells The Mana World where guichan is located, and is required along with the command above it.

Now, it's time to get The Mana World ready to be compiled, by running this command:

 ./configure --prefix=$HOME/.programs/tmw --with-server=eathena

Afterwards, run this to compile The Mana World:

 make

And finally, run this to install it:

 make install

Then run this command to return to your home directory:

 cd ~

Because we had to install The Mana World locally, you must now copy the following shell script into a text editor, and save it as "tmw.sh" to your home folder:

 # This is the tmw STABLE run script, for version 0.0.29.1 of tmw
 # This script is licensed under the GPL v.2
 # The contributors and creators to/of this script disclaim
 # all warranties and liability, and are not responsible for damages/losses
 # of any kind.
 # bash is required for this script.
 export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/.programs/tmw/lib && $HOME/.programs/tmw/bin/tmw

Now run this command in a terminal to make the shell script executable:

 chmod u+x tmw.sh

Now you can run The Mana World by opening a terminal and simply typing this:

 ./tmw.sh

Good luck, and have fun playing The Mana World! :)

Ubuntu 8.10 (Intrepid Ibex) and Ubuntu 9.04 (Jaunty Jackalope)

Intrepix Ibex and Jaunty Jackalope currently have guichan 0.8.1, which means that you only need to get the dependencies and compile The Mana World from source.

Open a terminal and follow the following directions:

To get the tools needed to compile a program from source, run this code:

 sudo apt-get install build-essential

This will get the programs required to compile source code.

Then run:

 sudo apt-get build-dep tmw

This will get the dependencies for The Mana World.

Now that that's done, it's time to compile The Mana World from scratch.

Run this command:

 wget http://downloads.sourceforge.net/themanaworld/tmw-0.0.29.1.tar.gz

This will download The Mana World's source from the website that hosts our source code, SourceForge.net.

Then you need to run this:

 tar -vzxf tmw-0.0.29.1.tar.gz

That will extract the source code from the tarball that you downloaded from the Internet.

After that, run this:

 cd tmw-0.0.29.1

That will make your terminal window move it's focus from your home folder (~) to the folder that contains The Mana World's source code.

Now run this:

 ./configure --with-server=eathena

That will configure the source code and make it get ready to be compiled on your system.

Then, run this:

 make

This command will compile the source code, and get it ready to be installed.

After that finishes, run this:

 sudo make install

That will install The Mana World on your system, and you can run it by simply typing this into a terminal window:

 tmw

Good luck, and have fun! :)