1 Koules 1.4 2 by 3 JAHUSOFT 4 5DESCRIPTION: 6 7Koules is a fast action arcade-style game for UNIX and OS/2. This 8version supports X window system, SVGAlib for Linux and OS/2. It 9works in fine (up to 900x620) resolution with cool 256 color graphics, 10multiplayer mode up to 5 players, full sound and, of course, network 11support. Koules is an original idea. First version of Koules was 12developed from scratch by Jan Hubicka in July 1995. 13 14AVAILABLE AT: 15 16WWW: 17http://www.paru.cas.cz/~hubicka/koules/English 18 19FTP: 20sunsite.unc.edu: /pub/Linux/Incoming will be placed to 21 /pub/Linux/games/video/koules 22tsx-11.mit.edu: /pub/linux/sources/usr.games 23 /pub/linux/binaries/usr.games 24ftp.x.com: /contrib/games 25 26Major changes to v1.4: 27 o Fixed crash in 51st level 28 29Tested platforms: Linux, HP-UX, OS/2, Solaris, DEC, AIX, IRIX 30Sound: Linux, FreeBSD,OS/2, sun, HP-UX, rplay, NAS 31Network: Probably All bsd sockets compatible, tested only linux 32 33README: 34 // // /// // // // ///// /// 35. // // // // // // // // // 36 . //// // // // // // //// /// 37 // // // // // // // // // 38 // // //// //// ///// ///// /// 39 * . 40 v1.4 41 by . . 42 . 43 44 // /// // // // // /////////////////////// 45 . // // // // // // // // 46 // // ///// ///// // // // /// ///// ///// 47 * /// // // // // //// // // // // // 48 // // // //// // . 49 ////////////////////////// /// // // 50 51 . . THIS PROGRAM IS FREEWARE . 52* 53 ^ . 54 . / \ * . 55 . . / \ 56 * . / \ . . 57 . * / \ 58 . / \ . 59 . / \ 60 . / \ . 61 * . / CREDITS \ * . 62 / --------- \ . * . 63 / \ 64 Sounds by Jan Hubicka . . 65 . Graphics by Jan Hubicka 66 and Kamil Toman 67 . * Programming by Jan Hubicka 68 . HP-UX sound by Lutz Vieweg 69 OS/2 version by Thomas A. K. Kjaer . 70 * Story by Kamil Toman and Jan Hubicka 71 * Script by Kamil Toman and Jan Hubicka . 72 English Spelling checked by Thomas Marsh 73 / \ . 74 . / INTRODUCTION: \ 75 / --------------- \ 76 * Koules is a fast action arcade-style game for 77 UNIX and OS/2. This version supports X window 78 system, SVGAlib for Linux and OS/2. It works in fine 79 resolution. (up to 900x620) with cool 256 color 80 graphics, multi-player mode up to 5 players, full sound 81 and, of course, network support. Koules is an original 82 idea. The first version of Koules was developed from scratch 83 / by Jan Hubicka in July 1995. \ 84 / \ 85 . / \ 86 / REQUIREMENTS: \ 87 / --------------- \ 88 It runs well on computers which can be marked as faster than a 386DX/40 89 with math coprocessor (320x200 resolution) or 486DX2/50 (640x480 resolution). 90 91 92 93 94INSTALL: 95-------- 96 97In order to install Koules 1.2 you must do the following: 98(If you encounter any problems read `Problems' and `Koules.FAQ') 99 100For X11: 101======== 102 103Edit the Iconfig for your computer and type: 104 xmkmf -a 105 make 106 make install 107 108For SVGAlib: 109============ 110 111You MUST be 'root' to install the game. 112Edit the Makefile.svgalib for your computer and type: 113 make -f Makefile.svgalib 114 make -f Makefile.svgalib install 115 116For HP-UX wo imake: 117=================== 118 119Edit the Makefile.hpux for your computer and type: 120 make -f Makefile.hpux 121 make -f Makefile.hpux install 122 123For OS/2: 124========= 125 126Who cares?! :) 127 128Widows 95*: 129============ 130 131Heavens no Koules ... 132 133*Widows 95 is a shitmark of Macro$oft 134 135USAGE: 136------ 137xkoules [-SxslMmpdh] 138 -h for help 139 -s for small display(320x250) 140 for slow machines 141 -l for large display(640x480) 142 default size 143 -E extra large display size (900x620) 144 -m for monochrome mode 145 -b for black and white mode 146 -p use private colormap 147 use only if 'Could not allocate colormap' error is reported 148 -y Synchronize with X 149 use only for debugging 150 -f Disable palette fading 151 -d Disable sound support 152 Game will run faster. 153 -x Disable X11 pointer 154 Use the game's own cursor when standard X11's cursor is blinking 155 -M DISABLE shared memory support 156 Slow down the game. Use only if shared memory support crashes. 157 158koules.svga [-slMmdh] 159 -h for help 160 -s for small display(320x200) 161 for worse machines 162 -l for large display(640x480) 163 default size 164 -M disable mouse support 165 avoid gpm/selection conflict 166 -d Disable sound support 167 Game will run faster. 168 169 170Network options(common for both versions) 171 -C<host> run koules as network client 172 -S run koules as network server 173 -P<port> select port. Default is:12345 174 Use this in case that some other program is already using this port. 175 176Server options: 177 -W run server in width mode-support for 320x200 svgalib and OS/2 clients. 178 Use this in case that server is refusing your clients. 179 -L<level> select level for server 180 -D<number> select dificulty for server: 181 0: nightmare 182 1: hard 183 2: medium(default and really, really recomended) 184 3: easy 185 4: very easy 186 -K run server in deathmatch mode 187 -E extra large display size (900x620) 188 189 MENU SYSTEM: 190 191look at this simple hypertext diagram to understand them: 192 193 /----------------+ 194START GAME (---+ +--+ | 195X PLAYER ---)--^------+ | +-------------+ 196CONTROL----/ | | | 197GAME MODE------^---------^-----------------^------------------------------+ 198DIFFICULTY-----^---------^-----------------^----------------------------+ | 199SOUND ON/OFF---^---------^-----------------^---------------------------+| | 200QUIT-----------^---------^-----------------^--------------------------+|| | 201 | | | ||| | 202+--------------+ | | ||| | 203| +--------------+ | ||| | 204+----Start game (The fun is begins) | | ||| | 205 | | ||| | 206+---------------------------------------+stip to (1) (1)||| | 207| | ||| | 208+----Select number of players (up to 5 player are possible) !!!!! | ||| | 209 | ||| | 210+-------------------------------------------------------------------+ ||| | 211| ||| | 212PLAYER 1:(CONTROL MODE)------+ ||| | 213(CONTROL OPTIONS)------------^---+ ||| | 214PLAYER 2:(CONTROL MODE)------+ | ||| | 215(CONTROL OPTIONS)------------^---+----------------------------------+ ||| | 216PLAYER 3:(CONTROL MODE)------+ | | ||| | 217(CONTROL OPTIONS)------------^---+ | ||| | 218 | | | | ||| | 219 v | \ | ||| | 220PLAYER 5:(CONTROL MODE)------+-----)---+ | ||| | 221(CONTROL OPTIONS)-----------------/ | | ||| | 222 | | ||| | 223+--------------------------------------+ | ||| | 224| | ||| | 225Possible selections: | ||| | 226KEYBOARD---------------------------------------------------------+ | ||| | 227ROTATION KEYBOARD----------------------------------------------+ | | ||| | 228MOUSE--------------------------------------------------------+ | | | ||| | 229JOYSTICK A *-----------------------------------------------+ | | | | ||| | 230JOYSTICK B *---------------------------------------------+ | | | | | ||| | 231 | | | | | | ||| | 232*)available only when JOYSTICK support enabled | | | | | | ||| | 233+--------------------------------------------------------+ | | | | | ||| | 234| | | | | | ||| | 235use second Joystick to control player. | | | | | ||| | 236use stick to rotate and button to accelerate | | | | | ||| | 237see also JOYSTICK SUPPORT,CONTROL MODE | | | | | ||| | 238+----------------------------------------------------------+ | | | | ||| | 239| | | | | ||| | 240use first Joystick to control player. | | | | ||| | 241use stick to rotate and button to accelerate | | | | ||| | 242see also JOYSTICK SUPPORT,CONTROL MODE | | | | ||| | 243+------------------------------------------------------------+ | | | ||| | 244| | | | ||| | 245use mouse to control player. | | | ||| | 246use pointer to rotate and button to accelerate | | | ||| | 247mouse must be configured in | | | ||| | 248usr/local/lib/libvga.conf read this file for more | | | ||| | 249informations. | | | ||| | 250use arrow to rotate player and button to accelerate. | | | ||| | 251mouse can be also use to control menus! | | | ||| | 252there are no CONTROL OPTIONS supported | | | ||| | 253+--------------------------------------------------------------+ | | ||| | 254| | | ||| | 255use keyboard to control player | | ||| | 2563 keys are used:ACCELERATE,ROTATE LEFT,ROTATE RIGHT | | ||| | 257note:there are no predefined settings! use CONTROL OPTIONS | | ||| | 258to set keys! | | ||| | 259see also: CONTROL OPTIONS , KEYBOARD PROBLEM | | ||| | 260+----------------------------------------------------------------+ | ||| | 261| | ||| | 262use keyboard to control player | ||| | 2634 keys are used:LEFT RIGHT UP AND DOWN | ||| | 264there are predefined settings: | ||| | 265player 1:cursor box | ||| | 266player 2:Arrows on keypad. | ||| | 267player 3: there are no predefined settings! use CONTROL OPTIONS | ||| | 268player 4: there are no predefined settings! use CONTROL OPTIONS | ||| | 269see also: CONTROL OPTIONS , KEYBOARD PROBLEM | ||| | 270+-------------------------------------------------------------------+ ||| | 271| ||| | 272(CONTROL OPTIONS)may be on of following: ||| | 273CHANGE KEYS-------------------+ ||| | 274CALIBRATE JOYSTICK A-------+ | ||| | 275CALIBRATE JOYSTICK B----+ | +---------------------------------+ ||| | 276 | +---------------------------------+ | ||| | 277+-----------------------+ | | ||| | 278select it to calibrate second joystick. | | ||| | 279if you still see same menu your joystick is broken | | ||| | 280or joystick toolkit is not initialized(see JOYSTICK SUPPORT) | | ||| | 281otherwise you will see: | | ||| | 282Move joystick to lower right corner | | ||| | 283look at your joystick: | | ||| | 284(it is usually futuristic designed black thing) | | ||| | 285there is black stick. | | ||| | 286get it and move it into lower right corner.then press | | ||| | 287red button on joystick or space key. | | ||| | 288 | | ||| | 289then you will see: | | ||| | 290 Center joystick | | ||| | 291and press either button or space | | ||| | 292 | | ||| | 293Place joystick on your desk.center the stick. | | ||| | 294and smoothly and slowly press space key. | | ||| | 295+------------------------------------------------------------+ | ||| | 296| | ||| | 297select it to calibrate first joystick. | ||| | 298if you still see same menu your joystick is broken | ||| | 299or joystick toolkit is not initialized(see JOYSTICK SUPPORT) | ||| | 300otherwise you will see: | ||| | 301Move joystick to lower right corner | ||| | 302look at your joystick: | ||| | 303(it is usually futuristic designed black thing) | ||| | 304there is black stick. | ||| | 305get it and move it into lower right corner.then press | ||| | 306red button on joystick or space key. | ||| | 307 | ||| | 308then you will see: | ||| | 309 Center joystick | ||| | 310and press either button or space | ||| | 311 | ||| | 312Place joystick on your desk.center the stick. | ||| | 313and smoothly and slowly press space key. | ||| | 314+---------------------------------------------------------------+ ||| | 315| ||| | 316define your keys: ||| | 317if you see ACCELERATION skip to b) ||| | 318if you see UP skip to a) ||| | 319a)you have selected KEYBOARD ||| | 320 press a key what you want use to move up ||| | 321 then you will see: ||| | 322 DOWN ||| | 323 press a key what you want use to move down ||| | 324 then you will see: ||| | 325 LEFT ||| | 326 press a key what you want use to move left ||| | 327 then you will see: ||| | 328 RIGHT ||| | 329 press key what you want use to move right ||| | 330 then a you will see: ||| | 331see also:KEYBOARD PROBLEMS ||| | 332b)you have selected ROTATION KEYBOARD ||| | 333 press a key what you want use to accelerate ||| | 334 then you will see: ||| | 335 ROTATE LEFT ||| | 336 press a key what you want use to rotate left ||| | 337 then you will see: ||| | 338 ROTATE RIGHT ||| | 339 press a key what you want use to rotate right ||| | 340 then you will see: ||| | 341see also:KEYBOARD PROBLEMS ||| | 342+---------------------------------------------------------------------+|| | 343| || | 344back to the reality || | 345NOT RECOMMENDED!!!! VERY DANGEROUS || | 346RISK OF THE PSYCHICAL ( PHYSICAL ? ) SHOCK || | 347+----------------------------------------------------------------------+| | 348| | | 349turns the space sound on/off | | 350+-----------------------------------------------------------------------+ | 351menu: | 352EASY----------------------------+ | 353MEDIUM------------------+ | | 354HARD-------------+ | | | 355 | | | | 356+----------------+ | | | 357| | | | 358only for professionals! | | | 359+-----------------------+ | | 360| | | 361recommended mode | | 362+-------------------------------+ | 363| | 364less fun | 365+-------------------------------------------------------------------------+ 366| 367menu: 368DEATH MATCH(doom)---------------+ 369COOPERATIVE---------+ | 370 | | 371+-------------------+ | 372| | 373default mode. | 374operates in both | 375multi-player and | 376mono-player modes | 377100 levels! | 378+-------------------------------+ 379| 380for doom maniacs -try to kill each other and stay alive! 381 382 383 384 385VERY VERY EASY, isn't it? ;) 386 387 388 ----- 389 / \ 390 | o | o | 391===========================OO==============OO============================= 392 393 PC KEYBOARD PROBLEMS 394 ---------------------- 395If you feel week go away! I have to tell you a story about stupidity of your 396keyboard controller. Once open a time ?BM (alias Little Yellow) made a stupid 397keyboard which is not able to handle more than 4 keys at a time... 398... and they lived happily ever after. 399 400 401 JOYSTICK SUPPORT 402 (linux only) 403 ------------------ 404requires joystick toolkit.in distribution is patch for joystick-0.7.1 to 405compile under newer version of kernel(1.3.x) installation: 406tar xzvf joystick-0.7.1.tar.gz 407patch -p0 < <home directory of koules sources>patch 408cd joystick-0.7.1 409cp joystick.h /usr/include/linux 410make joystick.o 411 412before you run game enter 413insmod joystick.o 414you will see: 415js_init: found <number> joysticks 416 417number must be 1 or 2!!! 418 419 SOUND SUPPORT 420 --------------- 421LINUX: koules support voxware sound driver and pcsnd pcspeaker driver. 422Other architectures: OS/2, Free BSD, HP-UX, SUN 423 424 FAQ 425 ----- 426 427Q: Sounds not running. 428A: You entered invalid path edit makefile. 429 Note on spaces and / at end of path. 430 431Q: Why this stupid game don't run on my machine? 432A: Your stupid machine is not supported. Buy another one. 433 434Q: Why game run s l o w l y ? 435A: Try 320x200 or 320x250 version. 436 437Q: Why game still run s l o w l y ? 438A: Buy sextium ;) 439 440see Koules.FAQ for more 441 442 COPYING 443 --------- 444This program is free software; you can redistribute it and/or modify 445it under the terms of the GNU General Public License as published by 446the Free Software Foundation; either version 2 of the License, or (at 447your option) any later version. 448 449This program is distributed in the hope that it will be useful, but 450WITHOUT ANY WARRANTY; without even the implied warranty of 451MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 452General Public License for more details. 453 454You should have received a copy of the GNU General Public License 455along with this program; if not, write to the Free Software 456Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 457 458 459 BUGS 460 ------ 461There is bug in my svgalib.1.2.8 and earlier: 462switch to another console, switch back and press enter it will crash your 463computer.It is not koules bug!!! Test it on svgalib/demos/keytest! 464 465Koules from the top: 466 467 . 468 --- . . O 469 / \ . . 470 | | . . .. --- 471 \ / / \ X O 472 --- | O| 473 \ O/ 474 --- --- 475 . O /O O\ 476 . . . . | | 477 . . . \ / 478 . .X. . O --- 479 . . . . 480 . . . . ... 481 . . . . 482 . . . . 483 . . . 484 H A V E 485 FUN 486 ! 487 488please send a note to my e-mail address so I know how many people play Koules. 489send any comments, problems, suggestions, donations, flames, ideas for KoulesII 490email: 491hubicka@paru.cas.cz 492 493smail: 494Jan Hubicka 495Dukelskych bojovniku 1944 496Tabor 39001 497Czech Republic 498 499