]> The &kspaceduel; Handbook Andreas Zehender
az@azweb.de
19992000 Andreas Zehender &FDLNotice; 2003-09-17 1.1 &kspaceduel; is an space arcade game. Two ships fly around the sun and try to shoot eachother. Space duel KDE game ships shooting
Introduction &kspaceduel; is an space arcade game for two players. Each player controls a ship that flies around the sun and tries to shoot at the other ship. You can play &kspaceduel; with another person, against the computer, or you can have the computer control both ships and play each other. The Game The idea of the game is simple (but addictive). You try to destroy your opponent before he destroys you. Be careful not to hit the sun. Rules of the Game Ship Movement Each player controls one ship. The ships can rotate, accelerate, shoot and lay mines. Energy Each ship has an amount of energy (refer to the game options for values). Ships need energy for rotation, acceleration, shooting and laying mines. A ship gets energy from its solar panels. The amount of energy a ship gets depends on the distance from and direction to the sun. A ship gets more energy near the sun and less energy near the border. It gets the full amount of energy if the sun shines directly on the panels and less or even no energy if the sun shines at an angle to the panel or to the side of the panel. If a ship has no energy it can't navigate or shoot. Hit points Collisions with own or other bullets or mines decrease the hit points of a ship. If two ships collide, the weaker ship is destroyed and the hit points of the stronger ship are decreased by the hit points of the weaker ship plus an amount (Crash Damage). A ship is destroyed when it flies into the sun. Bullets and Mines Bullets fly around the sun like a ship. Mines have an amount of energy to stay at the same position. When the energy is spent, the mine falls into the sun. Mines near the sun need more energy than those which are further away. Mines can be destroyed with bullets. By default a ship can have 5 bullets and 3 mines on the screen. Powerups From time to time powerups appear on the play field. There are four different powerups: Mine The maximum number of mines is increased for the player. Bullet The maximum number of bullets is increased for the player. Energy (yellow sphere) The player gets energy. Shield (blue sphere) The player gets hit points The &kspaceduel; screen &kspaceduel; Main Screen &kspaceduel; Main Screen You can see that the central part of the &kspaceduel; screen is the playing area. To the left and the right are the Red Player's and the Blue Player's stats. The top box on the player stats, represents the Hit Points of the craft. The middle box on the player stats, represents the battery power. The bottom box on the player stats, shows the number of wins. The top of the playing area is occupied by the menubar and toolbar. The bottom of the playing area is the status bar. Game Options &kspaceduel; has many, many options you can adjust to increase the enjoyment of this game. Configuration is divided into two sections: Player Keys Game Settings Keys &kspaceduel; has a default set of keys to control the game. For a list of default keys see the section entitled Default key bindings. Keys can be configured by: Selecting SettingsConfigure Shortcuts... from the menubar. This will bring up a dialog box which lets you configure all hotkeys, including the keys used for steering the space ships, for firing bullets, and for laying mines. You can see that each player (Red and Blue), have 5 keystrokes corresponding to Rotate Left, Rotate Right, Accelerate, Shot, and Mines. When you are finished configuring your keys, you should click on OK to apply your changes. If you want to restore the default keys, simply click on the Default button once. To make these changes permenant, press OK. If you want to abandon the changes you made, and return to your previously selected keys, simply click Cancel, and your changes will be lost. Game Configuration All game settings of &kspaceduel; are configurable. If you want to change the game settings, simply select SettingsConfigure &kspaceduel;... from the menubar. This will bring up a dialog box with two pages, labelled General and Game. The first page is rather simple, the second one has seven tabs across the top. Settings are collected in different configurations. You can choose from several pre-defined configurations. If you choose the Custom configuration, you can define all settings for yourself. If you have not selected Custom, you will not be able to make any changes to these options. If you have found an interesting configuration, mail it to the author of the game. It can be implemented in a future version (send the part [Game] in the file ~/.kde/share/config/kspaceduelrc). When you are finished altering the options, you should click on OK to apply your changes. If you want to restore the default, simply click on the Default button once. To make these changes permenant, press OK. If you want to abandon the changes you made, and return to your previous options, simply click Cancel, and your changes will be lost. The settings are: <guilabel>General</guilabel> Hit Points These two sliders allow you to define the hitpoints for each of the two players; you might want to decrease the hitpoints for a player to give that player a handycap. Refresh time Time between two screen refreshes in milliseconds. All other settings are independent of the refresh time. Red Player Here you can define whether the red player gets controlled by the AI, and also choose the skill level of the AI for this player. Just experiment with the different skill level to find one which fits you. Blue Player This works the same as the options for the Red Player described above. <guilabel>Game</guilabel> Game speed Controls the speed of the whole game. <guilabel>Bullet</guilabel> Shot speed The speed of bullets Energy need The amount of energy needed for one shot. Max number The maximum number of bullets a player can have on the screen. Damage The number of hit points damage done when a bullet hits a ship. Life time The maximum life time of a bullet. Reload time The time a ship needs to reload a bullet. Mine Mine fuel The amount of fuel on a mine. Energy need The amount of energy needed for laying a mine. Activate time The time a mine is inactive. Damage The number of hit points of damage done when a ship hits a mine. Max number Maximum number of mines a player can have on the screen. Reload time The time a ship needs to reload a mine. <guilabel>Ship</guilabel> Acceleration Acceleration of the ships Energy need The energy needed to accelerate a ship. Rotation speed The speed at which a ship rotates. Energy need The energy needed to rotate a ship. Crash damage The number of hit points damage done when two ships collide. <guilabel>Sun</guilabel> Sun energy The strength of the sun. The higher the value, the quicker ships will be recharged. Gravity The strength of the gravitational pull of the sun. <guilabel>Start</guilabel> Position X and Position Y The ships position at the beginning of a new round. The ships start at opposite sides of the sun. Velocity X and Velocity Y Velocity at the beginning of a new round. <guilabel>Powerups</guilabel> Appearance time Maximal time between the appearance of two powerups. Life time Maximal life time of a powerup. Energy amount Amount of energy a player gets from an energy powerup. Shield amount Amount of hit points a player gets from a shield powerup. Commands/Keyboard Shortcuts The following sections briefly describe each menubar option. The <guimenu>Game</guimenu> Menu The Game menu is used to start and pause the game. &Ctrl;N GameNew Starts a new game of &kspaceduel;. &Ctrl;N GameNew Round Starts a new round, at the current level. P GamePause Pauses and unpauses the game. &Ctrl; Q GameQuit Quits &kspaceduel; <guimenu>Settings</guimenu> Menu SettingsShow Toolbar When selected, the toolbar will be visible. When not selected, the toolbar will be hidden. SettingsShow Statusbar When selected, the status bar (the bar along the bottom of the screen which gives textual information) will be visible. When not selected, the status bar will be hidden. Settings Configure Shortcuts... Allows you to change the keyboard shortcuts for &kspaceduel;, including the keys for steering the space ship, firing bullets &etc;. Settings Configure Toolbars... Display the standard KDE Toolbar Configuration Dialog. Settings Configure &kspaceduel;... Opens a configuration dialog which lets you define many settings of the game, refer to the chapter Game Options for further information. <guimenu>Help</guimenu> Menu &help.menu.documentation; Default Key Bindings The following tables show you the default key bindings. Menu bindings Key ComboAction &Ctrl;QQuit &kspaceduel; &Ctrl;NNew Game &Ctrl;NNew Round PPause Game F1Help Contents &Shift;F1Whats This Help SpaceStart Game The Menu Key Bindings can be changed by selecting Settings Configure Key Bindings Game Play ActionRed PlayerBlue Player Rotate LeftSLeft Arrow Rotate RightFRight Arrow AccelerateEUp Arrow ShotDDown Arrow MinesAInsert To change these keys, refer to the section entitled Player Keys.... Credits and License &kspaceduel; Program copyright 1999-2000 Andreas Zehender az@azweb.de Documentation copyright 2000 Andreas Zehender az@azweb.de Documentation updated for &kde; 2.0 by Mike McBride mpmcbride7@yahoo.com &underFDL; &underGPL; Installation How to obtain &kspaceduel; &install.intro.documentation; Compilation and Installation &install.compile.documentation;