1Dies ist moon-buggy.info, hergestellt von Makeinfo Version 4.7 aus 2moon-buggy.texi. 3 4INFO-DIR-SECTION Games 5START-INFO-DIR-ENTRY 6* moon-buggy: (moon-buggy). Drive some car across the moon 7END-INFO-DIR-ENTRY 8 9 This file documents moon-buggy, a simple character graphics game. 10 11 Copyright 1999, 2000 Jochen Voss 12 13 Permission is granted to make and distribute verbatim copies of this 14manual provided the copyright notice and this permission notice are 15preserved on all copies. 16 17 Permission is granted to copy and distribute modified versions of 18this manual under the conditions for verbatim copying, provided that the 19entire resulting derived work is distributed under the terms of a 20permission notice identical to this one. 21 22 Permission is granted to copy and distribute translations of this 23manual into another language, under the above conditions for modified 24versions, except that this permission notice may be stated in a 25translation approved by the Free Software Foundation. 26 27 28File: moon-buggy.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) 29 30 Moon-buggy is a simple character graphics game, where you drive some 31kind of car across the moon's surface. Unfortunately there are 32dangerous craters there. Fortunately your car can jump over them! 33 34 This edition (last updated 27 December 2004) of the manual applies to 35version 1.0.51 of the program. 36 37* Menu: 38 39* Introduction:: Introduction 40* Moon-buggy Invocation:: Moon-buggy Invocation 41* Playing the Game:: Keyboard commands 42* Shared Score Files:: Competition via the highscore table 43* Installation:: Installation and setup 44* References:: References 45 46 47File: moon-buggy.info, Node: Introduction, Next: Moon-buggy Invocation, Prev: Top, Up: Top 48 491 Introduction 50************** 51 52Moon-buggy is a simple character graphics game, where you drive some 53kind of car across the moon's surface. Unfortunately there are 54dangerous craters there. Fortunately your car can jump over them! 55 56 Moon-Buggy comes with no warranty, to the extent permitted by law. 57You may redistribute copies of Moon-Buggy under the terms of the GNU 58General Public License. For more information about these matters, read 59the file `COPYING' of the source code distribution or press <c> at 60moon-buggy's title screen. 61 62 Please mail any suggestions and bug reports to <voss@seehuhn.de>. 63Your message should include the moon-buggy version number, as obtained 64by the command `moon-buggy -V'. 65 66 New versions of Moon-buggy may be found on the sunsite ftp server or 67on the moon-buggy download page (*note References::). 68 69 70File: moon-buggy.info, Node: Moon-buggy Invocation, Next: Playing the Game, Prev: Introduction, Up: Top 71 722 Moon-buggy Invocation 73*********************** 74 75Normal usage is to start `moon-buggy' without any options. 76Nevertheless there are some. The long options (starting with `--') are 77only supported on some system types. 78 79`-h' 80`--help' 81 shows a short usage message. 82 83`-m' 84`--mesg' 85 disable write access to your terminal by other users, so your boss 86 can't disturb your game play with the help of "write" or "finger". 87 88`-n' 89`--no-title' 90 skips the title screen. 91 92`-s' 93`--show-scores' 94 shows the current highscore list and exits. 95 96`-V' 97`--version' 98 prints the program's version to standard output and exits. 99 100 101File: moon-buggy.info, Node: Playing the Game, Next: Shared Score Files, Prev: Moon-buggy Invocation, Up: Top 102 1033 Playing the Game 104****************** 105 106The game is controlled by a couple of keys, which are described near the 107bottom of the screen. Most important are the following keys. 108 109<SPC> 110<j> 111 makes your car jump. The length of a jump is fixed and you can 112 only start a new jump while the wheels have contact to the ground. 113 114<a> 115<l> 116 fires the mining laser. The laser is used to remove stones, which 117 may block your way. 118 119<q> 120 quits the game prematurely. But you still keep your score and may 121 enter the highscore list. 122 123 Moon-buggy can handle a wide range of screen sizes. But it runs best 124if the screen has at least 80 columns. If you run it on a screen with 125significantly less columns it may look strange and could be hard to 126play. 127 128 129File: moon-buggy.info, Node: Shared Score Files, Next: Installation, Prev: Playing the Game, Up: Top 130 1314 Shared Score Files 132******************** 133 134Moon-buggy has two concepts of score files: the "global score file" is 135located somewhere in the installation directories and is shared between 136all players. The exact place in the file system can be controlled via 137`configure''s `--sharedstatedir' option. This highscore file is used 138whenever Moon-buggy has the permissions to access it. Otherwise the 139"local score file" is used. This file is located in the user's home 140directory, the file name is `.mbscore'. Thus, the local score file is 141not shared between different accounts. 142 143 As the game is much more fun, when players can compete for the 144highest scores, the global score file should be writable for the 145moon-buggy program (but not for the user's text editor). Here is a 146list of possible policies: 147 148 1. The preferred solution is to make moon-buggy a setgid program. 149 This means the following: you choose a group ID, which cannot be 150 used by ordinary users, and allow only members of this group to 151 write the score file. Many systems have a group `games' for this 152 purpose (Check your `/etc/group' file). You make this group own 153 the `moon-buggy' executable and set the file's setgid bit. This 154 bit gives moon-buggy its file groups's access permissions and so 155 the program is able to access the score file. 156 157 You can use `configure''s `--with-setgid' option (*note 158 Installation::) to properly set up access permissions for this 159 model. 160 161 2. You could make moon-buggy a setuid program but for security 162 reasons this is not recommended. The file `SECURITY' from the 163 bsd-games distribution (*note References::) has some informations 164 about this topic. 165 166 3. Another solution is to make the score file world writable. But 167 then you have to trust your players: every player may open the 168 score file with his favourite text editor and change it freely. 169 So this is not recommended, too. 170 171 4. Finally you could do nothing. Then every account uses its local 172 score file. 173 174 175File: moon-buggy.info, Node: Installation, Next: References, Prev: Shared Score Files, Up: Top 176 1775 Installation 178************** 179 180Moon-buggy requires the curses library as a prerequisite. If curses is 181not installed on your system, you may use the free ncurses package 182(*note References::). The game does not work with BSD curses, thus on 183BSD systems you will need the ncurses package. 184 185 When you unpack the moon-buggy distribution, you get one directory, 186which holds all the source files and the documentation. Generic 187installation instructions are in the file `INSTALL'. There are some 188points of interest: 189 190 * By default, the program will be installed as 191 `/usr/local/bin/moon-buggy'. You can specify an installation 192 prefix other than `/usr/local' by giving `configure' the 193 `--prefix=PATH' option. 194 195 * You can choose the score file's location via `configure''s 196 `--sharedstatedir=DIR' option. The score file then will be 197 `DIR/moonbuggy/mbscore'. On GNU/Linux systems you should use 198 199 --sharedstatedir=/var/games 200 201 to comply with the Filesystem Hierarchy Standard (*note 202 References::). 203 204 * Moon-buggy supports shared score files. For details, see *Note 205 Shared Score Files::. As explained there, you may want to make 206 moon-buggy a setgid program. This can be done with the 207 `--with-setgid' option. If you use 208 209 --with-setgid=games 210 211 then the installation process arranges everything for setgid usage. 212 213 *Caution*: this introduces potential security risks. I tried to 214 minimise these, but nevertheless be careful with this. And 215 remember: moon-buggy comes with no warranty. 216 217 * If your version of the curses library is not autodetected, you 218 have to use some of the `--with-curses-includedir', 219 `--with-curses-header', and `--with-curses-libs' options. For 220 example you should use 221 222 --with-curses-includedir=/usr/pkg/include 223 224 if your curses header files are in `/usr/pkg/include/'. You may 225 use 226 227 --with-curses-header="<mycurses.h>" 228 229 if your curses header is called `mycurses.h'. And you may use 230 231 --with-curses-libs="-L/usr/pkg/lib -lncurses" 232 233 if your curses library is called `ncurses.a' and is located in 234 `/usr/pkg/lib/'. 235 236 Example: On GNU/Linux systems you probably can use the following 237commands. For the last one you need root user permissions. 238 239 ./configure --sharedstatedir=/var/games --with-setgid=games 240 make 241 make install 242 243 244File: moon-buggy.info, Node: References, Prev: Installation, Up: Top 245 2466 References 247************ 248 249This chapter gives some references to resources mentioned in the manual. 250As the internet changes incessantly, the addresses below may be 251outdated. If you find this to happen, please report it as a bug. 252 253 The latest version of *Moon-buggy* may be found on the sunsite 254archive in the directory 255`ftp://sunsite.unc.edu/pub/linux/games/arcade/'. 256 257 I provide a *moon-buggy download page*, which is located at 258`http://seehuhn.de/comp/moon-buggy.html'. 259 260 Version 2.0 of the *Filesystem Hierarchy Standard* (FHS 2.0) may be 261found on the internet at 262`ftp://sunsite.unc.edu/pub/linux/docs/fhs/fhs-2.0.tar.gz'. 263 264 The *ncurses* package can be found on the GNU project's ftp server 265and its mirrors. The original site is 266`ftp://prep.ai.mit.edu/pub/gnu/ncurses/ncurses-4.2.tar.gz'. 267 268 Hints about *security concerns* may be found in the file `SECURITY' 269from the bsd-games package. One location where to find it is 270`ftp://sunsite.unc.edu/pub/linux/games/bsd-games-2.7.tar.gz'. 271 272 273 274Tag Table: 275Node: Top993 276Node: Introduction1711 277Node: Moon-buggy Invocation2647 278Node: Playing the Game3385 279Node: Shared Score Files4262 280Node: Installation6416 281Node: References8934 282 283End Tag Table 284