Building the Client
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.
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:
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.
Even though there are binaries available for GNU/Linux you can try to compile the client yourself:
Requirements:
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.