1 |
pippijn |
1.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 |
root |
1.2 |
the provided GNU/Linux binary at the <a href="client.html">client page</a>. |
8 |
pippijn |
1.1 |
</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 |
root |
1.5 |
I am assuming here that you install Deliantra as <b>root</b> user. (If you don't know what |
50 |
pippijn |
1.1 |
that means you should find out what it means.) |
51 |
|
|
</p> |
52 |
|
|
|
53 |
|
|
<p> |
54 |
root |
1.5 |
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 |
pippijn |
1.1 |
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 |
root |
1.5 |
<i>Some minor mostly uninteresting note:</i> Deliantra has been tested with recent ATI and NVIDIA graphics cards. |
62 |
pippijn |
1.1 |
</p> |
63 |
|
|
|
64 |
|
|
<p> |
65 |
root |
1.12 |
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 |
pippijn |
1.1 |
</p> |
68 |
|
|
|
69 |
|
|
<pre> |
70 |
root |
1.12 |
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 |
pippijn |
1.1 |
</pre> |
72 |
|
|
|
73 |
elmex |
1.4 |
<p><b>Note: ubuntu users should try following apt-get line instead and continue with the debian part:</b></p> |
74 |
pippijn |
1.1 |
<pre> |
75 |
root |
1.12 |
# 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 |
pippijn |
1.1 |
</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 |
root |
1.12 |
<li>libdb<version>-dev (generally versions 4.4 and up work, 4.5 and up is recommended)</li> |
87 |
pippijn |
1.1 |
</ul> |
88 |
|
|
</p> |
89 |
|
|
|
90 |
|
|
<p> |
91 |
root |
1.5 |
Please make sure that this step was successful, as all of these libraries are mandatory to build and install Deliantra. |
92 |
pippijn |
1.1 |
</p> |
93 |
|
|
|
94 |
|
|
<p> |
95 |
|
|
The next step is to start 'cpan'. This is the command line tool from Perl which automates installation |
96 |
root |
1.5 |
of Perl modules and software. In this case it will automatically install Deliantra and all the Perl modules it |
97 |
pippijn |
1.1 |
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 |
root |
1.13 |
Now enter 'install DC::DB': |
153 |
pippijn |
1.1 |
</p> |
154 |
|
|
|
155 |
|
|
<pre> |
156 |
root |
1.13 |
cpan> install DC::DB |
157 |
pippijn |
1.1 |
</pre> |
158 |
|
|
|
159 |
|
|
<p> |
160 |
root |
1.13 |
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 |
pippijn |
1.1 |
</p> |
165 |
|
|
|
166 |
|
|
<pre> |
167 |
root |
1.11 |
Writing Makefile for Deliantra::Client |
168 |
pippijn |
1.1 |
CPAN: YAML loaded ok |
169 |
root |
1.7 |
---- Unsatisfied dependencies detected during [M/ML/MLEHMANN/Deliantra-Client-0.1.tar.gz] ----- |
170 |
elmex |
1.6 |
Deliantra |
171 |
pippijn |
1.1 |
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 |
root |
1.7 |
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 |
pippijn |
1.1 |
</p> |
180 |
|
|
|
181 |
|
|
<p> |
182 |
|
|
After everything is installed and you are back to the cpan prompt, enter 'quit' |
183 |
root |
1.10 |
and start deliantra: |
184 |
pippijn |
1.1 |
</p> |
185 |
|
|
|
186 |
|
|
<pre> |
187 |
|
|
cpan> quit |
188 |
|
|
Lockfile removed. |
189 |
root |
1.10 |
root@localhost: ~# deliantra |
190 |
pippijn |
1.1 |
</pre> |
191 |
|
|
|
192 |
|
|
<p> |
193 |
root |
1.10 |
deliantra should start now and <b>for further instructions and informations look at the <i>Help!</i> button on the top</b>. |
194 |
pippijn |
1.1 |
</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 |
elmex |
1.4 |
<p> <b>Requirements:</b> </p> |
206 |
pippijn |
1.1 |
|
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 |
root |
1.8 |
<li>BDB (must be linked against version 4.3 or higher of libdb)</li> |
224 |
pippijn |
1.1 |
<li>Event</li> |
225 |
root |
1.9 |
<li>AnyEvent (in ubuntu avaible as anyevent-perl package)</li> |
226 |
pippijn |
1.1 |
<li>JSON::XS</li> |
227 |
|
|
<li>Time::HiRes</li> |
228 |
|
|
<li>LWP</li> |
229 |
root |
1.7 |
<li><a href="http://software.schmorp.de/pkg/deliantra/Deliantra.html">Deliantra</a></li> |
230 |
pippijn |
1.1 |
</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 |
root |
1.7 |
We checkout <a href="http://software.schmorp.de/pkg/deliantra/Deliantra-Client.html">Deliantra CVS (the client code)</a>, |
240 |
pippijn |
1.1 |
build it, install it and start it. |
241 |
|
|
</p> |
242 |
|
|
|
243 |
elmex |
1.4 |
<p> <b>Note: ubuntu users should try following apt-get line instead and continue with the debian part:</b> </p> |
244 |
pippijn |
1.1 |
<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 |
elmex |
1.4 |
<p> <b>For Debian use this:</b> </p> |
251 |
pippijn |
1.1 |
|
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 |
root |
1.7 |
# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d Deliantra deliantra/Deliantra |
256 |
elmex |
1.6 |
# cd Deliantra |
257 |
|
|
Deliantra/# perl Makefile.PL && make && make install |
258 |
|
|
Deliantra/# cd .. |
259 |
root |
1.7 |
# 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 |
root |
1.5 |
# deliantra |
264 |
pippijn |
1.1 |
</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 |
root |
1.2 |
from above. If everything fails, try to <a href="contact.html">contact</a> the developers. |
270 |
pippijn |
1.1 |
<b>PLEASE</b> don't contact us if the beta version isn't yet released! Thanks. |
271 |
|
|
</p> |
272 |
|
|
|
273 |
pippijn |
1.3 |
<p></p> |