                    ---+*+---
           -----------++*++-----------
--------------------+++***+++----------------------
           M A G I C  -+*+-  M A Z E
--------------------+++***+++----------------------
           -----------++*++-----------
                    ---+*+---
 
 Copyright by Kent "MenThal" Dahl 
 
        (1995-1996) Version  1.2
        (1999)      Version  1.22
        (2004)      Version  1.4.1
        (2008)      Version  1.4.3
        (2024)      Version  1.5.x

 This game is FREE as in both BEER and SPEECH.
      (Ruby and/or GPL licence)

 E-mail me at:
   kentda<AT>pvv<DOT>org

___________________________________________________
*** Description ***

Magic Maze is a simple and low-tech monster-bashing maze game. 

It was originally inspired by playing Gauntlet II on the Atari ST.

___________________________________________________
*** Magic Maze and a Half ***

The 1.4.x versions of Magic Maze is dubbed "Magic Maze and a Half",
and was the initial port of MM to Ruby using SDL.

Subsequent 1.5.x versions are for porting to Ruby-SDL2 and
updating Ruby version.
It does not aim to introduce major new gameplay changes,
but some upgrades and improvements will rear their heads.

Hopefully there will be a playable version by the time
of the 30 year anniversary of the development start of
the original Turbo Pascal version, which began in
November 1994. 

___________________________________________________
*** Magic Maze: Two Tunnels ***

Please forgive the poor Lord of the Rings pun.
The 1.9.x and subsequent 2.x versions of Magic Maze is
dubbed "MM: Two Tunnels" and is a more long-term plan
to change gameplay more drastically. 

This is the experimental playground I'm setting up for
myself, and is less likely to show up this side of the
Apocolypse.


___________________________________________________
*** Controls ***

* Title screen *

Space / Return - start playing
Esc / Q        - quit game
F4             - load savegame

* In-game *       

Arrow keys - movement of the little blue wizard.
Ctrl       - cast missile attack spell
Space      - cast secondary support spell
Z and X    - leaf through missile spells in book
A and S    - leaf through secondary spells in book
Esc / Q    - exit game 
F1 / H     - help
F5         - save game / map
F9 / R     - restart level
F12        - toggle fullscreen
PageUp/Dn  - tune volume
Plus/Minus - tune speed (on numeric keypad)


___________________________________________________
*** Command-line usage ***

Start Magic Maze by executing:

  ruby mm.rb

The following command-line options are available:

--nosound	Disables sound
--level [#]	Assign a start level (1-10)
--joystick [#]  Enable joystick support.
--help          Show command line options
--volume        Set volume (1-10)
--fullscreen    Start in fullscreen mode
--scale         Scale the graphics and resolution up (1-5)
--savedir       Directory to put savegame.
--datadir       Asset data directory path.
--loadgame      Automatically load the savegame.


___________________________________________________
*** Requirements ***

* Ruby 2.5.x, 3.2.x or higher
  - http://www.ruby-lang.org/

* SDL, SDL_image, SDL_mixer (version 2.25 or higher?)
  - http://www.libsdl.org/

* Ruby-SDL 0.3.6 (or higher)
  - https://ohai.github.io/ruby-sdl2/
  - Install using rubygems:
       gem install ruby-sdl2
___________________________________________________
*** Web-site ***

Magic Maze >= 1.4.x:
- https://github.com/kentdahl/magic_maze

Magic Maze 1.2x:
- https://pvv.org/~kentda/ancient/geocities/coding/mmaze/



___________________________________________________
*** Credits ***

Idea, design & coding:  MenThal (Kent Dahl)

Graphics:               MenThal

Level design:           Daniel Dahl
                        MenThal

Game testing:           Per Ejnar Thomsen   (original)
                        Daniel Dahl         (original and Ruby port)
			Randi Roervik	    (Ruby port)

Other:
- Free font found at: http://www.squaregear.net/fonts/ 


___________________________________________________
*** License and redistribution ***

This game is FREE as in both BEER and SPEECH.

It is available and can be distributed under the terms of 
the GPL license (version 2) or alternatively the 
dual-licensing terms of Ruby itself.

See COPYING_GPL.txt for details and below cookie-cutter blurb:

    Magic Maze - a simple and low-tech monster-bashing maze game.
    Copyright (C) 2004-2008 Kent Dahl

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

For the Ruby dual-licensing alternative, see the Ruby distribution.

	http://www.ruby-lang.org/en/LICENSE.txt

For avoidance of doubt the license text in Ruby version 1.8.7 is considered
the authorative version as far as Magic Maze is concerned, in the 
off-chance that the Ruby license changes in the future.


___________________________________________________
___________________________________________________
