Build instructions for GNU/Linux
Here are some instructions for the people that can't or don't want to use
the provided GNU/Linux binary at the client page.
CPAN Installation on Debian GNU/Linux (also with notes for ubuntu)
I am assuming here that you install Deliantra as root user. (If you don't know what
that means you should find out what it means.)
A major requirement to run Deliantra is OpenGL. And it's highly recommended to have accelerated
OpenGL. I'm sorry that it is beyond the scope of this tutorial to instruct you how to install and set up proper OpenGL acceleration.
Some minor hint: manufacturers like ATI and NVIDIA are providing Linux drivers. They have mostly
automatic installers. GNU/Linux distributions like Ubuntu also include such drivers sometimes. On top of that there might
be free driver implementations in Xorg.
Some minor mostly uninteresting note: Deliantra has been tested with recent ATI and NVIDIA graphics cards.
First we are going to install the required library dependencies, which are
(you can substitute libdb4.5-dev by libdb4.4-dev, libdb4.6-dev, or newer if you want):
root@localhost: ~# apt-get install perl libpango1.0-dev libglib2.0-dev libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libdb4.5-dev
Note: ubuntu users should try following apt-get line instead and continue with the debian part:
# apt-get install perl libpango1.0-dev libglib2.0-dev libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libdb4.5-dev anyevent-perl
Note: If you are not on Debian please be sure to satisfy following requirements:
- libpango1.0-0 and libpango1.0-dev (generally pango-1.12.3 and above with a freetype2 or cairo backend)
- libglib2.0-0 and libglib2.0-dev (generally glib-2.10 and above)
- libsdl1.2-dev (generally something around libsdl-1.2.10)
- libsdl-mixer1.2-dev
- libsdl-image1.2-dev
- libdb<version>-dev (generally versions 4.4 and up work, 4.5 and up is recommended)
Please make sure that this step was successful, as all of these libraries are mandatory to build and install Deliantra.
The next step is to start 'cpan'. This is the command line tool from Perl which automates installation
of Perl modules and software. In this case it will automatically install Deliantra and all the Perl modules it
requires.
root@localhost: ~# cpan
Note: If this is the first time you start cpan you will be asked to configure it.
Next box will show what you will see if this is the case. If you don't see this and just see a 'cpan>' prompt,
just skip the next box.
root@localhost: ~# cpan
CPAN: File::HomeDir loaded ok
/usr/local/share/perl/5.8.8/CPAN/Config.pm initialized.
CPAN is the world-wide archive of Perl resources. It consists of about
100 sites that all replicate the same contents all around the globe.
Many countries have at least one CPAN site already. The resources
found on CPAN are easily accessible with the CPAN.pm module. If you
want to use CPAN.pm, you have to configure it properly.
If you do not want to enter a dialog now, you can answer 'no' to this
question and I'll try to autoconfigure. (Note: you can revisit this
dialog anytime later by typing 'o conf init' at the cpan prompt.)
Are you ready for manual configuration? [yes]
Read all the instructions and answer the questions asked by cpan.
Most of the time you can just press enter, as the default is suitable
most of the time.
After you configured cpan, you should see a prompt like this:
root@localhost: ~# cpan
CPAN: File::HomeDir loaded ok
[skipped the configuration output from above]
cpan shell -- CPAN exploration and modules installation (v1.87)
cpan>
Now enter 'install DC::DB':
cpan> install DC::DB
Now cpan is going to download the deliantra client (in the
Deliantra::Client distribution). The download might take a while as the
package has an approximate size of 15MB. After it has downloaded and
unpacked the client you might be asked stuff like this:
Writing Makefile for Deliantra::Client
CPAN: YAML loaded ok
---- Unsatisfied dependencies detected during [M/ML/MLEHMANN/Deliantra-Client-0.1.tar.gz] -----
Deliantra
Shall I follow them and prepend them to the queue
of modules we are processing right now? [yes]
Just press enter on all questions that are similar to this, as cpan is asking you if you
want to install the required modules for Deliantra-Client, and you want to have a working installation
of the deliantra client, don't you? :-)
After everything is installed and you are back to the cpan prompt, enter 'quit'
and start deliantra:
cpan> quit
Lockfile removed.
root@localhost: ~# deliantra
deliantra should start now and for further instructions and informations look at the Help! button on the top.
Manual (CVS) Installation on Debian GNU/Linux (also with notes for ubuntu)
Even though there are binaries available for GNU/Linux you can try to compile the client
yourself:
Requirements:
- At least OpenGL 1.1 (required), better would be OpenGL 1.2 (recommended) and best is OpenGL 2.0 (even more recommended)
- Accelerated OpenGL is strongly recommended, but it should also run without.
(Actually, the client runs with good performance even on TNT2 cards, but software rendering is rather sluggish).
- libpango1.0-0 and libpango1.0-dev (generally pango-1.12.3 and above with a freetype2 or cairo backend)
- libglib2.0-0 and libglib2.0-dev (generally glib-2.10 and above)
- libsdl1.2-dev (generally something around libsdl-1.2.10)
- libsdl-mixer1.2-dev
- libsdl-image1.2-dev
- libberkeleydb-perl
- Perl modules:
- Pod::POM
- Compress::LZF
- BDB (must be linked against version 4.3 or higher of libdb)
- Event
- AnyEvent (in ubuntu avaible as anyevent-perl package)
- JSON::XS
- Time::HiRes
- LWP
- Deliantra
I assume you installed all required modules and libraries from above.
We checkout Deliantra CVS (the client code),
build it, install it and start it.
Note: ubuntu users should try following apt-get line instead and continue with the debian part:
# apt-get install perl libpango1.0-dev libglib2.0-dev libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libberkeleydb-perl anyevent-perl
For Debian use this:
# apt-get install perl libpango1.0-dev libglib2.0-dev libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libberkeleydb-perl
# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d Deliantra deliantra/Deliantra
# cd Deliantra
Deliantra/# perl Makefile.PL && make && make install
Deliantra/# cd ..
# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d Deliantra-Client deliantra/Deliantra-Client
# cd Deliantra-Client
Deliantra-Client/# perl Makefile.PL && make && make install
Deliantra-Client/# cd ..
# deliantra
If any errors occur during 'perl Makefile.PL' or make please make sure you are meeting all the requirements
from above. If everything fails, try to contact the developers.
PLEASE don't contact us if the beta version isn't yet released! Thanks.
|