Monochrome Worlds
=================

'Monochrome Worlds' is a simple puzzle game where players must two people reach
a common goal.  These two people, one of them black and the other white, live
in different worlds and must work together in order that both of them reach the
gray-colored spot, which is the only place where they can share the same space.

In order to help the other, each character can toggle some of the game's blocks
from one world to the other and back again.  This can lead to some interesting
situations where a character must remove a block from the other's world in
order to let her companion pass through.

It is a remake of a Flash-based game called 'Monochro Observer'
(http://www.tatsuya-koyama.com/software/as001_mo.html) created by Tatsuya
Koyama.  The motivation behind the remake was to be able to play the game in
environments that have no Flash players available, such as the GP2X.

This game is known to work on GNU/Linux, Mac OS X, and Microsoft Windows
platforms.


Controls
--------

The game is controlled exclusively using the keyboard or a joystick / game pad
that maps its buttons to keys.

On desktop computers use the following controls:

 * `Left` and `Right` arrows: Move the selected character left or right.
 * `Shift`: Changes the currently selected character.  The selected character
    will have its same-colored blocks visible and the others invisible.
 * `Z`: Toggles the block in front of the selected character between the two
   worlds.
 * `X`: Undo the last potentially dangerous movement, such as falling or
   toggling a block.
 * `C`: Resets the stage to its initial state.
 * `Space`: Shows or hides the stage's tip.
 * `Escape`: Pauses the game and shows the in-game menu.

For GP2X systems, the controls are:

 * `Left` and `Right` directions: Move the selected character left or right.
 * `A`: Changes the currently selected character.
 * `B`: Toggles the block in front of the selected character between the two
   worlds.
 * `X`: Undo the last movement.
 * `Select`: Shows or hides the stage's tip.
 * `Start`: Pauses the game and shows the in-game menu.


License
-------

'Monochrome Worlds' is distributed as Free Software under the terms of the GNU
General Public License (GPL) version 2.


Bug, features, enhancements
---------------------------

If you find any bug or want to propose any feature to 'Monochrome Worlds',
please add a new issue ticket to the issue tracker located at:

http://bitbucket.org/geishastudios/monochromeworlds/issues/new/

Also, if you prefer, feel free to send me an email to jfita@geishastudios.com
with a description of the bug or feature.


Credits
-------

 * Original idea, graphics, and music: Tatsuya Koyama <info@tatsuya-koyama.com>
 * C++ Code: Jordi Fita <jfita@geishastudios.com>
 * Many thanks to Yuko Kato <yukokat@gmail.com> for helping me translating the
   game.
