| 1 |
Building the Client |
| 2 |
|
| 3 |
<h2>Build instructions for GNU/Linux</h2> |
| 4 |
|
| 5 |
<p> |
| 6 |
Here are some instructions for the people that can't or don't want to use |
| 7 |
the provided GNU/Linux binary at the <a href="client.html">client page</a>. |
| 8 |
</p> |
| 9 |
|
| 10 |
<!-- |
| 11 |
<h3>Debian GNU/Linux packages</h3> |
| 12 |
|
| 13 |
<p> |
| 14 |
For Debian/AMD64 and Debian/i386, there are prebuilt packages. You will need to install |
| 15 |
the packages <i>in order of appearance</i>. If you then get dependency warnings, install |
| 16 |
the missing packages with apt. Basically, the following should be done: |
| 17 |
</p> |
| 18 |
|
| 19 |
<div class="tutorial"> |
| 20 |
<h4>For AMD64 users:</h4> |
| 21 |
<pre> |
| 22 |
root@localhost: ~# apt-get install libberkeleydb-perl libyaml-syck-perl libevent-perl libsdl-image1.2 libsdl-mixer1.2 |
| 23 |
root@localhost: ~# dpkg -i <a href="pkgs/libevent-perl_1.08-1_amd64.deb">libevent-perl_1.08-1_amd64.deb</a> |
| 24 |
root@localhost: ~# dpkg -i <a href="pkgs/libcompress-lzf-perl_1.71-1_amd64.deb">libcompress-lzf-perl_1.71-1_amd64.deb</a> |
| 25 |
root@localhost: ~# dpkg -i <a href="pkgs/libanyevent-perl_2.51-1_all.deb">libanyevent-perl_2.51-1_all.deb</a> |
| 26 |
root@localhost: ~# dpkg -i <a href="pkgs/libpod-pom-perl_0.17-1_all.deb">libpod-pom-perl_0.17-1_all.deb</a> |
| 27 |
root@localhost: ~# dpkg -i <a href="pkgs/libcrossfire-perl_0.96-1_all.deb">libcrossfire-perl_0.96-1_all.deb</a> |
| 28 |
root@localhost: ~# dpkg -i <a href="pkgs/libcfplus-perl_0.97-1_amd64.deb">libcfplus-perl_0.97-1_amd64.deb</a> |
| 29 |
</pre> |
| 30 |
|
| 31 |
<h4>For i386 users:</h4> |
| 32 |
<pre> |
| 33 |
root@localhost: ~# apt-get install libberkeleydb-perl libyaml-syck-perl libevent-perl libsdl-image1.2 libsdl-mixer1.2 |
| 34 |
root@localhost: ~# dpkg -i <a href="pkgs/libevent-perl_1.08-1_i386.deb">libevent-perl_1.08-1_i386.deb</a> |
| 35 |
root@localhost: ~# dpkg -i <a href="pkgs/libcompress-lzf-perl_1.71-1_i386.deb">libcompress-lzf-perl_1.71-1_i386.deb</a> |
| 36 |
root@localhost: ~# dpkg -i <a href="pkgs/libanyevent-perl_2.51-1_all.deb">libanyevent-perl_2.51-1_all.deb</a> |
| 37 |
root@localhost: ~# dpkg -i <a href="pkgs/libpod-pom-perl_0.17-1_all.deb">libpod-pom-perl_0.17-1_all.deb</a> |
| 38 |
root@localhost: ~# dpkg -i <a href="pkgs/libcrossfire-perl_0.96-1_all.deb">libcrossfire-perl_0.96-1_all.deb</a> |
| 39 |
root@localhost: ~# dpkg -i <a href="pkgs/libcfplus-perl_0.97-1_i386.deb">libcfplus-perl_0.97-1_i386.deb</a> |
| 40 |
</pre> |
| 41 |
</div> |
| 42 |
--> |
| 43 |
|
| 44 |
<h3>CPAN Installation on Debian GNU/Linux (also with notes for ubuntu)</h3> |
| 45 |
|
| 46 |
<div class="tutorial"> |
| 47 |
|
| 48 |
<p> |
| 49 |
I am assuming here that you install Deliantra as <b>root</b> user. (If you don't know what |
| 50 |
that means you should find out what it means.) |
| 51 |
</p> |
| 52 |
|
| 53 |
<p> |
| 54 |
A major <b>requirement</b> to run Deliantra is <b>OpenGL</b>. And it's <i>highly recommended</i> to have <b>accelerated</b> |
| 55 |
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. |
| 56 |
</p> |
| 57 |
<p> |
| 58 |
<i>Some minor hint:</i> manufacturers like ATI and NVIDIA are providing Linux drivers. They have mostly |
| 59 |
automatic installers. GNU/Linux distributions like Ubuntu also include such drivers sometimes. On top of that there might |
| 60 |
be free driver implementations in Xorg. |
| 61 |
<i>Some minor mostly uninteresting note:</i> Deliantra has been tested with recent ATI and NVIDIA graphics cards. |
| 62 |
</p> |
| 63 |
|
| 64 |
<p> |
| 65 |
First we are going to install the required library dependencies, which are |
| 66 |
(you can substitute libdb4.5-dev by libdb4.4-dev, libdb4.6-dev, or newer if you want): |
| 67 |
</p> |
| 68 |
|
| 69 |
<pre> |
| 70 |
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 |
| 71 |
</pre> |
| 72 |
|
| 73 |
<p><b>Note: ubuntu users should try following apt-get line instead and continue with the debian part:</b></p> |
| 74 |
<pre> |
| 75 |
# 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 |
| 76 |
</pre> |
| 77 |
|
| 78 |
<p> |
| 79 |
<b>Note:</b> If you are not on Debian please be sure to satisfy following requirements: |
| 80 |
<ul> |
| 81 |
<li>libpango1.0-0 and libpango1.0-dev (generally pango-1.12.3 and above with a freetype2 or cairo backend)</li> |
| 82 |
<li>libglib2.0-0 and libglib2.0-dev (generally glib-2.10 and above)</li> |
| 83 |
<li>libsdl1.2-dev (generally something around libsdl-1.2.10)</li> |
| 84 |
<li>libsdl-mixer1.2-dev</li> |
| 85 |
<li>libsdl-image1.2-dev</li> |
| 86 |
<li>libdb<version>-dev (generally versions 4.4 and up work, 4.5 and up is recommended)</li> |
| 87 |
</ul> |
| 88 |
</p> |
| 89 |
|
| 90 |
<p> |
| 91 |
Please make sure that this step was successful, as all of these libraries are mandatory to build and install Deliantra. |
| 92 |
</p> |
| 93 |
|
| 94 |
<p> |
| 95 |
The next step is to start 'cpan'. This is the command line tool from Perl which automates installation |
| 96 |
of Perl modules and software. In this case it will automatically install Deliantra and all the Perl modules it |
| 97 |
requires. |
| 98 |
</p> |
| 99 |
|
| 100 |
<pre> |
| 101 |
root@localhost: ~# cpan |
| 102 |
</pre> |
| 103 |
|
| 104 |
<p> |
| 105 |
<b>Note:</b> If this is the first time you start <i>cpan</i> you will be asked to configure it. |
| 106 |
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, |
| 107 |
just skip the next box. |
| 108 |
</p> |
| 109 |
|
| 110 |
<pre> |
| 111 |
root@localhost: ~# cpan |
| 112 |
CPAN: File::HomeDir loaded ok |
| 113 |
|
| 114 |
/usr/local/share/perl/5.8.8/CPAN/Config.pm initialized. |
| 115 |
|
| 116 |
|
| 117 |
CPAN is the world-wide archive of Perl resources. It consists of about |
| 118 |
100 sites that all replicate the same contents all around the globe. |
| 119 |
Many countries have at least one CPAN site already. The resources |
| 120 |
found on CPAN are easily accessible with the CPAN.pm module. If you |
| 121 |
want to use CPAN.pm, you have to configure it properly. |
| 122 |
|
| 123 |
If you do not want to enter a dialog now, you can answer 'no' to this |
| 124 |
question and I'll try to autoconfigure. (Note: you can revisit this |
| 125 |
dialog anytime later by typing 'o conf init' at the cpan prompt.) |
| 126 |
|
| 127 |
Are you ready for manual configuration? [yes] |
| 128 |
</pre> |
| 129 |
|
| 130 |
<p> |
| 131 |
Read all the instructions and answer the questions asked by cpan. |
| 132 |
Most of the time you can just press <b>enter</b>, as the default is suitable |
| 133 |
most of the time. |
| 134 |
</p> |
| 135 |
|
| 136 |
<p> |
| 137 |
After you configured cpan, you should see a prompt like this: |
| 138 |
</p> |
| 139 |
|
| 140 |
<pre> |
| 141 |
root@localhost: ~# cpan |
| 142 |
CPAN: File::HomeDir loaded ok |
| 143 |
|
| 144 |
[skipped the configuration output from above] |
| 145 |
|
| 146 |
cpan shell -- CPAN exploration and modules installation (v1.87) |
| 147 |
|
| 148 |
cpan> |
| 149 |
</pre> |
| 150 |
|
| 151 |
<p> |
| 152 |
Now enter 'install DC::DB': |
| 153 |
</p> |
| 154 |
|
| 155 |
<pre> |
| 156 |
cpan> install DC::DB |
| 157 |
</pre> |
| 158 |
|
| 159 |
<p> |
| 160 |
Now cpan is going to download the deliantra client (in the |
| 161 |
Deliantra::Client distribution). The download might take a while as the |
| 162 |
package has an approximate size of 15MB. After it has downloaded and |
| 163 |
unpacked the client you might be asked stuff like this: |
| 164 |
</p> |
| 165 |
|
| 166 |
<pre> |
| 167 |
Writing Makefile for Deliantra::Client |
| 168 |
CPAN: YAML loaded ok |
| 169 |
---- Unsatisfied dependencies detected during [M/ML/MLEHMANN/Deliantra-Client-0.1.tar.gz] ----- |
| 170 |
Deliantra |
| 171 |
Shall I follow them and prepend them to the queue |
| 172 |
of modules we are processing right now? [yes] |
| 173 |
</pre> |
| 174 |
|
| 175 |
<p> |
| 176 |
Just press enter on all questions that are similar to this, as cpan is asking you if you |
| 177 |
want to install the required modules for Deliantra-Client, and you want to have a working installation |
| 178 |
of the deliantra client, don't you? :-) |
| 179 |
</p> |
| 180 |
|
| 181 |
<p> |
| 182 |
After everything is installed and you are back to the cpan prompt, enter 'quit' |
| 183 |
and start deliantra: |
| 184 |
</p> |
| 185 |
|
| 186 |
<pre> |
| 187 |
cpan> quit |
| 188 |
Lockfile removed. |
| 189 |
root@localhost: ~# deliantra |
| 190 |
</pre> |
| 191 |
|
| 192 |
<p> |
| 193 |
deliantra should start now and <b>for further instructions and informations look at the <i>Help!</i> button on the top</b>. |
| 194 |
</p> |
| 195 |
|
| 196 |
</div> |
| 197 |
|
| 198 |
<h3>Manual (CVS) Installation on Debian GNU/Linux (also with notes for ubuntu)</h3> |
| 199 |
|
| 200 |
<p> |
| 201 |
Even though there are binaries available for GNU/Linux you can try to compile the client |
| 202 |
yourself: |
| 203 |
</p> |
| 204 |
|
| 205 |
<p> <b>Requirements:</b> </p> |
| 206 |
|
| 207 |
<ul> |
| 208 |
<li>At least OpenGL 1.1 (required), better would be OpenGL 1.2 (recommended) and best is OpenGL 2.0 (even more recommended)</li> |
| 209 |
<li>Accelerated OpenGL is <b>strongly recommended</b>, but it should also run without. |
| 210 |
(Actually, the client runs with good performance even on TNT2 cards, but software rendering is rather sluggish). |
| 211 |
</li> |
| 212 |
<li>libpango1.0-0 and libpango1.0-dev (generally pango-1.12.3 and above with a freetype2 or cairo backend)</li> |
| 213 |
<li>libglib2.0-0 and libglib2.0-dev (generally glib-2.10 and above)</li> |
| 214 |
<li>libsdl1.2-dev (generally something around libsdl-1.2.10)</li> |
| 215 |
<li>libsdl-mixer1.2-dev</li> |
| 216 |
<li>libsdl-image1.2-dev</li> |
| 217 |
<li>libberkeleydb-perl</li> |
| 218 |
<li></li> |
| 219 |
<li>Perl modules: |
| 220 |
<ul> |
| 221 |
<li>Pod::POM</li> |
| 222 |
<li>Compress::LZF</li> |
| 223 |
<li>BDB (must be linked against version 4.3 or higher of libdb)</li> |
| 224 |
<li>Event</li> |
| 225 |
<li>AnyEvent (in ubuntu avaible as anyevent-perl package)</li> |
| 226 |
<li>JSON::XS</li> |
| 227 |
<li>Time::HiRes</li> |
| 228 |
<li>LWP</li> |
| 229 |
<li><a href="http://software.schmorp.de/pkg/deliantra/Deliantra.html">Deliantra</a></li> |
| 230 |
</ul> |
| 231 |
</li> |
| 232 |
</ul> |
| 233 |
|
| 234 |
<p> |
| 235 |
I assume you installed all required modules and libraries from above. |
| 236 |
</p> |
| 237 |
|
| 238 |
<p> |
| 239 |
We checkout <a href="http://software.schmorp.de/pkg/deliantra/Deliantra-Client.html">Deliantra CVS (the client code)</a>, |
| 240 |
build it, install it and start it. |
| 241 |
</p> |
| 242 |
|
| 243 |
<p> <b>Note: ubuntu users should try following apt-get line instead and continue with the debian part:</b> </p> |
| 244 |
<div class="tutorial"> |
| 245 |
<pre> |
| 246 |
# 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 |
| 247 |
</pre> |
| 248 |
</div> |
| 249 |
|
| 250 |
<p> <b>For Debian use this:</b> </p> |
| 251 |
|
| 252 |
<div class="tutorial"> |
| 253 |
<pre> |
| 254 |
# apt-get install perl libpango1.0-dev libglib2.0-dev libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libberkeleydb-perl |
| 255 |
# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d Deliantra deliantra/Deliantra |
| 256 |
# cd Deliantra |
| 257 |
Deliantra/# perl Makefile.PL && make && make install |
| 258 |
Deliantra/# cd .. |
| 259 |
# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d Deliantra-Client deliantra/Deliantra-Client |
| 260 |
# cd Deliantra-Client |
| 261 |
Deliantra-Client/# perl Makefile.PL && make && make install |
| 262 |
Deliantra-Client/# cd .. |
| 263 |
# deliantra |
| 264 |
</pre> |
| 265 |
</div> |
| 266 |
|
| 267 |
<p> |
| 268 |
If any errors occur during 'perl Makefile.PL' or make please make sure you are meeting all the requirements |
| 269 |
from above. If everything fails, try to <a href="contact.html">contact</a> the developers. |
| 270 |
<b>PLEASE</b> don't contact us if the beta version isn't yet released! Thanks. |
| 271 |
</p> |
| 272 |
|
| 273 |
<p></p> |
