Development/Architecture/KDE4/KGGZ - Revision history

Wrohdewald: remove KGGZ description, it is not used anymore

2013-01-03T18:48:44Z

remove KGGZ description, it is not used anymore

AnneW at 16:19, 13 July 2012

2012-07-13T16:19:05Z

Neverendingo: Text replace - "" to ""

2011-06-29T20:49:41Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:38:39Z
Text replace - "<code bash>" to "<syntaxhighlight lang="bash">"

				
				
				
				
			
			← Older revision
			Revision as of 20:38, 29 June 2011
			
Line 86:
Line 86:
  * runkde4 does the following:   * runkde4 does the following:
    
− <code bash> + <syntaxhighlight lang="bash">
  #!/bin/sh   #!/bin/sh
  export PATH=$HOME/sys/kde4/bin:$PATH   export PATH=$HOME/sys/kde4/bin:$PATH
Line 103:
Line 103:
  The use of ''kde4launch'' is optional of course.   The use of ''kde4launch'' is optional of course.
    
− <code bash> + <syntaxhighlight lang="bash">
  kde4launch ggz-faketable $ggzprefix/lib/ggzd/ggzd.dots $kde4prefix/bin/ksquares   kde4launch ggz-faketable $ggzprefix/lib/ggzd/ggzd.dots $kde4prefix/bin/ksquares
  </code>   </code>
    
  [[Category:KDE4]]   [[Category:KDE4]]



Neverendingo: Text replace - "" to ""

2011-06-29T20:36:03Z
Text replace - "<code ini>" to "<syntaxhighlight lang="ini">"

				
				
				
				
			
			← Older revision
			Revision as of 20:36, 29 June 2011
			
Line 46:
Line 46:
  author, UI library/environment it runs in and where its executable is located. The two important values are which protocol it uses and which version of the protocol.   author, UI library/environment it runs in and where its executable is located. The two important values are which protocol it uses and which version of the protocol.
    
− <code ini> + <syntaxhighlight lang="ini">
  ProtocolEngine=TicTacToe   ProtocolEngine=TicTacToe
  ProtocolVersion=2   ProtocolVersion=2



Josef: new hint: how to test GGZ game clients and servers
2008-03-29T14:09:16Z
new hint: how to test GGZ game clients and servers

				
				
				
				
			
			← Older revision
			Revision as of 14:09, 29 March 2008
			
Line 74:
Line 74:
    
  ==Hints==   ==Hints==
  + 
  + === Parallel installation ===
    
  Since for developers both the installed KDE and GGZ versions might differ from the system-wide installation, there are a few issues to consider. First of all, they need to be installed into different directories. The reason is that both do not use versioned includes, and GGZ's ggz-kde-* packages are still based on KDE 3. Here's a typical development setup (a receipe, so to speak), you might want to adapt it.   Since for developers both the installed KDE and GGZ versions might differ from the system-wide installation, there are a few issues to consider. First of all, they need to be installed into different directories. The reason is that both do not use versioned includes, and GGZ's ggz-kde-* packages are still based on KDE 3. Here's a typical development setup (a receipe, so to speak), you might want to adapt it.
Line 93:
Line 95:
    
  Such a wrapper mechanism is needed in many places in GGZ, so a generic one might be introduced. Still help is needed to port ggz-kde-* to KDE 4!   Such a wrapper mechanism is needed in many places in GGZ, so a generic one might be introduced. Still help is needed to port ggz-kde-* to KDE 4!
  + 
  + === Testing GGZ games ===
  + 
  + Connecting to the main GGZ server is not required to test GGZ games,
  + as long as the right game server is installed in addition to the KDE game client!
  + Just use the ''ggz-faketable'' tool from the ggz-python package.
  + The use of ''kde4launch'' is optional of course.
  + 
  + <code bash>
  + kde4launch ggz-faketable $ggzprefix/lib/ggzd/ggzd.dots $kde4prefix/bin/ksquares
  + </code>
    
  [[Category:KDE4]]   [[Category:KDE4]]



Josef: link to status file directly, and fix Trac links
2008-03-16T13:45:58Z
link to status file directly, and fix Trac links

				
				
				
				
			
			← Older revision
			Revision as of 13:45, 16 March 2008
			
Line 5:
Line 5:
    
  ==Status==   ==Status==
  + '''Impatient?''' ''[http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/playground/ggz-kde4/README.ggz-kde4 GGZ in KDE 4 - Status file]''
    
  In the time up to the KDE 4.0 release, most of the groundwork was laid   In the time up to the KDE 4.0 release, most of the groundwork was laid
Line 20:
Line 21:
  Both will use the GGZ Reversi server. For KBattleship, a dedicated   Both will use the GGZ Reversi server. For KBattleship, a dedicated
  server named   server named
− [http://svn.ggzgamingzone.org/cgi-bin/trac.cgi/browser/trunk/python/submarine Submarine] + [http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/python/submarine Submarine]
  was written in Python and is available in GGZ SVN.   was written in Python and is available in GGZ SVN.
    
Line 32:
Line 33:
  including some Kopete widgets related to online gaming.   including some Kopete widgets related to online gaming.
  The KGGZ port, currently dubbed KGGZ-ng, has some information available   The KGGZ port, currently dubbed KGGZ-ng, has some information available
− [http://svn.ggzgamingzone.org/cgi-bin/trac.cgi/browser/trunk/playground/ggz-kde4/kggz-ng here]. You can already enjoy the work on individual widgets such as [http://us.ggzgamingzone.org/~josef/playerlist.png player list] and [http://us.ggzgamingzone.org/~josef/roomslist.png the list of available rooms]. + [http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/playground/ggz-kde4/kggz-ng here]. You can already enjoy the work on individual widgets such as [http://us.ggzgamingzone.org/~josef/playerlist.png player list] and [http://us.ggzgamingzone.org/~josef/roomslist.png the list of available rooms].
    
  [http://games.kde.org/game.php?game=kreversi http://games.kde.org/games/kreversi/icon.png]   [http://games.kde.org/game.php?game=kreversi http://games.kde.org/games/kreversi/icon.png]



Josef: more links to current kggz-ng work
2008-03-16T13:42:11Z
more links to current kggz-ng work

				
				
				
				
			
			← Older revision
			Revision as of 13:42, 16 March 2008
			
Line 1:
Line 1:
  {{Template:I18n/Language Navigation Bar|Development/Architecture/KDE4/KGGZ}}   {{Template:I18n/Language Navigation Bar|Development/Architecture/KDE4/KGGZ}}
    
− The ''GGZ Gaming Zone'' offers a complete free infrastructure for online games. It has always provided some sort of KDE integration, however starting from KDE 4.0, this integration has been available out of the box from the KDE Games Library (libkdegames). + The ''[http://www.ggzgamingzone.org/ GGZ Gaming Zone]'' offers a complete free infrastructure for online games. It has always provided some sort of KDE integration, however starting from KDE 4.0, this integration has been available out of the box from the KDE Games Library (libkdegames).
  GGZ support is widely available on a variety of distros and gains popularity with a number of game projects.   GGZ support is widely available on a variety of distros and gains popularity with a number of game projects.
    
Line 31:
Line 31:
  on their own), a port of KGGZ to KDE 4, and GGZ integration with Jabber   on their own), a port of KGGZ to KDE 4, and GGZ integration with Jabber
  including some Kopete widgets related to online gaming.   including some Kopete widgets related to online gaming.
  + The KGGZ port, currently dubbed KGGZ-ng, has some information available
  + [http://svn.ggzgamingzone.org/cgi-bin/trac.cgi/browser/trunk/playground/ggz-kde4/kggz-ng here]. You can already enjoy the work on individual widgets such as [http://us.ggzgamingzone.org/~josef/playerlist.png player list] and [http://us.ggzgamingzone.org/~josef/roomslist.png the list of available rooms].
    
  [http://games.kde.org/game.php?game=kreversi http://games.kde.org/games/kreversi/icon.png]   [http://games.kde.org/game.php?game=kreversi http://games.kde.org/games/kreversi/icon.png]



Josef: add hints about GGZ development in mixed KDE3+4 environments
2008-01-12T17:39:33Z
add hints about GGZ development in mixed KDE3+4 environments

				
				
				
				
			
			← Older revision
			Revision as of 17:39, 12 January 2008
			
Line 69:
Line 69:
  seriously interested in helping out, please bring up the ideas on the   seriously interested in helping out, please bring up the ideas on the
  kde-games-devel mailing list.   kde-games-devel mailing list.
  + 
  + ==Hints==
  + 
  + Since for developers both the installed KDE and GGZ versions might differ from the system-wide installation, there are a few issues to consider. First of all, they need to be installed into different directories. The reason is that both do not use versioned includes, and GGZ's ggz-kde-* packages are still based on KDE 3. Here's a typical development setup (a receipe, so to speak), you might want to adapt it.
  + 
  + * KDE 3, KDE 4 and GGZ installed in /usr with KDE 3 occupying /usr/include/k*
  + * KDE 4 (devel) installed into ~/sys/kde4
  + * GGZ (devel) installed into ~/sys/ggz (and ~/sys/ggz/bin should be in $PATH)
  + * Prefixes don't match, so configure kdegames with -DGGZ_FORCEREGISTRY=1
  + * in ggz.modules, for each KDE 4 entry, add 'runkde4' before each executable
  + * runkde4 does the following:
  + 
  + <code bash>
  + #!/bin/sh
  + export PATH=$HOME/sys/kde4/bin:$PATH
  + export KDEDIRS=$HOME/sys/kde4
  + export KDEHOME=$HOME/.kde4
  + exec $*
  + </code>
  + 
  + Such a wrapper mechanism is needed in many places in GGZ, so a generic one might be introduced. Still help is needed to port ggz-kde-* to KDE 4!
    
  [[Category:KDE4]]   [[Category:KDE4]]



Josef: no more /cgi-bin in that URL
2008-01-12T12:12:45Z
no more /cgi-bin in that URL

				
				
				
				
			
			← Older revision
			Revision as of 12:12, 12 January 2008
			
Line 49:
Line 49:
    
  If and only if those two match the values of the game server, this game client   If and only if those two match the values of the game server, this game client
− will be offered to players! More information about this file can be found in the ggz-config [http://svn.ggzgamingzone.org/cgi-bin/trac.cgi/browser/trunk/ggz-client-libs/ggz-config/readme.ggzconfig readme file] and in the [http://www.ggzgamingzone.org/docs/guides/gamedev/ggz-game-development-guide.pdf GGZ game development guide] (which contains a lot more information and should really be printed out if you want to develop for GGZ). + will be offered to players! More information about this file can be found in the ggz-config [http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/ggz-client-libs/ggz-config/readme.ggzconfig readme file] and in the [http://www.ggzgamingzone.org/docs/guides/gamedev/ggz-game-development-guide.pdf GGZ game development guide] (which contains a lot more information and should really be printed out if you want to develop for GGZ).
    
  ==Development==   ==Development==

@@ Line 1: / Line 1: @@
-The ''[http://www.ggzgamingzone.org/ GGZ Gaming Zone]'' offers a complete free infrastructure for online games. It has always provided some sort of KDE integration, however starting from KDE 4.0, this integration has been available out of the box from the KDE Games Library (libkdegames).
+The ''[http://www.ggzgamingzone.org/ GGZ Gaming Zone]'' offers a complete free infrastructure for online games.
-GGZ support is widely available on a variety of distros and gains popularity with a number of game projects.
-−
-==Status==
-'''Impatient?''' ''[http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/playground/ggz-kde4/README.ggz-kde4 GGZ in KDE 4 - Status file]''
-−
-In the time up to the KDE 4.0 release, most of the groundwork was laid
-which makes GGZ development based on KDE libraries possible. Three
-libraries (kggzmod, kggzgames, kggznet) have been written and some
-CMake macros were also created. See
-[http://api.kde.org/4.0-api/kdegames-apidocs/libkdegames/html/ API docs].
-−
-KDE 4.0 ships with KReversi and KBattleship which both provide a GGZ
-networking mode which gets activated when launching the games from a
-GGZ core client. KReversi running on GGZ leads to GGZ's own
-KReversi being renamed to
-[http://www.ggzgamingzone.org/gameclients/kggzreversi/ KGGZReversi],
-something that was planned for a long time.
-Both will use the GGZ Reversi server. For KBattleship, a dedicated
-server named
-[http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/python/submarine Submarine]
-was written in Python and is available in GGZ SVN.
-−
-KDE 4.1 shall add KSquares, which is compatible with GGZ's Connect the Dots
-server (patch has been applied recently). KFourInLine support is also planned. It would
-therefore supersede the KDE3-based KConnectX
-client released with GGZ 0.0.14. Also, additional games might be ported.
-In KDE 4.1, better core client integration is also planned. This might
-include embedded core clients (i.e. games can connect to GGZ servers
-on their own), a port of KGGZ to KDE 4, and GGZ integration with Jabber
-including some Kopete widgets related to online gaming.
-The KGGZ port, currently dubbed KGGZ-ng, has some information available
-[http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/playground/ggz-kde4/kggz-ng here]. You can already enjoy the work on individual widgets such as [http://us.ggzgamingzone.org/~josef/playerlist.png player list] and [http://us.ggzgamingzone.org/~josef/roomslist.png the list of available rooms].
-−
-[http://games.kde.org/game.php?game=kreversi http://games.kde.org/games/kreversi/icon.png]
-[http://games.kde.org/game.php?game=kbattleship http://games.kde.org/games/kbattleship/icon.png]
-[http://games.kde.org/game.php?game=ksquares http://games.kde.org/games/ksquares/icon.png]
-−
-==Setup==
-−
-While KDE 3-based development of GGZ games requires the ''ggzmod'' library, i.e. programming in C, KDE 4 has ''kggzmod''/''kggznet''/''kggzgames'' (collectively referred to as libkggz*) and thus the libraries and all games using it will compile without any further dependencies.
-In order to be able to play the games from an online gaming client (the so-called GGZ core clients such as KGGZ), the game client still needs to be registered with the central GGZ game modules registry. The tool ''ggz-config'', which is part of the ''ggz-client-libs'' package, is needed for this task. Most distributions ship it as part of a ''ggzcore-bin'' package or similar.
-The file ''module.dsc'' contains meta information about the game, such as its
-author, UI library/environment it runs in and where its executable is located. The two important values are which protocol it uses and which version of the protocol.
-−
-<syntaxhighlight lang="ini">
-ProtocolEngine=TicTacToe
-ProtocolVersion=2
-</syntaxhighlight>
-−
-If and only if those two match the values of the game server, this game client
-will be offered to players! More information about this file can be found in the ggz-config [http://svn.ggzgamingzone.org/trac.cgi/browser/trunk/ggz-client-libs/ggz-config/readme.ggzconfig readme file] and in the [http://www.ggzgamingzone.org/docs/guides/gamedev/ggz-game-development-guide.pdf GGZ game development guide] (which contains a lot more information and should really be printed out if you want to develop for GGZ).
-−
-==Development==
-−
-Adding GGZ support to KDE games is not hard at all. There are three libraries for different tasks: ''kggzmod'' which handles all GGZ-specific events and requests, ''kggznet'' that you can use for networking (but don't have to), and ''kggzgames'' for GUI integration with GGZ components.
-−
-In addition, ''kggzdmod'' for Qt4-based GGZ game server development is available as an experimental library.
-−
-Please consider re-using existing protocols for equal or similar games. The three places to look at are: KDE Games, GNOME Games, and the games shipped by the GGZ project in their various packages. On http://www.ggzgamingzone.org/engines/ there is a list of all known GGZ games.
-−
-For the time being, have a look at the API docs of [http://api.kde.org/4.x-api/kdegames-apidocs/libkdegames/kggzmod/html/ kggzmod],
-[http://api.kde.org/4.x-api/kdegames-apidocs/libkdegames/kggznet/html/ kggznet] and
-[http://api.kde.org/4.x-api/kdegames-apidocs/libkdegames/kggzgames/html/ kggzgames], which are all part of libkdegames.
-−
-A number of tutorials were sent to the [http://lists.kde.org/?l=kde-games-devel&m=117247904901225&w=2 kde-games-devel] list, providing additional information on top of the API docs.
-−
-If this information is not enough:
-Join #kdegames on irc.kde.org and ask if you want to help. If you're
-seriously interested in helping out, please bring up the ideas on the
-kde-games-devel mailing list.
-−
-==Hints==
-−
-=== Parallel installation ===
-−
-Since for developers both the installed KDE and GGZ versions might differ from the system-wide installation, there are a few issues to consider. First of all, they need to be installed into different directories. The reason is that both do not use versioned includes, and GGZ's ggz-kde-* packages are still based on KDE 3. Here's a typical development setup (a receipe, so to speak), you might want to adapt it.
-−
-* KDE 3, KDE 4 and GGZ installed in /usr with KDE 3 occupying /usr/include/k*
-* KDE 4 (devel) installed into ~/sys/kde4
-* GGZ (devel) installed into ~/sys/ggz (and ~/sys/ggz/bin should be in $PATH)
-* Prefixes don't match, so configure kdegames with -DGGZ_FORCEREGISTRY=1
-* in ggz.modules, for each KDE 4 entry, add 'runkde4' before each executable
-* runkde4 does the following:
-−
-<syntaxhighlight lang="bash">
-#!/bin/sh
-export PATH=$HOME/sys/kde4/bin:$PATH
-export KDEDIRS=$HOME/sys/kde4
-export KDEHOME=$HOME/.kde4
-exec $*
-</syntaxhighlight>
-−
-Such a wrapper mechanism is needed in many places in GGZ, so a generic one might be introduced. Still help is needed to port ggz-kde-* to KDE 4!
-−
-=== Testing GGZ games ===
-−
-Connecting to the main GGZ server is not required to test GGZ games,
-as long as the right game server is installed in addition to the KDE game client!
-Just use the ''ggz-faketable'' tool from the ggz-python package.
-The use of ''kde4launch'' is optional of course.
-−
-<syntaxhighlight lang="bash">
-kde4launch ggz-faketable $ggzprefix/lib/ggzd/ggzd.dots $kde4prefix/bin/ksquares
-</syntaxhighlight>
 [[Category:KDE4]]

← Older revision		Revision as of 16:19, 13 July 2012
Line 1:		Line 1:
−	~~{{Template:I18n/Language Navigation Bar\|Development/Architecture/KDE4/KGGZ}}~~	+

	The ''[http://www.ggzgamingzone.org/ GGZ Gaming Zone]'' offers a complete free infrastructure for online games. It has always provided some sort of KDE integration, however starting from KDE 4.0, this integration has been available out of the box from the KDE Games Library (libkdegames).		The ''[http://www.ggzgamingzone.org/ GGZ Gaming Zone]'' offers a complete free infrastructure for online games. It has always provided some sort of KDE integration, however starting from KDE 4.0, this integration has been available out of the box from the KDE Games Library (libkdegames).