Koules 1.4 by JAHUSOFT DESCRIPTION: Koules is a fast action arcade-style game for UNIX and OS/2. This version supports X window system, SVGAlib for Linux and OS/2. It works in fine (up to 900x620) resolution with cool 256 color graphics, multiplayer mode up to 5 players, full sound and, of course, network support. Koules is an original idea. First version of Koules was developed from scratch by Jan Hubicka in July 1995. AVAILABLE AT: WWW: http://www.paru.cas.cz/~hubicka/koules/English FTP: ftp.ta.jcu.cz: /pub/linux/hubicka/koules/1.4 sunsite.unc.edu: /pub/Linux/Incoming will be placed to /pub/Linux/games/video/koules tsx-11.mit.edu: /pub/linux/sources/usr.games /pub/linux/binaries/usr.games ftp.x.com: /contrib/games Major changes to v1.4: o Better joystick support by Ludvik Tesar o 'h' for help o Fixes problems with non USS-lite(voxware) sound drivers known to work well with ultrasoud project o Fixed for svgalib-1.2.11 o Fixed some other small problems o Fixed bug in X11 and intro texts o Be more robust for old and/or incorrect rc files o Fixed security bug in SVGAlib version o Socklib complettely rewrote to sock.c to avoid copyright problems with commercial use. Sock solves some old problems with network code, but may introduce new ones. Please let me know Tested platforms: Linux, HP-UX, OS/2, Solaris, DEC, AIX, IRIX Sound: Linux, FreeBSD,OS/2, sun, HP-UX, rplay, NAS Network: Probably All bsd sockets compatible, tested only linux README: // // /// // // // ///// /// . // // // // // // // // // . //// // // // // // //// /// // // // // // // // // // // // //// //// ///// ///// /// * . v1.4 by . . . // /// // // // // /////////////////////// . // // // // // // // // // // ///// ///// // // // /// ///// ///// * /// // // // // //// // // // // // // // // //// // . ////////////////////////// /// // // . . THIS PROGRAM IS FREEWARE . * ^ . . / \ * . . . / \ * . / \ . . . * / \ . / \ . . / \ . / \ . * . / CREDITS \ * . / --------- \ . * . / \ Sounds by Jan Hubicka . . . Graphics by Jan Hubicka and Kamil Toman . * Programming by Jan Hubicka Joystick support by Ludvik Tesar . HP-UX sound by Lutz Vieweg OS/2 version by Thomas A. K. Kjaer . * Story by Kamil Toman and Jan Hubicka * Script by Kamil Toman and Jan Hubicka . English Spelling checked by Thomas Marsh SGI sound and creator effect by Rick Sayre . Sound servers by Joe Rumsey and S. M. Patel / \ . / INTRODUCTION: \ / --------------- \ * Koules is a fast action arcade-style game for UNIX and OS/2. This version supports X window system, SVGAlib for Linux and OS/2. It works in fine resolution. (up to 900x620) with cool 256 color graphics, multi-player mode up to 5 players, full sound and, of course, network support. Koules is an original idea. The first version of Koules was / developed from scratch by Jan Hubicka in July 1995. \ . / \ / REQUIREMENTS: \ / --------------- \ It runs well on computers which can be marked as faster than a 386DX/40 with math coprocessor (320x200 resolution) or 486DX2/50 (640x480 resolution). HOMEPAGE: --------- http://www.paru.cas.cz/~hubicka/koules/English/koules.html INSTALL: -------- In order to install Koules 1.4 you must do the following: (If you encounter any problems read `Problems' and `Koules.FAQ') For X11: ======== Edit the Iconfig for your computer and type: xmkmf -a make make install For SVGAlib: ============ You MUST be 'root' to install the game. Edit the Makefile.svgalib for your computer and type: make -f Makefile.svgalib make -f Makefile.svgalib install For HP-UX wo imake: =================== Edit the Makefile.hpux for your computer and type: make -f Makefile.hpux make -f Makefile.hpux install For OS/2: ========= Who cares?! :) Widows 95*: ============ Heavens no Koules ... *Widows 95 is a shitmark of Macro$oft USAGE: ------ xkoules [-SxslMmpdh] -h for help -s for small display(320x250) for slow machines -l for large display(640x480) default size -E extra large display size (900x620) -m for monochrome mode -b for black and white mode -p use private colormap use only if 'Could not allocate colormap' error is reported -y Synchronize with X use only for debugging -f Disable palette fading -d Disable sound support Game will run faster. -x Disable X11 pointer Use the game's own cursor when standard X11's cursor is blinking -M DISABLE shared memory support Slow down the game. Use only if shared memory support crashes. koules.svga [-slMmdh] -h for help -s for small display(320x200) for worse machines -l for large display(640x480) default size -M disable mouse support avoid gpm/selection conflict -d Disable sound support Game will run faster. Network options(common for both versions) -C run koules as network client -S run koules as network server -P select port. Default is:12345 Use this in case that some other program is already using this port. Server options: -W run server in width mode-support for 320x200 svgalib and OS/2 clients. Use this in case that server is refusing your clients. -L select level for server -D select dificulty for server: 0: nightmare 1: hard 2: medium(default and really, really recomended) 3: easy 4: very easy -K run server in deathmatch mode -E extra large display size (900x620) MENU SYSTEM: 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 begins) | | ||| | | | ||| | +---------------------------------------+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 button *----------------------------------------+ | | | | ||| | JOYSTICK B button *--------------------------------------+ | | | | | ||| | JOYSTICK A deflection *--------------------------------+ | | | | | | ||| | JOYSTICK B deflection *------------------------------+ | | | | | | | ||| | | | | | | | | | ||| | *)available only when JOYSTICK support enabled | | | | | | | | ||| | +----------------------------------------------------+ | | | | | | | ||| | | | | | | | | | ||| | use second Joystick to control player. | | | | | | | ||| | use deflection of stick to control | | | | | | | ||| | both direction and acceleration | | | | | | | ||| | see also JOYSTICK SUPPORT,CONTROL OPTIONS | | | | | | | ||| | +------------------------------------------------------+ | | | | | | ||| | | | | | | | | ||| | use first Joystick to control player. | | | | | | ||| | use deflection of stick to control | | | | | | ||| | both direction and acceleration | | | | | | ||| | see also JOYSTICK SUPPORT,CONTROL OPTIONS | | | | | | ||| | +--------------------------------------------------------+ | | | | | ||| | | | | | | | ||| | use second Joystick to control player. | | | | | ||| | use deflection of stick to control direction | | | | | ||| | use joystick button to accelerate | | | | | ||| | see also JOYSTICK SUPPORT,CONTROL OPTIONS | | | | | ||| | +----------------------------------------------------------+ | | | | ||| | | | | | | ||| | use first Joystick to control player. | | | | ||| | use deflection of stick to control direction | | | | ||| | use joystick 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 keyboard 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 selected 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 RECOMMENDED!!!! VERY DANGEROUS || | RISK OF THE PSYCHICAL ( PHYSICAL ? ) SHOCK || | +----------------------------------------------------------------------+| | | | | turns the space sound on/off | | +-----------------------------------------------------------------------+ | menu: | EASY----------------------------+ | MEDIUM------------------+ | | HARD-------------+ | | | | | | | +----------------+ | | | | | | | only for professionals! | | | +-----------------------+ | | | | | recommended mode | | +-------------------------------+ | | | less fun | +-------------------------------------------------------------------------+ | menu: DEATH MATCH(doom)---------------+ COOPERATIVE---------+ | | | +-------------------+ | | | default mode. | operates in both | multi-player and | mono-player modes | 100 levels! | +-------------------------------+ | for doom maniacs -try to kill each other and stay alive! VERY VERY EASY, isn't it? ;) ----- / \ | o | o | ===========================OO==============OO============================= PC KEYBOARD PROBLEMS ---------------------- If you feel weak go away! I have to tell you a story about stupidity of your keyboard controller. Once upon 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 (linux only) ------------------ Requires joystick toolkit. Koules must be compiled with joystick support (see the file "Iconfig" for X-version and "Makefile.svgalib" for svga version) Maybe, that you have newer kernel than I have, and you don't need to install joystick toolkit, you only need to add joystick support in configuration menu of kernel and then to recompile kernel and kernel modules. If not you must download joystick toolkit archive "joystick-0.8.0.tar.gz", and install it. To summarize only briefly an installation (as root): cd /usr/src tar -xzf joystick-0.8.0.tar.gz cd joystick-0.8.0 make joystick.o cp joystick.o /lib/modules/2.0.??/ echo alias char-major-15 joystick >>/etc/conf.modules shutdown -r now We are assuming that you have "/sbin/depmod -a" and "/sbin/kerneld" in your startup files. The daemon "kerneld" should load module joystick.o automatically, when needed. Use "js 0" or "js 1" for testing. If it doesn't work, load joystick module manually: insmod joystick.o and watch screen. You must see: js_init: found joysticks number must be 1 or 2!!! If daemon kerneld loaded it automatically and syslogd is running, the "js_init" message should be in log file (usually /var/log/messages). SOUND SUPPORT --------------- LINUX: koules support voxware sound driver and pcsnd pcspeaker driver. Other architectures: OS/2, Free BSD, HP-UX, SUN, SGI 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 or 320x250 version. Q: Why game still run s l o w l y ? A: Buy sextium ;) see Koules.FAQ for more COPYING --------- Copyright (C) 1995 - 1998 Jan Hubicka and Kamil Toman 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.8 and earlier: 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 ! please send a note to my e-mail address so I know how many people play Koules. send any comments, problems, suggestions, donations, flames, ideas for KoulesII email: hubicka@freesoft.cz smail: Jan Hubicka Dukelskych bojovniku 1944 Tabor 39001 Czech Republic