ANNOUNCING:Koules-action game for linux

ANNOUNCING:Koules-action game for linux

Post by Jan Hubick » Thu, 10 Aug 1995 04:00:00



                                    KOULES
                                by Jan Hubicka
svgabased funny action game for linux with sound,mouse,joystick,320x200x256,
640x480x256 support
AVAIABLE ON:
        sunsite.unc.edu:
                /pub/Linux/incoming(now)
                /pub/Linux/games/video(not yet)
        tsx-11.mit.edu:(not yet)
                /pub/linux/binaries/usr.games
                /pub/linux/sources/usr.games
        ftp.funet.fi:(not yet)
                /pub/linux/xtra/games
README:

                         //  //   ///    //  //  //    ////  ////
.                       // //   //  //  //  //  //    //    //
            .          ////    //  //  //  //  //    ////   ///
                      // //   //  //  //  //  //    //       //          .
                     //  //   ////    ////   ///// /////  ////
     *         .
                                      v1.0
        .               "The TIE FIGHTER clone for linux"     .            .
                                                                     *
                                       by
                 .

                       //  ///  // // //  //  ///////////////////////
        .             // // // // // //  // //
                  // // ///// ///// //  //  //   ///   ///// /////            .
       *          ///  // // // //  ////    // // //  //      //
                                          //  // //  ////    //        .      *
                //////////////////////////    ///   //      //

      .             .       THIS PROGRAM IS FREEWARE       .            .
*
                                        .           .
        .                              / \                        *  .
            .          .              /   \
     *         .                     /     \    .               .
                  .       *         /       \
                             .     /         \           .
             .                    /           \
       .                         /             \                            .
            *       .           /    CREDITS    \     *        .
                               /    ---------    \     .            *  .
                              Sounds by Jan Hubicka           .            .
                             Graphics by Jan Hubicka
                    *       Programing by Jan Hubicka
  .          .             Assistant:    Kamil   Toman
                          And  many  many (one)  others     *      .
                         /                             \
                        /          INTRODUCTION:        \
                       /          ---------------        \
    .       *  .      Koules are one of the greatest  games    .           .
                     for Linux.  This SVGA version  supports
                    high resolution(up 640x480) with cool 256
                   color  graphics  and  sounds .  Koules were
                  developed from scratch by Jan Hubicka in July
                 /                    1995.                    \
                /                                               \       .
               /                  REQUIREMENTS:                  \
    .         /                ---------------                    \
             A 386DX+ running Linux(You could try it on a 386SX, but
            be aware... It  will  flicker ). A Coprocessor  welcomed.
           A   graphics   card   which   works   with   the   SVGALIB.    .
          /                     A nice keyboard...                    \
         /                                                             \
        /                           INSTALL:                            \
       /                           ----------                            \
      You  must  be  'root'  to  install  the  game. Edit  the  Makefile as
     appropriate  for  your  system.  On a 486DX2+ with a fast graphics card
    select 640x480 version. On  slower  machines select  320x200 version. And
   simply  run 'make  dep; make' to  compile game. Then  run 'make install' to
  install  game. The game  consists  of  the  executable file 'koules' which is
 placed in   /usr/games  during  installation  and   sound   files   placed   in
/usr/games/lib/koules.  This  can  be  changed  by  editing SOUNDDIR in Makefile

                                   USAGE:
                                  --------
                            koules [NO ARGUMENTS]

                                   MENUS:

look at this simple hypertext diagram to understand them:

            /----------------+
START GAME (---+      +--+   |
X PLAYER ---)--^------+  |   +-------------+
CONTROL----/   |         |                 |
GAME MODE------^---------^-----------------^------------------------------+
DIFFICULTY-----^---------^-----------------^----------------------------+ |
SOUND ON/OFF---^---------^-----------------^---------------------------+| |
QUIT-----------^---------^-----------------^--------------------------+|| |
               |         |                 |                          ||| |
+--------------+         |                 |                          ||| |
|                        +--------------+  |                          ||| |
+----Start game (The fun is beggins)    |  |                          ||| |
                                        |  |                          ||| |
+---------------------------------------+stip to (1)               (1)||| |
|                                                                   | ||| |
+----Select number of players (up to 5 player are possible) !!!!!   | ||| |
                                                                    | ||| |
+-------------------------------------------------------------------+ ||| |
|                                                                     ||| |
PLAYER 1:(CONTROL MODE)------+                                        ||| |
(CONTROL OPTIONS)------------^---+                                    ||| |
PLAYER 2:(CONTROL MODE)------+   |                                    ||| |
(CONTROL OPTIONS)------------^---+----------------------------------+ ||| |
PLAYER 3:(CONTROL MODE)------+   |                                  | ||| |
(CONTROL OPTIONS)------------^---+                                  | ||| |
   |                         |   |                                  | ||| |
   v                         |    \                                 | ||| |
PLAYER 5:(CONTROL MODE)------+-----)---+                            | ||| |
(CONTROL OPTIONS)-----------------/    |                            | ||| |
                                       |                            | ||| |
+--------------------------------------+                            | ||| |
|                                                                   | ||| |
Possible selections:                                                | ||| |
KEYBOARD---------------------------------------------------------+  | ||| |
ROTATION KEYBOARD----------------------------------------------+ |  | ||| |
MOUSE--------------------------------------------------------+ | |  | ||| |
JOYSTICK A *-----------------------------------------------+ | | |  | ||| |
JOYSTICK B *---------------------------------------------+ | | | |  | ||| |
                                                         | | | | |  | ||| |
*)available only when JOYSTICK support enabled           | | | | |  | ||| |
+--------------------------------------------------------+ | | | |  | ||| |
|                                                          | | | |  | ||| |
use second Joystick to control player.                     | | | |  | ||| |
use stick to rotate and button to accelerate               | | | |  | ||| |
see also JOYSTICK SUPPORT,CONTROL MODE                     | | | |  | ||| |
+----------------------------------------------------------+ | | |  | ||| |
|                                                            | | |  | ||| |
use first Joystick to control player.                        | | |  | ||| |
use stick to rotate and button to accelerate                 | | |  | ||| |
see also JOYSTICK SUPPORT,CONTROL MODE                       | | |  | ||| |
+------------------------------------------------------------+ | |  | ||| |
|                                                              | |  | ||| |
use mouse to control player.                                   | |  | ||| |
use pointer to rotate and button to accelerate                 | |  | ||| |
mouse must be configured in                                    | |  | ||| |
usr/local/lib/libvga.conf read this file for more              | |  | ||| |
informations.                                                  | |  | ||| |
use arrow to rotate player and button to accelerate.           | |  | ||| |
mouse can be also use to control menus!                        | |  | ||| |
there are no CONTROL OPTIONS supported                         | |  | ||| |
+--------------------------------------------------------------+ |  | ||| |
|                                                                |  | ||| |
use keyboard to control player                                   |  | ||| |
3 keys are used:ACCELERATE,ROTATE LEFT,ROTATE RIGHT              |  | ||| |
note:there are no predefined settings! use CONTROL OPTIONS       |  | ||| |
to set keys!                                                     |  | ||| |
see also: CONTROL OPTIONS , KEYBOARD PROBLEM                     |  | ||| |
+----------------------------------------------------------------+  | ||| |
|                                                                   | ||| |
use koyboard to control player                                      | ||| |
4 keys are used:LEFT RIGHT UP AND DOWN                              | ||| |
there are predefined settings:                                      | ||| |
player 1:cursor box                                                 | ||| |
player 2:Arrows on keypad.                                          | ||| |
player 3: there are no predefined settings! use CONTROL OPTIONS     | ||| |
player 4: there are no predefined settings! use CONTROL OPTIONS     | ||| |
see also: CONTROL OPTIONS , KEYBOARD PROBLEM                        | ||| |
+-------------------------------------------------------------------+ ||| |
|                                                                     ||| |
(CONTROL OPTIONS)may be on of following:                              ||| |
CHANGE KEYS-------------------+                                       ||| |
CALIBRATE JOYSTICK A-------+  |                                       ||| |
CALIBRATE JOYSTICK B----+  |  +---------------------------------+     ||| |
                        |  +---------------------------------+  |     ||| |
+-----------------------+                                    |  |     ||| |
select it to calibrate second joystick.                      |  |     ||| |
if you still see same menu your joystick is broken           |  |     ||| |
or joystick toolkit is not initialized(see JOYSTICK SUPPORT) |  |     ||| |
otherwise you will see:                                      |  |     ||| |
Move joystick to lower right corner                          |  |     ||| |
look at your joystick:                                       |  |     ||| |
(it is usually futuristic designed black thing)              |  |     ||| |
there is black stick.                                        |  |     ||| |
get it and move it into lower right corner.then press        |  |     ||| |
red button on joystick or space key.                         |  |     ||| |
                                                             |  |     ||| |
then you will see:                                           |  |     ||| |
       Center joystick                                       |  |     ||| |
and press either button or space                             |  |     ||| |
                                                             |  |     ||| |
Place joystick on your desk.center the stick.                |  |     ||| |
and smoothly and slowly press space key.                     |  |     ||| |
+------------------------------------------------------------+  |     ||| |
|                                                               |     ||| |
select it to calibrate first joystick.                          |     ||| |
if you still see same menu your joystick is broken              |     ||| |
or joystick toolkit is not initialized(see JOYSTICK SUPPORT)    |     ||| |
otherwise you will see:                                         |     ||| |
Move joystick to lower right corner                             |     ||| |
look at your joystick:                                          |     ||| |
(it is usually futuristic designed black thing)                 |     ||| |
there is black stick.                                           |     ||| |
get it and move it into lower right corner.then press           |     ||| |
red button on joystick or space key.                            |     ||| |
                                                                |     ||| |
then you will see:                                              |     ||| |
       Center joystick                                          |     ||| |
and press either button or space                                |     ||| |
                                                                |     ||| |
Place joystick on your desk.center the stick.                   |     ||| |
and smoothly and slowly press space key.                        |     ||| |
+---------------------------------------------------------------+     ||| |
|                                                                     ||| |
define your keys:                                                     ||| |
if you see ACCELERATION skip to b)                                    ||| |
if you see UP skip to a)                                              ||| |
a)you have selected KEYBOARD                                          ||| |
  press a key what you want use to move up                            ||| |
  then you will see:                                                  ||| |
  DOWN                                                                ||| |
  press a key what you want use to move down                          ||| |
  then you will see:                                                  ||| |
  LEFT                                                                ||| |
  press a key what you want use to move left                          ||| |
  then you will see:                                                  ||| |
  RIGHT                                                               ||| |
  press key what you want use to move right                           ||| |
  then a you will see:                                                ||| |
see also:KEYBOARD PROBLEMS                                            ||| |
b)you have slected ROTATION KEYBOARD                                  ||| |
  press a key what you want use to accelerate                         ||| |
  then you will see:                                                  ||| |
  ROTATE LEFT                                                         ||| |
  press a key what you want use to rotate left                        ||| |
  then you will see:                                                  ||| |
  ROTATE RIGHT                                                        ||| |
  press a key what you want use to rotate right                       ||| |
  then you will see:                                                  ||| |
see also:KEYBOARD PROBLEMS                                            ||| |
+---------------------------------------------------------------------+|| |
|                                                                      || |
back to the reality                                                    || |
NOT RECOMENDED!!!! VERY DANGEROUS                                      || |
RISK OF THE PSYCHICAL ( PHYSICAL ? ) SHOCK                             || |
+----------------------------------------------------------------------+| |
|                                                                       | |
turns the space sound on/off                                            | |
+-----------------------------------------------------------------------+ |
menu:                                                                     |
EASY----------------------------+                                         |
MEDIUM------------------+       |                                         |
HARD-------------+      |       |                                         |
                 |      |       |                                         |
+----------------+      |       |                                         |
|                       |       |                                         |
only for professionals! |       |                                         |
+-----------------------+       |                                         |
|                               |                                         |
recomended mode                 |                                         |
+-------------------------------+                                         |
|                                                                         |
less fun                                                                  |
+-------------------------------------------------------------------------+
|
menu:
DEATH MATCH(doom)---------------+
COOPERATIVE---------+           |
                    |           |
+-------------------+           |
|                               |
default mode.                   |
operates in both                |
multiplayer and                 |
monoplayer modes                |
many levels!                    |
+-------------------------------+
|
for doom maniacs  -try to kill each other and stay alive!

VERY VERY EASY, isn't it? :)
                                 -----
                                /     \
                               | o | o |
===========================OO==============OO=============================

                            KEYBOARD PROBLEMS
                           -------------------
If you feel week go away! I have to tell you a story about stupidity of your
keyboard controller. Once open a time ?BM (alias Little Yellow) made a stupid
keyboard which is not able to handle more than 4 keys at a time...
... and they lived happily ever after.

                            JOYSTICK SUPPORT
                           ------------------
requires joystick toolkit.in distribution is patch for joystick-0.7.1 to
compile  under newer version of kernel(1.3.x) instalation:
tar xzvf joystick-0.7.1.tar.gz
patch -p0 <  <home directory of koules sources>patch
cd joystick-0.7.1
cp joystick.h /usr/include/linux
make joystick.o

before you run game enter
insmod joystick.o
you will see:
js_init: found <number> joysticks

number must be 1 or 2!!!

                             SOUND SUPPORT
                            ---------------
koules support voxware sound driver and pcsnd pcspeaker driver.

                                 FAQ
                                -----

Q:  Sounds not running.
A:  You entered invalid path edit makefile.
    Note on spaces and / at end of path.

Q:  Why this stupid game don't run on my machine?
A:  Your stupid machine is not supported. Buy another one.

Q:  Why game run s l o w l y ?
A:  Try 320x200 version(edit makefile).

Q:  Why game still run s l o w l y ?
A:  Buy sextium ;)

                               COPYING
                              ---------
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., 675 Mass Ave, Cambridge, MA 02139, USA.

                                 BUGS
                                ------
There is bug in my svgalib.1.2.6:
switch to another console, switch back and press enter it will crash your
computer.It is not koules bug!!! Test it on svgalib/demos/keytest!

Koules from the top:

                             .
                 ---       .  .                    O
                /   \        . .
               |     |    . . .. ---
                \   /           /   \        X           O
                 ---           |    O|
                                \  O/
                                 ---       ---
                .       O                 /O O\
             . . . .                     |     |
              . . .                       \   /
            .  .X.  .          O           ---
              . . .                         .
             . . . .                       ...
                .                         . . .
                                         . . . .
                                        .   .   .
                        H A V E
                          FUN
                           !

If you have any comments, problems, suggestions, donations, flames,
send them to:
email:
hubi...@limax.paru.cas.cz

smail:
Jan Hubicka
Dukelskych bojovniku 1944
Tabor 39001
Czech Republic