Mahjongg
========


(C) 1992 by Andreas Dehmel (dehmel@forwiss.tu-muenchen.de)


Legal:
------
This program is Freeware. You can copy it freely as long as
no part of it is changed and this ReadMe-file is included.
You may add new board layouts to the version you distribute
as long as all the ones originally provided are still
present.
Use it at your own risk; I refuse any kind of responsibility
for any kind of damage resulting from the use of this program.




What is it?
-----------
It's a Mahjongg variant for the C64, of course. I wrote it a
couple of years back towards the beginning of my studies. But
it's a lot more than just a normal Mahjongg:

1) All games have a solution! Mahjongg will never create a
   game that can't be solved. To ensure this the building may
   take some time (usually not too bad, though). You can
   let the program show you the solution, too (but only from
   a board where no tiles have yet been removed; in solution
   mode the border colour will turn to red and <space> will
   show the next two tiles to remove).

2) Unlimited undos.

3) Level codes: enter an alphanumeric key to get exactly the
   same game (as long as you use the same board, of course)
   in a new session. Also use this to play new games with
   different layouts.

4) It can handle arbitrary boards, not just the standard
   Mahjongg layout. What's more, there's an integrated editor
   included that lets you build, load and save your own boards.

In short: it's great fun. I hope to port it to a newer
architecture some day...



The Editor:
-----------

You can use this to create board layouts of your own over up
to 5 levels. Use the joystick to position your tiles, F1 to
go up one level, F3 to go down one level. Tiles will have
different colours on each level, becoming brighter towards the
top. You can only set tiles if they're fully supported by their
lower layer (one exception is the case where a tile would be
supported by 3 tiles in the lower layer, which is not implemented).
F7 toggles between ``set'' and ``delete'' mode (in ``delete'' mode
the border colour will turn dark grey).
You can only save a board if it contains an even number of
tiles. Whether the number is odd or even is displayed to
the right below the menu.
You must ``Order'' your layout before you can play it. I can't
remember whether a ``Save'' orders automatically, so you better
do it manually before saving.


Have fun,




Andreas Dehmel
