Freeciv
m (change 'civclient' to 'freeciv-gtk2')
Line 3: Line 3:
   
 
== How to get GGZ client support ==
 
== How to get GGZ client support ==
You will need the GGZ software on your system; it doesn't come with the Freeciv source code. Since it is rather new, it is quite possible that you have to install it from source. Go get
+
You will need the GGZ software on your system; it doesn't come with the Freeciv source code. Since it is rather new, it is quite possible that you have to install it from source. Go get
 
* libggz-0.0.14
 
* libggz-0.0.14
 
* ggz-client-libs-0.0.14
 
* ggz-client-libs-0.0.14
 
* ggz-gtk-client-0.0.14
 
* ggz-gtk-client-0.0.14
from [http://ftp.ggzgamingzone.org/ http://ftp.ggzgamingzone.org/], or any newer, compatible version. They compile fine on Debian Sarge (in the order of below).
+
from http://ftp.ggzgamingzone.org/, or any newer, compatible version. They compile fine on Debian Sarge (in the order of below).
   
 
Next, you recompile Freeciv 2.1 Beta or any newer, compatible version of the Freeciv [[More_distributions|source code]], like this:
 
Next, you recompile Freeciv 2.1 Beta or any newer, compatible version of the Freeciv [[More_distributions|source code]], like this:
  +
<tt>
 
./configure --with-ggz-client
+
<tt>./configure --with-ggz-client
 
make
 
make
 
make install
 
make install
</tt>
+
</tt>
  +
  +
   
 
'''''Note:''''' As of ''Freeciv 2.1.2'' the development version of the GGZ libraries are required. See the GGZ website for info on how to retrieve a copy of the source tree.
 
'''''Note:''''' As of ''Freeciv 2.1.2'' the development version of the GGZ libraries are required. See the GGZ website for info on how to retrieve a copy of the source tree.
Line 20: Line 22:
 
== Usage ==
 
== Usage ==
 
Now you're done. Start Freeciv as usual:
 
Now you're done. Start Freeciv as usual:
  +
<tt>
 
  +
<tt>freeciv-gtk2
civclient
 
</tt>
+
</tt>
  +
You get a button ''Connect to Gaming Zone'' on the start screen. It opens a dialog with further details.
+
(or other GUI)  You get a button ''Connect to Gaming Zone'' on the start screen. It opens a dialog with further details.
   
 
Note that the translation of the GGZ dialog within Freeciv isn't working yet, and that language support in general is weak, so you will most probably see it in English. As a workaround, you can start the GGZ with
 
Note that the translation of the GGZ dialog within Freeciv isn't working yet, and that language support in general is weak, so you will most probably see it in English. As a workaround, you can start the GGZ with
  +
<tt>
 
ggz-gtk
+
<tt>ggz-gtk
</tt>
+
</tt>
  +
  +
   
 
== GGZ server support ==
 
== GGZ server support ==
 
This is only needed if you want to run your own GGZ '''server'''. You will need more libraries; please see the docs for this.
 
This is only needed if you want to run your own GGZ '''server'''. You will need more libraries; please see the docs for this.
 
 
[[Category:Projects]]
 
[[Category:Projects]]
 
[[Category:Technical docs]]
 
[[Category:Technical docs]]

Revision as of 17:01, 25 January 2013

GGZ Gaming Zone Support

From version 2.1 on, Freeciv supports the GGZ. It is not fully tested, though. With GGZ, you can start and join Freeciv games running on Pubserver, but in a more comfortable way as with the traditional Metaserver.

How to get GGZ client support

You will need the GGZ software on your system; it doesn't come with the Freeciv source code. Since it is rather new, it is quite possible that you have to install it from source. Go get

  • libggz-0.0.14
  • ggz-client-libs-0.0.14
  • ggz-gtk-client-0.0.14

from http://ftp.ggzgamingzone.org/, or any newer, compatible version. They compile fine on Debian Sarge (in the order of below).

Next, you recompile Freeciv 2.1 Beta or any newer, compatible version of the Freeciv source code, like this:

./configure --with-ggz-client
make
make install


Note: As of Freeciv 2.1.2 the development version of the GGZ libraries are required. See the GGZ website for info on how to retrieve a copy of the source tree.

Usage

Now you're done. Start Freeciv as usual:

freeciv-gtk2

(or other GUI)  You get a button Connect to Gaming Zone on the start screen. It opens a dialog with further details.

Note that the translation of the GGZ dialog within Freeciv isn't working yet, and that language support in general is weak, so you will most probably see it in English. As a workaround, you can start the GGZ with

ggz-gtk


GGZ server support

This is only needed if you want to run your own GGZ server. You will need more libraries; please see the docs for this.