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