Kajongg

Kajongg - the classical Mah Jongg for four players. If you are looking for the Mah Jongg solitaire please use the application KMahjongg.

Kajongg is covered by the GNU GPL2 license - see COPYING.

NEW: The game server part now runs on servers without the need
to install KDE. It should also be possible to eliminate the
neeed of Qt4 but since Debian Stable offers Qt4 I see no
need for that.

Kajongg can be used in two different ways: Scoring a manual
game where you play as always and use Kajongg for the computation
of scores and for bookkeeping. Or you can use Kajongg to play
against any combination of other human players or computer players.

Kajongg comes with a ruleset for classical chinese as played in Germany.
You can change the ruleset at your will and also define whole new
rulesets. The rules for a game are saved in the database, so every
game could be played with different rules. Changing a ruleset
does not affect existing games.

You can always get the current source code:

svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdegames/kajongg

If you want to know more, please visit the Kajongg homepage at
http://www.kde-apps.org/content/show.php/kajongg?content=103206


If you want to send me bug reports, please either use the kajongg
menu commmand Help / Report Bug or mail me directly to the Mail
Address given in that bug reporting dialog. I will not follow links
to pages I do not trust like upload pages, shortlink services or
similar.

Changelog

please read the separate file Changelog



Requirements

Kajongg is a true KDE4 application and therefore requires the KDE4 libraries
KDE4 as well as the Qt4 libraries. However you can of course also use it
in a GNOME environment.

Kajongg needs: (debian packages)

- the KDE4 games library (libkdegames5)
- Python 2.6 or higher (python)
- QT4.5 or higher (libqt4-core, libqt4-gui, libqt4-svg, libqt4-sql, libqt4-sql-sqlite)
- the python bindings for QT4 (python-qt4, python-qt4-sql, python-sip4-dev)
- the python bindings for KDE4 (python-kde4)
- sqlite3 (libsqlite3-0)
- twisted 8.2.0 or higher (python-twisted)
- twisted needs python-zope.interface



Installing Kajongg

use the .deb package or the .rpm package. If they do
not work for you, you can download kajongg-x-y-z.tar.gz and then do:

tar xfz kajongg-x-y-z.tar.gz
cd kajongg-x-y-z
./setup.py install



Translations

The basic installation contains all languages for whom there
is a translated name in kajongg.desktop.
Here you can check if there is a translation for you:
http://l10n.kde.org/stats/gui/trunk-kde4/po/kajongg.po/

You can download wanted translations like this:
svn cat svn://anonsvn.kde.org/home/kde/trunk/l10n-kde4/XX/messages/kdegames/kajongg.po > kajongg.po
where XX is the wanted language

Then run
msgfmt -o kajongg.mo kajongg.po

Install kajongg.mo in the right directory. This could be one
of those, or somewhere else depending on your distribution:

$HOME/.kde/share/locale/XX/LC_MESSAGES/kajongg.mo
/usr/share/locale/de/LC_MESSAGES/kajongg.mo
/usr/share/locale-langpack/de/LC_MESSAGES/kajongg.mo

When unsure, you can ask the system for the directory with all translations:

kde4-config --install locale # returns /usr/share/locale on my system

If your language is missing or not fully translated, feel free
to translate it!

18 Jan 2010 Release 0.4.0
- rename from kmj to kajongg
- implement playing against the computer and against other
players over the internet
- german translation of user manual.
- much better english user manual.
- changes in the data base structure. No data base update
is provided, you need to remove your existing data base. If
that means a data loss for you, please contact the author.
- explaining scores: Also show totals for base points and doubles.
- option rules now have a translatable name.
- pressing ESC in the player selector no longer tries to start a game
- loading another game in the middle of a game now correctly updates
ScoringDialog and ScoreTable.
- fix several problems with the penalty dialog.
- make it possible to profile speed of regular expressions (see
scoringtest.py, profileIt) and speed up some of them.
- implement all missing limit games and give the scoring engine
more intelligence about the source of the last tile
- moving melds between concealed and exposed now correctly
updates the ScoringDialog

25 Jul 2009 Release 0.3.2
- only show the scoring dialog (enter hand results) if asked for. This
dialog can now be closed and reopened with CTRL-S without losing
its content. This is as a preparation for a real playing mode where
this dialog is not wanted during the game.
- player and games dialog: refine the GUI: Icons on buttons, better button
order, accept INS key
- do not require sipconfig module anymore
- remove patterns from manual
- many pylintifications
- moving tiles with keyboard ESWNX: ignore key if another modifier than Shift
is found: CTRL-N must not move to north but start a new game

21 Jul 2009 Release 0.3.1
- convert all rules to regular expressions and remove Pattern code.
The Pattern code used the unsafe eval. This matters as soon as we
support networking. Instead of using a parser like pyparse we just
do it all with regular expressions - they are faster anyway

18 Jul 2009 Release 0.3
- faster startup
- save used rules with game
- save rulesets in data base
- ruleset editor
- implement full Classical Chinese ruleset
- user manual describes rule system
- implemented penalties
- save / restore window geometry and column widths
- more consistent english texts, german translation fixes
- many bug fixes and smaller improvements

02 Mai 2009 Release 0.2
- User manual
- can now be used without the mouse
- installs foreign language translations as far as they appear in kajongg.desktop. Currently:
German, Portuguese, Brasilian Portuguese, Swedish, UK English, Estonian, Ukrainian
- improve installations scripts
- many bug fixes

21 Apr 2009 Initial public release 0.1