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