Tree [27a38a] master /
History



File Date Author Commit
data 2014-08-06 Paul Wise Paul Wise [473e52] Update links from http to https where possible.
doc 2010-11-05 ANT ANT [b22ddb] Documentation - minor updates
src 2014-08-06 Paul Wise Paul Wise [27a38a] Add better build-time flexibility in font finding
.gitignore 2014-05-28 Paul Wise Paul Wise [b055a1] Ignore some more autotools files
AUTHORS 2010-11-21 ANT ANT [a3211e] AUTHORS updated
COPYING 2014-08-06 Paul Wise Paul Wise [473e52] Update links from http to https where possible.
ChangeLog 2010-10-16 Paul Wise Paul Wise [871abb] Name the NEWS file correctly according to The G...
Makefile.am 2012-01-01 Paul Wise Paul Wise [8ff91b] Wrap the automake Makefile.am files for diff re...
NEWS 2011-12-28 ANT ANT [223fce] Import of Mokomaze 0.7.0
README 2012-01-09 ANT ANT [1b6709] Format README and --help output
README.install 2010-11-05 ANT ANT [b22ddb] Documentation - minor updates
autogen.sh 2010-10-16 Paul Wise Paul Wise [3049c3] Add an autogen.sh so people know what to do aft...
configure.ac 2014-08-06 Paul Wise Paul Wise [27a38a] Add better build-time flexibility in font finding

Read Me

                                  Mokomaze

                   Copyright (C) 2009-2012 Anton Olkhovik
                             <ant007h@gmail.com>
================================================================================

Mokomaze is an open source implementation of the classic game where you control
a steel ball by tilting a wooden labyrinth. It is written in C using SDL and
adapted for Neo Freerunner.

Benefits:
 * controlled by accelerometer
 * simulates (by vibration) feedback from ball hits against the walls
 * high performance and low resource consumption
 * simple level pack file format

Running
-------
Click on Mokomaze logo on the home screen or application menu or run it from the
terminal by typing
  $ mokomaze
Some parameters can also be passed to it:
  mokomaze [-i <type>] [-v <type>] [-c <option>] [-l <int>] [-x <int>]
  [-y <int>] [-b <int>] [-s <boolean>] [-f <mode>] [--help]
  -i, --input=<type>        input device type ('dummy', 'keyboard',
                            'joystick' or 'accelerometer')
  -v, --vibro=<type>        vibro device type ('dummy' or 'freerunner')
  -c, --calibration=<option> perform input device calibration ('auto' option)
                            or reset calibration data ('reset' option)
  -l, --level=<int>         define level from which the game will be started
  -x <int>                  set window width (0 = maximum)
  -y <int>                  set window height (0 = maximum)
  -b, --bpp=<int>           set color depth (16/32 bits/pixel, 0 = auto detect)
  -s, --scrolling=<boolean> scroll game window if the level does not fit to it
  -f, --fullscreen=<mode>   set fullscreen mode ('none', 'ingame' or 'always')
  --help                    print this help and exit

  Examples:
    mokomaze
    mokomaze -l 5
    mokomaze -i freerunner -v freerunner -x 480 -y 640 --bpp=16 -s false
    mokomaze -i keyboard -v dummy -x 0 -y 0 --bpp=0 -s true -f none
    mokomaze -c auto
    mokomaze -c reset

Playing
-------
Control the ball by tilting your Freerunner. Reach the exit, marked by Openmoko
logo, avoiding other holes.

Level pack file format
----------------------
Level pack file is written in JSON and has a simple structure. There are several
game levels in the file. Each level consists of "boxes" (walls), "holes" and
"checkpoints". Boxes are specified by 2 points:
  (x1,y1) - top left point
  (x2,y2) - bottom right point

Graphic content
---------------
Menu icons are based on the KDE icon from the Oxygen theme. The logo of Mokomaze
was created under the impression of Neverball logo. Other pictures are made by
the author of the game.

No Warranty
-----------
Mokomaze comes with ABSOLUTELY NO WARRANTY. See the COPYING file for details.