original 1.0.1 release
[xwelltris.git] / README
blob0ebd8180b09e243e0bf24414fb944df28c55a46f
2 ============================================================================
4                         XWelltris - tetris like game
6 ============================================================================
8 1. Introduction
10   XWelltris is a tetris like popular game. The idea of this game was by 
11   Pogitnov russian programmer. Imaging that you are looking into the glass 
12   from the top. You see four walls and the bottom. The flat 2d figures falling
13   down from the walls one by one. You can move these figures from one wall to
14   another or rotate the figure. If the figure leave the wall it moves on the
15   bottom while another figure is pushed. You need to form full rows and/or 
16   columns on the bottom. When you form such row it disappear and you receive
17   additional empty space on the bottom and scores :). The more rows disappear
18   at a time, the more scores you have. If you can't place the whole figure on
19   the bottom, then it stays on the wall and this wall became frozen (you can't
20   place figures on it) for a while. After n-th rows were successfuly cleared,
21   you will receive binus figure and goto to the next level - game speed will 
22   be increased. You task is to play more longer and earn more scores.
24 ============================================================================
26 2. Installation of the game
28   ./configure
29   make
30   make install
32   More detail installation process described in 'INSTALL' file in this 
33   directory.
35 ============================================================================
37 3. Playing
39   Type 'xwelltris' from the X Window for playing the game.
40   First of all you see the options screen, where you can customize you game.
41   The options are:
43      - Dutris, Tritris, Tetris, Pentris, Sixtris - game type that define a 
44        number of piece the figure is. Dutris - figures from two pieces only.
45        Tritris from three pieces. Tetris from four and so on...
47      - Mixed. Turn it on and you will play with mixed figures. For example if
48        you choose tetris type below, then you will play with figure from two,
49        three and four piece. If thhis option will be off then figures will be
50        only from four pieces. This option gives you easier game but less 
51        scores.
53      - Rotation. This option turn on inner rotation of the game board, one
54        by one on each level up. This is very funny and more harder to play.
55        And of couse if harder then more scores at a time :)
57      - Next piece. This option turn on showing of next figure that will fall 
58        down on the game board. It's allow you to know and have additional time
59        for thinking. Of couse if you turn it on you will have less scores.
62   Press 'New game' for playing, then type you name and enjoy playing.
63   'Top nine' :) key shows high scores table of current game type (dutris,...)
65   And 'Exit' will kill the game.
67 ============================================================================
69 4. Additional info
71   XWelltris stores high scores table in the file named 'welltris.scores'.
72   First of all it search global welltris.scores in /usr/share/xwelltris.
73   If this file exists and writable then xwelltris uses it. Otherwise it
74   create your own welltris.scores in ~/.xwelltris directory 
75   (in your home dir). If you want to clear scores table simple remove
76   welltris.scores file and xwelltris create it again.
78 ============================================================================
80 This game implementation is under GNU GPL2 license, so you can modify and 
81 redistribute it with the rules described in 'LICENSE' file in this dir.
85 (c) 2002 by Leonid V. Khramov aka Leo <leo@xnc.dubna.su>