chiark / gitweb /
New upstream version 1.18
[chroma-debian.git] / help / README
diff --git a/help/README b/help/README
new file mode 100644 (file)
index 0000000..947bd21
--- /dev/null
@@ -0,0 +1,98 @@
+Chroma is an abstract puzzle game. A variety of colourful shapes are arranged
+in a series of increasingly complex patterns, forming fiendish traps that must
+be disarmed and mysterious puzzles that must be manipulated in order to give
+up their subtle secrets. Initially so straightforward that anyone can pick it
+up and begin to play, yet gradually becoming difficult enough to tax even the
+brightest of minds. Have you got what it takes to solve Chroma?
+
+Levels
+======
+There are twenty one levels, split into two sets - nine intended for beginners,
+providing a step-by-step introduction to the mechanics of Chroma's building
+blocks, and a further twelve for those in search of a real challenge. You can
+play them in any order, but you'll probably find it useful to build up
+experience on the earlier levels before tacking the later ones.
+
+Objective
+=========
+In each level, the goal is to use your two player pieces to collect all of the
+stars before leaving through the door. Other pieces such as circles, squares,
+triangles and dots serve to help or hinder you in this quest. Part of the
+challenge of Chroma is understanding exactly how these pieces interact with
+one another - you'll need to experiment until you discover how their differing
+properties can best be used to your advantage. To this end, the full range of
+pieces is introduced over the first six levels of each set.
+
+Controlling your pieces
+=======================
+There are two octagonal player pieces, of which one is active, and may be
+moved using the arrow keys. To swap control to the other player piece, press
+[SPACE] or [ENTER] - its colour will change to reflect this. Initially, many of
+the puzzles can be solved using only one of the player pieces, but as the
+levels get harder, you'll find it necessary to carefully co-ordinate the moves
+of both of them in order to achieve your objective.
+
+Undoing moves
+=============
+If you make a mistake, you can press [DELETE] to undo as many moves as you
+wish, allowing you to move in a different way or press [INSERT] to redo moves
+that have been previously undone. Once a move has been made, however, you must
+wait for its full consequences to take effect before you can move again. In the
+graphical version, holding [SHIFT] down will speed things up, whereas [CTRL]
+will slow things down, allowing you to observe the changes in more detail.
+[F] will bring the pieces to their ultimate state of rest immediately.
+
+Saving and loading positions
+============================
+Pressing [ESCAPE] will present you with a menu, from which you can save your
+position, load a previous position, or return to the level selection menu, as
+well as allowing you to revert to the last position loaded. At the start of a
+level, you can also replay the moves from a previously saved position. When
+doing so, [LEFT] reverses the replay, [UP] or [DOWN] pauses it, and [RIGHT]
+continues. Should you wish to stop the replay and start making moves again,
+return to the menu with [ESCAPE], then press [T].
+
+Changing the display
+====================
+The Display Options menu allows you to change the graphics used, as well as
+the size of the screen and the speed of the game. You can also change the keys
+used and how the mouse works, and save these changes for future use if desired.
+
+Designing your own levels
+=========================
+Selecting [E] from the title screen allows you to design your own levels. To
+start with a blank level, press [L] and then [C]. You can now press [Q] to
+enter the level editor itself. Use the arrow keys to move the cursor, and
+[PAGE-UP] and [PAGE-DOWN] to change the currently selected piece. Pressing
+[SPACE] or [ENTER] will place a piece under the cursor, and pressing [Q] will
+return you to the editing menu, from which you can save your work, test the
+level, or verify it to ensure that it contains no errors. The Level Options
+menu allows you to give your level a title, change its size and rotate it.
+
+Website
+=======
+Visit the Chroma website at http://level7.org.uk/chroma/
+
+Comments and suggestions regarding Chroma are always welcome! Email:
+
+    chroma (at) level7 (dot) org (dot) uk
+
+Include the word "chroma" in your subject to get past the spam filter.
+
+Copyright and Licence
+=====================
+Chroma is Copyright (C) 2010-2019 Amf
+
+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