pet-projects/games/microballs/README

   1 mballs: A microballs game implementation
   2 ========================================
   3
   4 1. Compiling and running
   5 ------------------------
   6
   7  To compile it just run 'make' and a binary file called 'mballs' will
   8 be created.
   9
  10  You can execute it to run the game:
  11
  12 $ ./mballs
  13
  14 2. Playing
  15 ----------
  16
  17  There are two players in the game: X and Y. By default, both players
  18 are humans, X always plays first and the board size is 8x8.
  19
  20  If you select to play against the computer, it will play with player Y.
  21
  22  Moves have this format:
  23
  24      from-to
  25
  26  where, 'from' and 'to' are pairs of row and column, for example:
  27
  28      a1-a2
  29
  30  means: move piece from row 'a' and column '1' to row 'a' and
  31 column '2'. The '-' character is mandatory.
  32
  33  Other example:
  34
  35     g3-f5
  36
  37  means: move piece from row 'g' and column '3' to row 'f' and
  38 column '5'.
  39
  40 3. Options
  41 ----------
  42
  43  mballs executable supports the following options:
  44
  45  mballs [ -h ] [ -c ] [ -e<size> ]
  46
  47  -h: The help message.
  48
  49  -c: Select to play against the computer (it'll play with player Y).
  50
  51  -e<size>: Custom board size, valid range is from 9 to 16.
  52
  53  Examples:
  54
  55  $ ./mballs -e10
  56
  57    Creates a 10x10 board to be played by two humans.
  58
  59  $ ./mballs -c
  60
  61    Creates the default board size (8x8) to be played by a human against
  62    the computer.
  63
  64  $ ./mballs -c -e16
  65
  66    Creates a 16x16 board size to be played by a human against the
  67    computer.
  68
  69 Luiz Fernando N. Capitulino
  70 <lcapitulino@gmail.com>