PACIANA DONES
A Pacman/Sokoban inspired and Indiana Jones themed maze game

Version 0.9
By Torsten Stoeter, August 16, 2018
torsten dot stoeter at st dot ovgu dot de


CHANGES
2018-08-16  Version 0.9
    - Added fullscreen option
    - Added Karl's maps
    - Fixed a few bugs
2018-06-27  Version 0.8
    - Fixed some small bugs
    - Made mummy move slower
    - Added a few more maps
    - Added lights on option
2018-06-13  Version 0.7
    - First public release

INTRO
Welcome to Paciana Dones, a Pacman/Sokoban inspired and Indiana Jones themed
maze game, finally released after too many years of unsteady development.

STORY
In spring 1936, Professor Dones is exploring the Great Sphinx of Giza to unravel
its last remaining mysteries. On his quest for the Sphinx's nose in the mazes of
the Pyramid of Cheops, globular Paciana steps into a trap against grave robbers
and tumbles down a dim corridor. Being lost without any orientation, but only
a torch and his whip he has to find a way out.

REQUIREMENTS
Pentium II class PC with Linux, DOS, or Windows operating system.

HOW TO PLAY
Guide Paciana Dones through the mazes, collect all keys and then find the exit.
The rocks may be pushed aside to make way. Only one piece of dynamite can be
picked up at a time. Use it to light up dark maps, destroy rocks or kill the
enemies. Don't run into them or Paciana Dones will die. The scarabs move on very
predictable and may be killed using the whip or dynamite. However, the mummy
moves unpredictably but in direction of Paciana Dones. It makes scary sounds, so
stay alert. A dynamite explosion also kills the mummy, but the whip only
irritates it a little.

CONTROLS
Menu
    CURSOR  rotate pyramid / change values
    ENTER   select submenu / select value
Game
    CURSOR  move player
    CTRL    place dynamite (if available)
    ALT     whip attack
    ESC     restart level / exit to menu

MAP EDITOR
The map editor allows to create custom maps, which can be played from the editor
directly or the game itself. All maps inside the maps/ subdirectory are shown in
the menu under play maps. Make sure to read and understand the help inside the
editor to create working playable maps.

BUILD
The general requirements for building Paciana Dones are:
    Allegro 4.2 or 4.4 (http://liballeg.org/)
    DUMB 0.9.3 (http://dumb.sourceforge.net/)
Building for Linux is very easy by installing the development versions of above
libraries:
    $ sudo apt install liballegro4-dev libaldmb1
Then running make will start building:
    $ make
Building for DOS requires to setup DJGPP. The following combination of DJGPP
packages is known to work:
    bnu225b.zip csdpmi5b.zip djdev205.zip gcc473b.zip mak3791b.zip txi413br3.zip
The required libraries also need to be compiled:
    all4231.zip dumb-0.9.3.zip
When everything is setup, running make with the respective makefile will start
building:
    $ make -f makefile.dj
Building for Windows requires to setup MingW32 and compile the required
libraries. Using the following software versions is known to work:
    tdm-gcc-4.7.1-2.exe make-3.79.1-20010722.tar.gz dx70_mgw.zip
    all4231.zip dumb-0.9.3.zip
When everything is setup, running make with the respective makefile will start
building:
    $ make -f makefile.mgw

CREDITS
Code        Torsten Stoeter
Graphics    Torsten Stoeter, adapted from wikipedia.org & others
Audio       Torsten Stoeter, adapted from freesound.org, soundbible.com & others
Music       Egypt by Gammis & Arabic Chiptunes by Joe Lynch from modarchive.org
Maps        Torsten Stoeter & friends

SPECIAL THANKS TO
ORo for the huge amount of support and patience over all the years.
Allegro developers & community for this awesome library and inspiration.

DISCLAIMER
Source code and binaries are provided free of charge and without any warranty.
Use it at your own risk. You may use my code in your own projects, informing me
about where and how you use it.
