sys/man/1/games

   1 .TH GAMES 1
   2 .SH NAME
   3 4s, 5s, blabs, catclock, doom, festoon, geigerstats, glendy, juggle, life, mandel, mahjongg, memo, midi, mines, mole, packet, sokoban, sudoku \- time wasters
   4 .SH SYNOPSIS
   5 .B games/4s
   6 .br
   7 .B games/5s
   8 .br
   9 .B games/blabs
  10 [
  11 .B -i
  12 ] [
  13 .B -k
  14 .I k-floor
  15 ] [
  16 .B -n
  17 .I track-length
  18 ] [
  19 .B -w
  20 .I track-width
  21 ] [
  22 .B -x
  23 .I gravity-x
  24 ] [
  25 .B -y
  26 .I gravity-y
  27 ]
  28 .br
  29 .B games/catclock
  30 .br
  31 .B games/doom
  32 .br
  33 .B games/festoon
  34 [
  35 .B -pet
  36 ] [
  37 .I sentences
  38 [
  39 .I percent-invented-nouns
  40 ] ]
  41 .br
  42 .B games/geigerstats
  43 [
  44 .B -d
  45 .I dev
  46 ] [
  47 .B -v
  48 .I vol
  49 ]
  50 .br
  51 .B games/glendy
  52 .br
  53 .B games/juggle
  54 [
  55 .B -d
  56 .I delay
  57 ] [
  58 .B -h
  59 .I hands
  60 ] [
  61 .I start
  62 ]
  63 .I pattern
  64 .br
  65 .B games/life
  66 [
  67 .B -3
  68 ] [
  69 .B -o
  70 ] [
  71 .B -d
  72 .I delay
  73 ] [
  74 .B -r
  75 .I rules
  76 ] [
  77 .B -b
  78 ]
  79 .I startfile
  80 .br
  81 .B games/mandel
  82 .br
  83 .B games/mahjongg
  84 [
  85 .B -c
  86 ] [
  87 .B -f
  88 ] [
  89 .B -b
  90 .I background
  91 ] [
  92 .B -t
  93 .I tileset
  94 ] [
  95 .B -l
  96 .I layout
  97 ]
  98 .br
  99 .B games/memo
 100 [
 101 .B -h
 102 ]
 103 .br
 104 .B games/midi
 105 .I midifile
 106 .br
 107 .B games/mines
 108 .br
 109 .B games/mole
 110 .br
 111 .B games/packet
 112 [
 113 .B -n
 114 .I nnode
 115 ] [
 116 .B -o
 117 .I speed-offset
 118 ] [
 119 .B -d
 120 .I decay
 121 ] [
 122 .B -b
 123 .I speed-bonus
 124 ] [
 125 .B -r
 126 .I regen-rate
 127 ] [
 128 .B -t
 129 .I thick-factor
 130 ] [
 131 .B -T
 132 .I display-threshold
 133 ]
 134 .br
 135 .B games/sokoban
 136 [
 137 .I level
 138 ]
 139 .br
 140 .B games/sudoku
 141 .SH DESCRIPTION
 142 There are a few games in
 143 .BR /bin/games :
 144 .TF mahjongg
 145 .PD
 146 .TP
 147 .BR 4s , " 5s"
 148 Try to fill complete rows using 4-square or 5-square tiles.
 149 Move tiles left or right by moving the mouse.
 150 Rotate tiles with buttons 1 and 3.
 151 Drop tiles for more points with button 2 or the space bar.
 152 Keys
 153 .L a
 154 and
 155 .L j
 156 move left,
 157 .L s
 158 and
 159 .L k
 160 rotate left,
 161 .L d
 162 and
 163 .L l
 164 rotate right,
 165 .L f
 166 and
 167 .L ;
 168 move right.
 169 .LR z ,
 170 .L p
 171 and
 172 .L Esc
 173 toggle suspend/resume.
 174 .LR q ,
 175 .L Del
 176 and
 177 .L control-D
 178 quit.
 179 .TP
 180 .B doom
 181 This is a port of id Software's DOOM I and II engine.
 182 In DOOM, players assume the role of a space marine, who became
 183 popularly known as "Doomguy", fighting their way through hordes
 184 of invading demons from Hell. Game data (WAD-files) for
 185 .B doom
 186 are not part of the distribution, but free WAD-files,
 187 like the shareware version, can be obtained on the net.
 188 .TP
 189 .B festoon
 190 Generate an official-looking but utterly nonsensical bureaucratic report as
 191 .L "pic | eqn | tbl | troff -mm"
 192 input.
 193 Options
 194 .BR -p ,
 195 .B -e
 196 and
 197 .B -t
 198 add gibberish diagrams, equations and tables.
 199 .TP
 200 .B glendy
 201 Don't let the rabbit escape.
 202 .TP
 203 .B juggle
 204 Display the juggling
 205 .I pattern
 206 using the optional initial
 207 .I start
 208 pattern.
 209 The number of hands involved (default 2) can be specified with
 210 .BR -h ,
 211 and
 212 .I delay
 213 can be used to speed up or slow down the action (default is 20).
 214 Try the pattern 333333441333333 or 333353505151512333333
 215 or YWUSQOMKIGECA
 216 (see
 217 .BR http://seehuhn.de/jong/theory.html ).
 218 .TP
 219 .B life
 220 Play the game of Life, given an initial position.
 221 There is a library of interesting initial positions;
 222 the library is consulted if
 223 .I startfile
 224 cannot be found.
 225 The
 226 .B -3
 227 and
 228 .B -o
 229 options select between rules known as
 230 .IR 34-life " and " lineosc ,
 231 while
 232 .B -o
 233 allows specifying the rules explicitly as an argument.
 234 The
 235 .B -d
 236 option allows specifying the delay in milliseconds between steps, and
 237 .B -b
 238 reverses the color scheme.
 239 .TP
 240 .B mahjongg
 241 Remove all tiles
 242 from the board. Click on tiles with the same face that
 243 are not blocked by others. A blocked tile is one that is partially or
 244 fully covered on top or has neighbouring tiles to the left and right.
 245 The game finishes when either all tiles are gone or there are no
 246 more moves left. The arguments are for changing background
 247 .RB ( -b ),
 248 tile
 249 .RB ( -t )
 250 and layout
 251 .RB ( -l )
 252 images;
 253 .RB -c
 254 selects a true-color buffer image, for use with
 255 drawterm or in case selecting a tile obscures it completely;
 256 .RB -f
 257 causes mahjongg to indicate non-blocked tiles on mouse-over.
 258 The
 259 .L N
 260 key will generate a new level,
 261 .L R
 262 restarts the current one.
 263 .L Q
 264 and
 265 .L Del
 266 quit,
 267 .L H
 268 gives a hint, either trying to match the currently selected tile, or if no tile is
 269 selected finding out the first available tile.
 270 .L U
 271 and
 272 .L Bksp
 273 undo the last move,
 274 .L C
 275 tries to solve the level.
 276 .TP
 277 .B memo
 278 Remove all tiles from the board.
 279 At first, pictures of various Bell Labs employees, Lucent Technologies' logo, and Glenda will appear.
 280 Memorize the sequence, then click to hide them and begin.
 281 Use the mouse to select two tiles.
 282 If they are the same, the tiles will disappear, otherwise the tiles will flip back and you will get a chance to try again.
 283 Button 3 generates a menu allowing you to restart, switch between easy and hard modes, and exit.
 284 The
 285 .B -h
 286 option sets the game to hard mode.
 287 Once the game has been completed, a message pops up with how long it took to win.
 288 Use the button 3 menu to choose a mode, or click to play again.
 289 .TP
 290 .B sokoban
 291 Guide Glenda through a room full of walls, pebbles and holes to put
 292 the pebbles in.  Your goal is to arrange all pebbles into holes by
 293 pushing them around, but you can only push a pebble if there is no
 294 wall or another pebble blocking the way.
 295 Arrow keys move Glenda up-down-left-right.
 296 .L N
 297 and
 298 .L P
 299 keys switch between
 300 the next and previous levels,
 301 .L R
 302 restarts the current level.
 303 .L Del
 304 and
 305 .L Q
 306 quit.  Button 3 invokes a menu to restart the current level, load different level sets, and en- and disable animation of multi-step moves.
 307 Button 2 lets you change between levels.
 308 Button 1 lets you do multi-step moves and pushes,
 309 by clicking it on the destination where you want Glenda to go.
 310 Glenda will only move if it can reach the destination.
 311 For a multi-step push the pebble must be next to Glenda,
 312 the destination must be on the same row or column,
 313 and there must be a free place next to the destination
 314 where the pebble can be pushed to.
 315 Otherwise, if possible, Glenda will walk to the destination without pushing the pebble.
 316 .I Sokoban
 317 accepts a level file as its argument.
 318 .TP
 319 .B sudoku
 320 .I Sudoku
 321 is a puzzle game from Japan.  The goal of the game is to
 322 fill the numbers 1 to 9 in all squares of the 9x9 board following a
 323 few simple rules: no digit should repeat on the same row and column,
 324 and no digit should repeat in the same 3x3 boxes outlined with thicker
 325 lines.  The board is initially filled with a partial solution which
 326 can be used for inferring digits for the empty squares.  The top row
 327 of the board contains the digits 1 through 9, clicking on one of those
 328 digits selects that number for placement on the board, clicking it
 329 again will deselect that digit.  Clicking on an empty square will then
 330 affix the square with the selected digit or, if no digit is selected
 331 empty the square.
 332 .IP
 333 Button 3 presents a menu with the following options:
 334 .RS \w'\fLfireworksXX'u
 335 .TP \w'\fLOffsetXX'u
 336 .B New
 337 autogenerate a new, random board
 338 .TP
 339 .B Check
 340 mark in red any digits not placed according to the rules
 341 .TP
 342 .B Solve
 343 present the board's solution
 344 .TP
 345 .B Clear
 346 clear the board to its starting (or last loaded) state
 347 .TP
 348 .B Save
 349 save the current board to
 350 .B /tmp/sudoku-save
 351 .TP
 352 .B Load
 353 load the last saved board from
 354 .B /tmp/sudoku-save
 355 .TP
 356 .B Print
 357 print the current board and solution in a format
 358 suitable for addition in the
 359 .I sudoku
 360 library to
 361 .B /tmp/sudoku-board
 362 .TP
 363 .B Offline
 364 pretty-print the board for off-line solving to
 365 .B /tmp/sudoku-print
 366 .TP
 367 .B Exit
 368 quit the game
 369 .RE
 370 .IP
 371 Button 2 presents a list of
 372 .I sudoku
 373 boards of varying degrees of difficulty from
 374 .BR /sys/games/lib/sudoku/boards .
 375 .IP
 376 Pressing the
 377 .B Q
 378 key quits
 379 .IR sudoku .
 380 .SH FILES
 381 .TF /sys/games/lib/mahjongg/*
 382 .TP
 383 .B /sys/games/lib/[45]scores
 384 score files of
 385 .I 4s
 386 and
 387 .I 5s
 388 .TP
 389 .B /sys/games/lib/life/*
 390 interesting starting positions
 391 .TP
 392 .B /sys/games/lib/mahjongg/*
 393 image sprites, levels and backgrounds used by
 394 .I mahjongg
 395 .TP
 396 .B /lib/face/*
 397 tiles for
 398 .I memo
 399 .TP
 400 .B /sys/games/lib/sokoban/*
 401 image sprites and levels used by
 402 .I sokoban
 403 .TP
 404 .B /sys/games/lib/sudoku/*
 405 images and boards used by
 406 .I sudoku
 407 .TP
 408 .B $home/lib/doom/*
 409 .TP
 410 .B /sys/lib/doom/*
 411 .TP
 412 .B /sys/games/lib/doom/*
 413 doom WAD-files.
 414 .SH SOURCE
 415 .B /sys/src/games
 416 .SH BUGS
 417 In
 418 .I 4s
 419 and
 420 .IR 5s ,
 421 mouse warping (when the game is resumed,
 422 and when a new tile appears) does not happen when
 423 the mouse cursor is outside the game window.
 424 Those who prefer to use the keyboard without the mouse
 425 cursor blocking the view (or being warped all the time)
 426 may consider this a feature.
 427 .SH HISTORY
 428 .I Doom
 429 first appeared in 9front (May, 2011).
 430 .br
 431 .I Packet
 432 first appeared in 9front (August, 2011).